结论
找出「不再適合」的句子,不是把檔案變短。 Anthropic 把這套檢查寫成一份公開的 skill,Claude Code 也內建成 /doctor prompt-audit。
适用于依據 anthropics/skills 的 prompt-audit.md(Apache 2.0)與 Claude Code 更新紀錄2026-11
為什麼講這題?
- 最近換到新模型
最近換到新模型,以前寫的規則檔要不要跟著調?
- 聽到一個說法
拿掉一堆限制型的句子,AI 反而更強。上週分享的訪談裡,Claude Code 團隊也說過他們以前把模型限制得太多。
- 找到一個指令
Claude Code 有指令可以掃規則檔。方法寫在一份公開的 markdown 裡,誰都能拿去給自己的 AI 工具用。
所以今天拆開這份文件:它怎麼判斷哪句該刪、哪句不能刪。最後拿我自己寫的 skill 草稿試一次。
指令在哪裡?
| 入口 | 掃什麼 | 適合誰 |
|---|---|---|
/doctor prompt-audit(也可打 /checkup prompt-audit) | CLAUDE.md、skills、agents、commands | 用 Claude Code 的人 |
/claude-api prompt-audit | 程式裡的 system prompt、tool 描述、請求設定 | 自己寫 API 應用的人 |
直接讀 prompt-audit.md | 任何規則檔,包括 AGENTS.md | 誰都能用用其他 coding agent 的人 |
它怎麼跑?
图的结构
- 定範圍和模型
scope - 盤點文字
inventory - 查來歷
blame - 刪除規則
classify - 掃四組反模式
scan - 報告
report - 提出修改
diff - 前後驗證
verify blame→classifyclassify→scandiff→verifyinventory→blamereport→diff· 只放中高信心scan→reportscope→inventory
哪些句子會被抓出來?
| 反模式 | 舊寫法 | 新寫法 |
|---|---|---|
| 施壓語氣 | 用過頭CRITICAL: You MUST use this tool when... | Use this tool when... |
| 被功能取代的鷹架 | 「think step by step」、要它在輸出裡寫推理 | 刪掉,新模型本來就會先想,深度用 effort 控制 |
| 規定過細 | 判斷題寫成 STEP 1、2、3,一長串「不要」 | 寫目標、限制和怎麼驗證 |
| 單一範例 | 會照抄只放一個標準答案 | 幾個刻意不同的範例,標明僅供參考 |
| 輸出編排 | 「120 字以內」「最多五點」「每三步回報一次」 | 一起拿掉 |
| 化石 | 舊模型名字、為一次事故加的永久規則 | 寫現在的規則,不寫歷史 |
| 互相矛盾 | 兩個規則檔對同一件事講法不同 | 留一個地方講 |
「盡量」「如果可以」也會被抓:新模型照字面讀,會當成可以不做。1
哪些句子不准刪?
文件說,一份只會叫人刪的檢查,最傷最認真照做的人。1
拿自己的 skill 試一次
我照這份文件的規則,手動檢查自己寫的 code review skill 草稿:
| 原句 | 對到的模式 | 判斷 |
|---|---|---|
| 「每一個檔案都要看過,一個都不能跳」 | 施壓語氣 | 有理由留,但補理由:大 PR 會挑著看是現在還會發生的錯 |
| 「最多報 5 則」 | 輸出編排 | 待決定要討論:是產品限制(太多意見沒人看),還是舊模型的習慣? |
| 「找不到就跳過,不要編造」 | 規定過細(do not hallucinate) | 低信心,先留著,之後用測試確認 |
| 第 1 節「先跑腳本定範圍」 | 規定過細 | 不准刪留:這是流程固定的操作,要精確步驟 |
| 「以下類別不刪,就算你覺得不太確定」 | 施壓語氣 | 改寫:補上為什麼權限和安全寧可多報 |
五句裡只有一句明確要改。大部分不是刪,是補上理由。
opencode 也這樣做嗎?
opencode 會依模型挑不同的 system prompt。開源 repo 記錄了給 Claude 那份怎麼變:
| 時間 | 給 Claude 的 prompt | 全大寫強調(MUST、NEVER…) |
|---|---|---|
| v1.19 | 專用的,105 行 | 8 個 |
| v2 初期 | 專用的,53 行 | 7 個 |
| 2026-09-05 | 最短整份刪掉,改用所有模型共用的 15 行 | 0 個 |
| 2026-09-11 | 加回一段:註解密度跟著周圍的程式碼 | 0 個 |