換到新模型後,給 AI 的規則檔要怎麼整理?

结论

找出「不再適合」的句子,不是把檔案變短。 Anthropic 把這套檢查寫成一份公開的 skill,Claude Code 也內建成 /doctor prompt-audit。

  1. 新模型更聽話、照字面做,為舊模型加的施壓語氣和步驟反而讓它用過頭。1
  2. 判斷刪不刪只問一題:模型自己會不會已經知道?只有作者知道的背景永遠留。1
  3. 不准刪的清單跟要刪的一樣重要。危險操作要留步驟,新模型還會犯錯的地方要留禁令,每條限制要留理由。1
  4. 刪掉一句只是假設,改前改後各跑一次,退步就用最短的說法加回去。1

适用于依據 anthropics/skills 的 prompt-audit.md(Apache 2.0)與 Claude Code 更新紀錄2026-11

1

為什麼講這題?

  1. 最近換到新模型

    最近換到新模型,以前寫的規則檔要不要跟著調?

  2. 聽到一個說法

    拿掉一堆限制型的句子,AI 反而更強。上週分享的訪談裡,Claude Code 團隊也說過他們以前把模型限制得太多。

  3. 找到一個指令

    Claude Code 有指令可以掃規則檔。方法寫在一份公開的 markdown 裡,誰都能拿去給自己的 AI 工具用。

所以今天拆開這份文件:它怎麼判斷哪句該刪、哪句不能刪。最後拿我自己寫的 skill 草稿試一次。

2

指令在哪裡?

入口掃什麼適合誰
/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 的人

文件本身就寫明,它同時適用 API 應用和 coding agent 的設定檔(CLAUDE.md、AGENTS.md、skill、自訂指令)。1 2

3

它怎麼跑?

八步:盤點、判斷、報告、驗證
图的结构
  • 定範圍和模型 scope
  • 盤點文字 inventory
  • 查來歷 blame
  • 刪除規則 classify
  • 掃四組反模式 scan
  • 報告 report
  • 提出修改 diff
  • 前後驗證 verify
  • blame → classify
  • classify → scan
  • diff → verify
  • inventory → blame
  • report → diff · 只放中高信心
  • scan → report
  • scope → inventory
  1. 定範圍和模型

    不問使用者,從 repo 推斷。假設寫在報告最上面,錯了重跑就好。

  2. 盤點文字

    找出所有會送進模型的文字:規則檔、skill、tool 描述、範例。設定檔和金鑰不讀。

  3. 查來歷

    對每句強調或禁止的話跑 git blame。問兩題:它當初在防什麼錯?新模型還會犯嗎?

  4. 刪除規則

    只問一題:模型自己會不會已經知道?

  5. 報告

    每條寫位置、原文、對到哪個模式、為什麼過時、信心高中低。

  6. 提出修改

    一條一塊,讓人挑著收。不自己改檔案。

  7. 前後驗證

    刪除是假設不是結論。一次改一個,退步就用最短的說法加回去。

4

哪些句子會被抓出來?

反模式舊寫法新寫法
施壓語氣用過頭CRITICAL: You MUST use this tool when...Use this tool when...
被功能取代的鷹架「think step by step」、要它在輸出裡寫推理刪掉,新模型本來就會先想,深度用 effort 控制
規定過細判斷題寫成 STEP 1、2、3,一長串「不要」寫目標、限制和怎麼驗證
單一範例會照抄只放一個標準答案幾個刻意不同的範例,標明僅供參考
輸出編排「120 字以內」「最多五點」「每三步回報一次」一起拿掉
化石舊模型名字、為一次事故加的永久規則寫現在的規則,不寫歷史
互相矛盾兩個規則檔對同一件事講法不同留一個地方講

「盡量」「如果可以」也會被抓:新模型照字面讀,會當成可以不做。1

5

哪些句子不准刪?

文件說,一份只會叫人刪的檢查,最傷最認真照做的人。1

6

拿自己的 skill 試一次

我照這份文件的規則,手動檢查自己寫的 code review skill 草稿:

原句對到的模式判斷
「每一個檔案都要看過,一個都不能跳」施壓語氣有理由留,但補理由:大 PR 會挑著看是現在還會發生的錯
「最多報 5 則」輸出編排待決定要討論:是產品限制(太多意見沒人看),還是舊模型的習慣?
「找不到就跳過,不要編造」規定過細(do not hallucinate)低信心,先留著,之後用測試確認
第 1 節「先跑腳本定範圍」規定過細不准刪留:這是流程固定的操作,要精確步驟
「以下類別不刪,就算你覺得不太確定」施壓語氣改寫:補上為什麼權限和安全寧可多報

五句裡只有一句明確要改。大部分不是刪,是補上理由。

7

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 個

先刪到最短,看到 Claude 每個函式都加註解,再用一段話加回去。這跟 prompt-audit 第七步一樣,3 4 但 opencode 沒說它是照這份文件做的。用 opencode 時,背後的 prompt 已經是這樣,自己寫的 AGENTS.md 也能照同一個方向檢查。

8

回去可以做什麼?

方法的全文在 anthropics/skills,1 「以前把模型限制得太多」這句出自上週分享的訪談。5

正在打开交互图…