自訂 Code Review

• CLAUDE.md：Claude Code 在每項任務（包括審查）中都會讀取的專案指令。Code Review 會將其作為專案脈絡讀取，並標記違反這些指令的變更。
• REVIEW.md：僅用於審查的指令。用它來說明您的團隊希望標記哪些內容、以何種嚴重程度標記，以及要略過哪些內容。

​

使用 CLAUDE.md 設定全專案規則

​

使用 REVIEW.md 設定僅限審查的規則

your-repo/
├── REVIEW.md            # Root file
├── services/
│   └── billing/
│       └── REVIEW.md    # Adds checks for changes under services/billing/
└── src/

​

REVIEW.md 範例

# Review instructions

## What Important means here

Reserve Important for findings that would break behavior, leak data,
or block a rollback: incorrect logic, unscoped database queries, PII
in logs or error messages, and migrations that aren't backward
compatible. Style, naming, and refactoring suggestions are Nit at
most.

## Cap the nits

Report at most five Nits per review.

## Do not report

- Anything CI already enforces: lint, formatting, type errors
- Generated files under `src/gen/` and any `*.lock` file
- Test-only code that intentionally violates production rules

## Always check

- New API routes have an integration test
- Log lines don't include email addresses, user IDs, or request bodies
- Database queries are scoped to the caller's tenant

​

決定在 REVIEW.md 中撰寫的內容

• 錯誤的項目被標記為 Important：為您的儲存庫重新定義 🔴 Important 的意義。預設校準以正式環境程式碼為目標，而文件儲存庫、設定儲存庫或原型可能需要範圍窄得多的定義。請說明哪些類別的發現屬於 Important，哪些最多只算 Nit。您也可以提高等級，例如將任何違反 CLAUDE.md 的情況視為 Important。
• nit 太多：限制單次審查張貼的 🟡 Nit 留言數量。例如「最多回報五個 nit」這樣的上限，能讓審查保持可據以行動。
• 在產生的檔案或 CI 已檢查的項目上留言：列出 Claude 應略過發現的路徑與發現類別。常見的候選項目包括產生的程式碼、lockfile 和 vendored 相依套件，以及 CI 已強制執行的任何項目，例如 linting 或拼字檢查。對於值得某種程度審查但不需完整檢視的路徑，請改為設定較高的門檻：「在 scripts/ 中，僅在幾乎確定且嚴重時才回報。」
• 團隊規則未被檢查：新增您希望在每個 pull request 上標記的規則，例如「新的 API 路由必須有整合測試」。
• 結果證明有誤的發現：要求某類發現在張貼前必須提供證據。例如，「行為相關的主張需要在原始碼中提供 file:line 引用，而非從命名推論」，可減少誤報，避免作者因此多花一次往返。

​

從哪個分支讀取 REVIEW.md

• 降低發現的嚴重程度
• 排除路徑、檔案或問題類別
• 限制 nit 留言數量

​

哪些設定算是分支保護

• 預設分支：傳統分支保護規則或 ruleset
• 任何其他分支：僅限 ruleset

​

各種分支設定下審查會讀取的內容

​

相關資源

• Code Review：此服務是什麼，以及審查如何執行
• 在 pull request 上閱讀與請求審查：各嚴重程度等級的意義，以及發現如何呈現
• 設定 Code Review：由 Owner 設定的審查等級與審查執行時機
• 使用 /code-review 在本機審查：/code-review 命令、其引數與 effort 等級
• 記憶：CLAUDE.md 檔案在 Claude Code 中的運作方式