透過多代理 PR 審查增強 Claude Code：adamsreview 簡介

AI 驅動的程式碼審查正迅速從簡單的提示詞建議演進為複雜的代理工作流。雖然像 Claude Code 內建的 /review 和 /ultrareview 等工具提供了基礎功能，但開發者發現，若要超越表面層面的回饋並捕捉真正的架構錯誤，需要一種更具結構化、多階段的方法。

adamsreview 是 Claude Code 的一個插件，旨在透過實作一個優先考慮深度與驗證而非單次分析的多代理系統，來專門解決這些限制。藉由利用並行子代理與持久化狀態，它將 PR 審查流程從聊天互動轉變為結構化的工程流水線。

adamsreview 的架構

與嘗試在單個提示詞中分析整個程式碼庫的標準 AI 審查工具不同，adamsreview 採用了多階段策略。這種方法模仿了內建的 /review 指令，但透過幾項關鍵技術增強進行了擴展：

並行子代理與驗證

該工具利用並行子代理對程式碼的特定領域進行深入探究。它不是由一個代理處理所有事情，而是將工作負載進行分配。隨後會進行驗證階段，確保代理提供的建議不僅合理，而且正確。這降低了「幻覺」率，並最大限度地減少了經常困擾 AI 程式碼審查的誤報。

持久化狀態管理

在長時間運行的 AI 代理工作流中，主要的挑戰之一是上下文窗口飽和。adamsreview 透過在磁碟上以 JSON 檔案作為存儲媒介來解決此問題。這允許使用者在審查階段之間清除上下文，而不會丟失進度。藉由維護發現結果的持久化記錄，該工具可以在分析、導覽與修復之間進行轉換，而無需在每一輪中重新處理整個程式碼庫。

指令集

該插件提供了六個專門的斜槓指令來管理 PR 的生命週期：

• /review: 啟動深度、多階段的審查流程。
• /codex-review: 與 Codex CLI 和 PR bot 評論整合，進行集成審查。
• /add: 將特定的上下文或檔案加入審查範圍。
• /promote: 將特定的發現結果提升至更高的優先級或最終報告。
• /walkthrough: 使用 Claude 的 AskUserQuestion 功能，引導開發者逐一處理不確定的發現，確保人工介入驗證。
• /fix: 指派每個修復組代理來實施變變更，然後使用 Opus 重新審查工作成果，並在提交之前撤銷任何回歸錯誤。

效能與成本考量

根據作者的說法，adamsreview 捕捉到的真實錯誤比 /ultrareview、CodeRabbit 或 Greptile 等內建工具顯著更多。一個顯著的操作優勢是其計費模式：它運行在使用者正規的 Claude Code 訂閱（建議使用 Max plan）之上，避免了與 /ultrareview 相關的「額外使用量」池費用。

然而，Hacker News 上的社群回應對這種方法的成本與複雜度提出了重要問題。一些使用者質疑，這種涉及的「儀式感」——多個階段與指令——是否會為開發者的工作流增加過多的摩擦力。

其他使用者則對「氛圍編碼 (vibe coding)」以及由於大量使用提示詞而導致 Token 消耗過快的風險表示擔憂。

對 AI 審查代理的批判性觀點

關於 adamsreview 的討論突顯了軟體工程社群對於 AI 在 PR 審查中扮演的角色所進行的更廣泛辯論。

一些開發者認為，代理式審查對於生產環境程式碼而言具有天生的風險。正如一位使用者所言：

代理審查 AI 程式碼對我來說總是有種不對勁的感覺，特別是在處理生產環境（不可拋棄）的程式碼時。

這種觀點建議，比起將審查流程委託給一系列代理，開發者更傾向於由 AI 支持的本地、人工主導的審查。此外，有一個反覆出現的擔憂，即我們可能正在「用複雜性來對抗複雜性」，即為了修復 AI 不準確的問題而加入複雜的代理框架，僅僅是在軟體開發生命週期中增加了另一層架構上的開銷。

結論

adamsreview 代表了向更嚴謹、AI 輔助的程式碼審查邁進的一步。透過從單次分析轉變為結構化的、具有持久化狀態的多代理流水線，它為那些尋求超越表面回饋的人提供了工具。雖然摩擦力與 Token 成本可能對某些人來說是個問題，預期會捕捉更深層的錯誤並減少誤報，這使其成為利用 Claude Code 生態系統的開發者的一個引人注目的選擇。