把能自動判斷的規則設成合併條件

深讀 L2 827 字 2 分鐘 v2.0.0 更新 2026-11-16

能自動判斷的規則,要設成合併前必須通過的檢查。文字規則即使已載入,agent 仍可能漏掉要求;檢查則能直接擋下違規的修改。

這個做法的前提,是專案透過 pull request 合併修改。pull request 是修改進入專案前的關卡,可以把檢查結果設為合併條件。

先決定由誰判斷,再決定何時執行

以「文案不使用破折號」為例。agent 在對話變長時可能漏掉這條要求,但是否出現破折號,可以用文字比對判斷,不需要閱讀整篇文案才能決定。

建立檢查時,先把這類要求寫成比對條件。檢查工具自動執行比對;只要有一道檢查未通過,修改就退回,不能合併。

需要讀懂內容才能判斷的規則,則交給 agent 在送出前檢查,而且只檢查修改過的檔案。這條路徑仍需要 agent 執行,不能當成同樣的自動關卡。

下圖對照文字規則、手動檢查與合併前自動檢查,呈現各種執行方式,以及忘記執行時可能發生的結果。

規則的執行方式

執行方式

  • Claude Code 載入規則後自行遵守

可能的結果

  • 對話變長時漏掉要求
文字規則可以被讀取。是否落實,仍依賴 Claude Code 記得。

把執行較快的檢查排在前面

合併前有多道關卡時,把執行較快的檢查排在前面。下圖示範修改依序通過 lint(檢查程式是否符合規則)、測試與審查,任一關失敗都退回修改。

靜態分析不執行程式,只讀程式碼與文字。規則檢查屬於這一類。

同一條糾正出現第 2 次,就改成檢查

同一條糾正出現第 2 次,就改成檢查。能用文字比對的部分,可以請 Claude Code 寫成自動檢查。

每條規則各用一個檔案,寫清楚適用哪些檔案,再附上錯誤與正確的例子。適用範圍決定檢查哪些內容,例子則讓違規與合規的界線明確。

這裡使用的規則檢查工具是自製的,也可以改用現成的 lint 工具。

規則改成檢查後,刪除原本對應的文字規則。這樣只需維護一份要求,避免同一條規則分散在文字指示與檢查條件裡。

誤報與漏網,要查不同的地方

檢查的誤報太多,就沒有人理會結果。規則要寫到能精確判斷。

不想被改壞的行為都要寫成測試,Google 的工程書把這條稱為 Beyoncé Rule。沒有測試保護的行為,被改壞時不會有人發現。

檢查只涵蓋已寫下來的行為,通過不代表沒有錯誤。未納入檢查的部分仍要實際操作,完成的判準見 怎樣才算完成。

來源

讀完之後

原則AX量測檢查開源