常駐檔不是寫完就好：找重複錯誤，定期修剪過期規則

常駐檔砍過、加過，很多人就以為完工了，從此不再動它。

三個月後它開始出問題。專案改版了，檔案裡還寫著舊的資料夾；模型換新了，當初為了防呆寫的十條規定變成綁手綁腳；你加了一條新規則，跟三個月前那條矛盾，AI 隨便挑一條聽。這些都不是檔案寫錯，是檔案沒有跟著你一起變。

我把常駐檔當成一座花園在養：定期施肥（加你發現的新錯誤），定期修剪（刪已經不成立的規則）。這一篇講兩邊各自的工具。

施肥（加）                        修剪（刪）
/insights 找出反覆出錯的地方       專案改版 → 舊路徑、舊流程刪掉
  ↓ 你判斷值不值得寫成規則         模型升級 → 舊防呆規則試著刪掉
撞一次，加一條                     /doctor 找出 AI 自己查得到的內容

用 /insights 找出反覆出錯的地方，但規則要自己寫

Claude Code 有一個指令 /insights，它分析你這台機器上最近的對話（一次最多兩百場，很短的跳過），產出一份 HTML 報告，內容是：你都在做什麼、哪裡常卡住（例如它誤解你的要求、寫出有 bug 的程式）、以及建議你試的功能。報告存在 ~/.claude/usage-data/report.html，每次跑都留一份時間戳副本，三十天後跟其他對話紀錄一起清掉。

有個容易搞錯的地方：它不會直接生成一段可以複製貼上的 CLAUDE.md 規則。它產的是使用模式的診斷報告，不是規則產生器。你從報告裡看到「你每次改完程式都要提醒它跑 lint」，然後由你判斷：這值得寫進常駐檔嗎？寫成 MUST 還是 SHOULD？寫在哪一層？這個判斷還是人的事。

我自己的用法是每個月跑一次，只看「卡住」那一段，挑出重複出現兩次以上的，照 MUST／SHOULD／MAY 的格式加進去。一次加兩三條就好。

跨工具的同步技巧也順便講：如果同一個專案有人用 Claude Code、有人用 Codex，讓 CLAUDE.md 只寫一行 @AGENTS.md，兩邊就讀同一份，你只需要維護一個檔案。

修剪比施肥難

加規則很容易，因為每一條都是你痛過才加的。刪規則很難，因為你不確定刪了會不會又痛一次。結果檔案只長不消，八百行的常駐檔就是這樣來的。

官方文件對這件事的說法很直接：定期檢視你的 CLAUDE.md、子資料夾的 CLAUDE.md、.claude/rules/，移除過期或互相矛盾的指令，因為兩條矛盾時它會隨便挑一條。工具上，/doctor 現在會找出「Claude 可以從程式庫推導出來」的內容並建議砍掉，先報告、等你確認才改。

我自己用三個時機決定該刪什麼。

專案改版時。資料夾搬了、流程換了、工具換了，常駐檔裡提到舊東西的那幾條，當天就刪，不要等。這種過期規則最危險，因為它不只沒用，還會把 AI 導向錯的地方。

模型升級時。新一代模型通常更會理解意圖，一些你當初為了防止舊模型犯蠢而寫的規定（「不要在每段開頭重複問題」「回答前不要先道歉」），對新模型可能是多餘的。做法是先刪再看：刪掉一批，跑幾天，真的又出錯再加回來。我的經驗是刪掉的多數都不需要加回來。

每次加規則時。加一條，就順手看看有沒有哪條跟它矛盾、或已經被它取代。這是成本最低的修剪時機，因為檔案正好開著。

動手做

Claude Code 用了一陣子的，在對話裡打 /insights，等它跑完，打開 ~/.claude/usage-data/report.html。只看「哪裡常卡住」那一段，找重複出現的。每一條問自己：這是 AI 不知道（加進常駐檔）、還是我沒說清楚（改我的交辦方式）、還是它做不到（換工具或換方法）？只有第一種值得寫成規則。加完打 /doctor，看它有沒有建議砍掉什麼。

常駐檔很久沒動、想修剪的，不管什麼工具，把常駐檔和「最近改了什麼」一起貼給它：

下面是我的常駐規則檔，以及專案最近的變動。請做三件事：
1. 過期檢查：列出提到已不存在的路徑、流程、工具、或「暫時」性交代的條目，建議刪除。
2. 矛盾檢查：列出互相衝突的條目，說明衝突在哪，讓我決定留哪一條。
3. 冗餘檢查：列出「現在的模型不需要提醒也會做到」的防呆規則，標記為「可試刪」。
不要直接改，輸出三份清單給我勾選。
常駐檔：（貼上）
最近的變動：（例如：資料夾從 src 搬到 app；改用 pnpm；換了新模型）

做對了的樣子：每個月的 /insights 報告裡，上個月挑出來的那兩個卡點沒有再出現；常駐檔的行數三個月來沒有單向增加；沒有任何一條提到已經不存在的路徑或工具；你刪過規則之後，AI 沒有因此又犯回去，代表那條本來就不需要。

五分鐘就能做的一件事：打開常駐檔，找出最舊的三條規則，問自己「這條上次真的發揮作用是什麼時候」。答不出來的，刪掉，看一週。

/insights 是診斷報告，不是規則產生器，從報告到規則中間那一步判斷是你的。只有「AI 不知道」的卡點值得寫成規則。修剪的三個時機：專案改版當天、模型升級後先刪再看、每次加規則時順手看矛盾。常駐檔的行數如果只增不減，它正在變成沒人敢動的東西。

站內延伸

• 砍的三個問題 → 先砍掉一半
• 加的五個問題 → AI 猜不到的默會知識
• 文件版本與有效期怎麼管 → 找方法AI 文件版本與有效期

來源： Claude Code：Manage costs effectively（/insights 分析範圍、報告內容與位置、保留期限）；Claude Code：Commands（/doctor 的修剪功能）；Claude Code：How Claude remembers your project（定期移除過期與矛盾指令的建議）。