---
site: "zyx.tw"
title: "把能自動判斷的規則設成合併條件"
description: "讓規則決定修改能否合併，不再只靠 agent 記得執行。"
url: "https://www.zyx.tw/map/principles/rules-become-checks"
---

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

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

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

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

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

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

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

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

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

**規則的執行方式 文字規則**

執行方式:
- Claude Code 載入規則後自行遵守

可能的結果:
- 對話變長時漏掉要求

文字規則可以被讀取。是否落實，仍依賴 Claude Code 記得。

**規則的執行方式 手動檢查**

執行方式:
- 交付前由 Claude Code 執行檢查

可能的結果:
- 忘記執行時，違規修改仍會送出

手動檢查依賴 Claude Code 記得執行。

**規則的執行方式 合併前自動檢查**

執行方式:
- pull request 自動執行檢查

可能的結果:
- 檢查未通過就不合併

檢查設為合併條件。不必依賴 Claude Code 記得執行。

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

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

```text
╭────────╮   ╭────────╮   ╭────────╮   ╭────────╮   ╭────────╮
│ CHANGE │──>│  LINT  │──>│ TESTS  │──>│ REVIEW │──>│ MERGE  │
╰────────╯   ╰───┬────╯   ╰───┬────╯   ╰───┬────╯   ╰────────╯
    ^            │ fail       │ fail       │ fail
    ╰────────────┴────────────┴────────────╯
```

Figure: A change passes lint, then tests, then review before it merges. A failure at any gate sends it back to be changed.

1. Lint: 靜態分析不執行程式，只讀程式碼與文字。規則檢查屬於這一類。
2. Tests: 測試會執行程式，確認原有的行為沒有被改壞。
3. Review: 高風險的修改，再交給人或另一個 agent 審查。
4. Fail: 沒通過的修改退回。錯誤訊息要說明原因與修法。
5. Merge: 全部通過，修改才合併。

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

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

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

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

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

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

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

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

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

## 來源

- [Software Engineering at Google: Testing Overview](https://abseil.io/resources/swe-book/html/ch11.html), Google
- [Software Engineering at Google: Static Analysis](https://abseil.io/resources/swe-book/html/ch20.html), Google
- [Software Engineering at Google: Code Review](https://abseil.io/resources/swe-book/html/ch09.html), Google

## 地圖

- 相關：[把糾正存成規則，保存位置依適用範圍決定](https://www.zyx.tw/map/goals/remembers-me.md)
- 相關：[我把畫面修正寫回共用元件庫，再更新各網站的舊寫法](https://www.zyx.tw/map/craft/one-design-system.md)
- 回到：[原則](https://www.zyx.tw/map.md)
