Claude Code 團隊公開自家審查流程:每個 PR 先過 AI 審查,再依風險決定人工簽核

Anthropic 工程文章說明 Claude Code 團隊如何做 code review:平行找 bug 的代理加投票驗證、REVIEW.md、依風險分級的人工核准,並公布合併量與退版率的變化。

重點

  • Claude 寫了 Claude Code 約 90% 的程式碼;6 月到 9 月,合併的 PR 增加超過一倍,需要退版的比例下降超過 40%。
  • 每個 PR 都有 AI 審查(平行找 bug 的代理,再由投票代理驗證)與資安審查,未解決的發現會擋住合併。
  • 程式碼負責人用 REVIEW.md 告訴審查者各目錄重視什麼;人工核准依變更風險分為零、一人、兩人。
  • 文章發表於 10/15,部分媒體在 11 月中旬再度報導;本文以原文為準。
目錄(4 節)
  1. 發生什麼事
  2. 流程
  3. REVIEW.md
  4. 對你的影響

發生什麼事

2026 年 10 月 15 日,Addy Osmani、Morgan Westlee Lunt 與 Qing Wang 在 claude.dev 部落格發表〈How the Claude Code team does code review〉,說明 Claude Code 團隊自己的審查流程。11 月中旬有媒體(TechGig、news.lavx.hu)再次報導,因此在新聞索引中日期晚了一個月,本文依原文日期。

文中的核心數字:

  • Claude 寫了 Claude Code 約 90% 的程式碼。
  • 6 月到 9 月,合併的 PR 增加超過一倍,需要退版的比例下降超過 40%。
  • Anthropic 單一程式庫每日合入的變更,從 5 月約 2,500 筆增加到 9 月超過 30,000 筆。
  • AI 審查進入研究預覽後,內部 PR 得到實質審查意見的比例從 16% 升到 54%。
  • 調整收斂機制後,一輪審查與修正就通過的 PR 從 65% 升到 78%,需要五輪以上的從 8.9% 降到 1.5%。

Claude Code 團隊公開自家審查流程,依風險分級決定人工簽核

流程

團隊的目標是在不增加退版與事故的前提下,把人工審查時間降到最低,多數 PR 最多只需要一位真人把關。審查貫穿全程:

  1. 開 PR 前:Claude 跑測試、建置與 linter,並讓一個子代理用乾淨上下文審 diff。
  2. 每個 PR:必要的 CI、AI 審查(多個代理平行找 bug,再由投票代理驗證)與資安審查;兩種審查有未解決的發現都會擋住合併。
  3. 風險分級核准:由分類器依「變更內容」而非作者決定等級。
  4. 合併佇列:對最新的 main 重跑檢查。
  5. 合併後:功能旗標(先給內部使用者)、分階段釋出、值班監控與快速回滾。

人工核准的分級:低風險(文件、文案、旗標後的附加變更)在自動檢查全綠後不需人工;中等風險需要一人;高風險需要兩人。文中另有幾條規則,例如只有受信任的作者能走較輕的路徑、代理的核准不算真人核准、核准只對特定 commit 有效,新 commit 進來要重新核准。

REVIEW.md

程式碼負責人用 REVIEW.md 告訴審查者各自區域重視什麼。文章描述好的 REVIEW.md 包含:說明這裡的「失敗」長什麼樣子、限制吹毛求疵的數量、列出要略過的路徑、要求用檔案與行號作為證據,以及摘要要以數量開頭、沒問題就明說。團隊也會檢查審查者是否真的照做。

對你的影響

不需要 Anthropic 的規模,也能借用幾個做法:一份簡短的 REVIEW.md 把你專案的雷區寫下來;把審查分成自動檢查與依風險決定的人工核准;以退版與事故率作為護欄,而不是只看審查速度。這些是原文的自我報告,結果在你的專案不一定重現,建議小範圍試行並追蹤退版率。