你的 AI Config 裡全是它不會遵守的規則

我的 CLAUDE.md 曾經長到 3,550 行。

花了好幾個月不斷往裡面塞規則，覺得寫越多 Claude 就越聽話。直到我認真分析了哪些規則 Claude 真的有遵守——答案讓我崩潰：文字規則的實際執行率接近零。

於是我砍到 ~400 行，把真正要強制的東西搬去 hooks（程式碼強制執行），然後把反覆出現的結構性問題做成了一個開源 linter：ailint。

這篇文章講的是我在砍掉那 3,150 行的過程中發現的五種 pattern——你的 config 裡大概也有。

五個讓你的 Config 失效的 Pattern

1. 模糊措辭

盡量寫乾淨的程式碼。
Try to keep responses concise.

AI 看到「盡量」「try to」就等於拿到免死金牌——它永遠可以說「我盡量了」。這不是規則，是建議。建議會被忽略。

修法： 把每個「盡量」「try to」「when possible」換成具體條件，或直接刪掉。

2. 自相矛盾

Section A：收到任務直接做，不要問。
Section B：任何修改都需要先確認才能執行。

寫到 Section B 的時候早就忘了 Section A 寫了什麼。AI 自己選一個遵守，通常選對它最方便的那個。

修法： 搜尋你的 config 裡有沒有互相衝突的關鍵字對。或用 ailint --deep 找語意層面的矛盾。

3. 冗餘

同一條規則用不同措辭寫了三遍——一次在 Safety、一次在 Operations、一次在 Guidelines。佔 context window 但沒增加約束力。

修法： 兩個段落相似度超過 70%，合併。

4. 死引用

部署流程見 rules/deploy-sop.md

那個檔案三個月前就刪了。AI 看到引用但找不到檔案，只好自己猜。

修法： 盤點 config 裡的每個路徑。或讓 R004 自動抓。

5. 膨脹

檔案越來越長，誰也不敢刪，因為不確定哪條還有用。結果重要的規則被稀釋在一堆「可能有用」的噪音裡。

修法： 超過 500 行就該警覺。超過 1,000 行，大部分都在被忽略。

ailint：AI Config 的 Linter

我把這五個 pattern 做成了一個 CLI 工具，支援 CLAUDE.md、AGENTS.md、GEMINI.md、.cursorrules、.windsurfrules。

pip install airulelint
ailint CLAUDE.md

CLAUDE.md:45:3  warning [R002] Vague phrase 'try to' is hard to enforce.
CLAUDE.md:89:1  warning [R003] Section 'Safe Operations' overlaps with 'Safety Rules' (0.78 similarity).
CLAUDE.md:167:5 error   [R004] Referenced path does not exist: rules/deploy-sop.md

✖ 3 problems (1 error, 2 warnings)

五條靜態規則、零依賴、一秒跑完。加 --deep 可以用 Claude CLI 做語意矛盾分析。

實際測了嗎？

我用 7 份真實的 config 跑了兩輪測試。第一輪發現 R004（死引用偵測）假陽性爆表——版本號 1.1/1.2、GCP 角色 roles/container.developer、中文括號全被誤判成檔案路徑。修正後：

誠實話

如果你的 config 不到 100 行，你不需要這個工具。 保持簡短、偶爾看一看就好。

ailint 是給已經掉進膨脹陷阱的人用的——config 長了好幾個月、累積了矛盾、長到沒辦法人工 review 的那種。如果這聽起來很熟悉，跑一次看看。

但更深的教訓不是關於工具本身，而是：真正能約束 AI 行為的是程式碼，不是文字。 Hook（阻斷壞行為）比規則（拜託它不要做）有效。Linter（自動偵測問題）比一段「最佳實踐」有效。

你的 config 應該短、具體、可強制執行。其他的都是噪音。

GitHub： MakiDevelop/ailint
安裝： pip install airulelint

我是江中喬，一位具有 TPM 與產品管理背景的 AI 系統建構者，目前專注於 AI 認知增強系統與多 Agent 協作架構的設計與實踐。