AI 程式開發與代理

[Claude Code #9] /code-review,從 low 到 ultra

Claude Code /code-review 會從分支變更中找出錯誤與改善點。本篇整理各 effort 等級的差異、--fix·--comment 旗標,以及雲端多代理 ultra 審查與費用。

閱讀 5 分鐘
[Claude Code #9] /code-review,從 low 到 ultra 封面圖

有時候,直接提交 AI 撰寫的程式碼會讓人不安。在請人類審查者檢查前,需要先有一道初步過濾機制。

Claude Code 的 /code-review 就是用來做這件事。它會檢查目前分支的變更,找出錯誤與可整理之處。

本篇將依序整理各個階段,從可在本機調整強度的等級,到雲端的精密 ultra 檢查。

Claude Code 第 8 集介紹的 effort 等級,也會原樣套用到審查強度。

基本行為是檢查目前分支的變更

在工作階段輸入 /code-review,就會開始審查。

依據 官方文件,預設目標是比 upstream 超前的分支提交,以及尚未提交的變更。它會回報正確性錯誤,以及可重複使用、簡化與效率改善的機會。

也可以指定其他目標,例如檔案路徑、PR 編號、分支名稱,或 main...my-feature 這類範圍。

審查預設會由背景子代理在自己的上下文中執行。不會佔用目前的對話,完成後只會回傳結果。

等級:確信度還是涵蓋率

加上像 /code-review high 這樣的 effort 等級,就會改變審查強度。

  • low·medium:只回報最有把握的發現。誤判較少
  • high·xhigh·max:擴大涵蓋率。也可能包含把握度較低的發現

省略等級時,會重新使用上次手動輸入的等級。畫面也會顯示「重新使用上次輸入的 high」之類的提示。

Claude Code /code-review 等級與旗標選擇結構圖
等級與旗標的組合會決定審查的特性

只找問題,還是也讓它修正

  • --fix:審查結束後,直接將發現套用到工作樹
  • --comment:以 PR 內嵌留言的形式發布發現

--fix有一點需要注意。背景審查的修改是在工作階段檢查點之外進行,因此無法用 /rewind 還原。不喜歡的話,必須用 git 還原。

ultra:雲端多代理審查

/code-review ultra的檢查規模不同。這是由多個代理在雲端平行深入調查的 ultrareview。

範圍也不同。它會將目前分支與儲存庫的預設分支比較,並包含未提交的變更。也可以像 /code-review ultra develop 一樣更換比較基準分支。

使用 官方 ultrareview 文件 時,需要以 claude.ai 帳號驗證。Pro·Max 可免費執行 3 次,之後每次審查約會從使用量點數扣除 5~25 美元。

如果目標是 github.com 的 PR,執行前對話框會顯示是否要將結果發布為自己帳號留言的選項。加上 --post 後會預先選取該項目,但是否發布仍會再詢問一次(v2.1.227 以上)。

日常提交使用本機等級就足夠;像發布前最終檢查這類重要時刻,再使用 ultra,這樣分工很自然。在 Bedrock 等無法使用 ultra 的環境中,此命令會靜默改以本機審查執行。

與同類命令的區別

另外還有兩個名稱相近的命令。

  • /simplify:不搜尋錯誤,只做整理與簡化,並套用修正的清理專用命令
  • /security-review:只集中檢查變更中的安全漏洞

想找錯誤時使用 /code-review,想整理程式碼時使用 /simplify,分開處理即可。

機器人站在寫著 PICK YOUR REVIEW 的文字,以及 BUGS·CLEANUP 兩扇門前猶豫的插圖
找錯誤走左邊的門,清理工作走右邊的門

調整審查標準

本機審查會像其他工作階段一樣遵循 CLAUDE.md 的專案規則。將團隊慣例寫在 CLAUDE.md 中,也會反映到審查結果。

另外,還有可自動審查 GitHub PR 的受管理 Code Review,僅供 Team·Enterprise 使用。它透過 REVIEW.md 這個專用審查檔案調整標準,但本機的 /code-review 不會讀取此檔案。

總結

作為提交前的習慣,/code-review 就足夠了。想重視確信度就用 low·medium,想擴大檢查範圍就用 high 以上。

要連修正一起交給它,使用 --fix;發布前的精密檢查則提升到 ultra

下一篇將介紹一組查看工作階段狀態的診斷命令,包括 /doctor·/context·/usage 等。

來源與確認標準

延伸閱讀

Claude Code 系列

相關主題