再多的 Claude Code 修改,也無法終結一個不斷回傳「需要修改」的 Codex 審查。每一次推測性的修補,都會讓審查者有新的程式碼可以評論,因此每次審查都會帶回新的意見。在任何人動手修改程式碼之前,請先將審查意見進行分類。關於如何讓 Codex 審查 Claude Code 的提交,涵蓋了鉤子、工作樹和循環本身。
本文將從設定之後開始,探討一個持續運行卻無法達到「接受」狀態的循環。請將每個審查意見歸類為五種之一。
當使用 Codex 審查 Claude Code 提交的程式碼時,若不斷收到「需要修改」的回饋,會陷入無止盡的循環。為避免這種情況,應在修改程式碼之前,先將所有審查意見進行分類。本文將說明如何透過五種分類方式,有效管理 AI 程式碼審查流程,確保每次修改都能朝著接受的方向前進。

再多的 Claude Code 修改,也無法終結一個不斷回傳「需要修改」的 Codex 審查。每一次推測性的修補,都會讓審查者有新的程式碼可以評論,因此每次審查都會帶回新的意見。在任何人動手修改程式碼之前,請先將審查意見進行分類。關於如何讓 Codex 審查 Claude Code 的提交,涵蓋了鉤子、工作樹和循環本身。
本文將從設定之後開始,探討一個持續運行卻無法達到「接受」狀態的循環。請將每個審查意見歸類為五種之一。
我的審查者會針對簡報中的每一行和每一條內部規則,給出「符合」、「不符合」或「無法檢查」的回覆。不在這個列表中的審查意見,需要具體的失敗案例:包括輸入或步驟,以及哪裡出了問題。在 Claude Code 收到下一個修改請求之前,每個審查意見都會被分類並給出回應:
審查意見類別:回應
簡報或內部規則違規:修正它,或者當要求本身有爭議時,諮詢人工。
簡報範圍外的失敗:僅在有具體重現細節時才阻擋。
審查者偏好:移至後續追蹤事項,除非有書面規則要求。
無法驗證的主張:在修補任何內容之前,要求提供證據。
遺失、重複或格式錯誤的判斷:操作失敗,請故意重新運行,不計入審查輪次。
當審查本身發生故障時,例如崩潰、最終訊息空白,或判斷遺失、重複或格式錯誤,將不會保存任何判斷結果。由於沒有保存判斷結果,我的閘門會拒絕合併。review.sh 在保存「接受」時退出代碼為 0,保存「需要修改」時為 2,未保存任何內容時為 1。
退出代碼 1 與程式碼無關,因此 Claude Code 無需修復。閘門不會自行重試。請閱讀日誌,然後故意重新運行審查。關於審查崩潰或未返回判斷結果時閘門的處理方式,已涵蓋了這種情況。
阻擋合併的意見需要一個可重現的失敗案例。在我的設定中,一個審查意見若附帶可重現的失敗,才算成立。如果沒有,它將被移至後續追蹤事項。這條規則的存在是因為審查者可能會出錯,而且測試只檢查它們被設計來檢查的內容。對於阻擋合併的意見,請向 Codex 索取三項資訊:觸發問題的輸入或步驟、預期行為,以及實際行為。
有了這些資訊,Claude Code 就能修復已證實的失敗。如果沒有這些,它將會不斷修補,導致每次審查都產生更多意見。測試也應受到同樣的處理。在「弱化測試範例」中,add(2, 3) 返回 6,而弱化的斷言卻接受了它,導致測試套件在錯誤存在的情況下仍然通過。
新的測試應該在舊行為上失敗。一個沒有說明理由的寬鬆斷言可能會導致「需要修改」的結果,審查也可能遺漏它,因此通過審查並不保證程式碼的正確性。
簡報違規與審查者偏好:簡報違規是必須進行的修改。偏好則是對已符合簡報要求的程式碼,提出技術上可行的替代方案。逐行檢查讓 Codex 能夠區分兩者:一旦簡報中的每一行和內部規則都已「符合」,剩下的評論若要阻擋合併,就需要一個可重現的失敗案例。
舉例來說,Codex 建議將 get_rows 更名為 fetch_rows。如果簡報中的每一行都已符合,沒有任何失敗,且沒有內部規則涵蓋命名模式,那麼這個評論就會被移至後續追蹤事項。但如果內部規則確實設定了命名模式,那麼相同的評論就會變成「不符合」的要求,Claude Code 就會在這一輪中進行修復。
後續輪次會收到更精簡的審查包。早期輪次可以提出任何相關問題。後續輪次則只提出阻擋合併的問題,較小的問題會被列入後續追蹤清單。每一輪都審查當前的提交。我的判斷結果是根據確切的已審查提交保存的,因此新的提交需要新的審查,而舊提交的「接受」不能涵蓋已更改的程式碼(判斷結果為何保存於提交雜湊之下)。
這種精簡化發生在 Codex 每個後續輪次收到的審查包中:未解決的審查意見、自上次審查以來的變更、確切的當前提交及其差異。針對該審查包的簡潔提示詞是:「審查當前提交。重新檢查未解決的審查意見和自上次審查以來的變更。不要重新開啟已解決的偏好或不相關的程式碼。
超出此範圍的新阻擋問題需要具體的重現細節。」當 Codex 識別並重現失敗時,新的阻擋問題在任何輪次中都保持有效,因此精簡化不會隱藏回歸問題。
在第一輪之前設定一個硬性停止點。在第一輪之前寫下上限。告知 Codex 當前是第幾輪,以便它知道何時適用後續輪次的規則。如果允許的最後一輪仍返回「需要修改」,請停止發送修復。判斷結果仍為「需要修改」,合併也將保持被阻擋,因為上限永遠不會將結果轉變為接受。
此時,由人工決定下一步:改變方法、拆分變更,或故意允許額外一輪。非阻擋性問題則在後續追蹤事項中等待,不會阻礙合併。只計算實質性輪次,因此操作失敗後的重新運行不會影響計數。新的提交不會重置相同變更的計數,否則每次修復都會獲得一組新的輪次。
官方 Codex 外掛已涵蓋的內容:OpenAI 發布了一個適用於 Claude Code 的 Codex 外掛,其中包含一個可選的審查閘門。這個閘門是一個停止鉤子:當針對 Claude Code 回應的 Codex 審查發現問題時,它會阻擋停止,以便 Claude Code 能夠處理這些問題。
停止閘門的提示詞將審查範圍限制在 Claude Code 上一次產生修改的輪次,要求阻擋性主張必須基於儲存庫上下文或經檢查的工具輸出,並返回「允許」或「阻擋」。/codex:adversarial-review 背後的提示詞要求提供實質性發現,並排除風格回饋、命名回饋、低價值清理以及沒有證據的推測性問題。
這兩個提示詞都已應用了上述章節中的證據標準。README 警告說,這個閘門可能會在 Claude Code 和 Codex 之間產生一個長時間運行的循環,快速耗盡使用限制,並且只應在您監控會話時開啟。文件將停止策略留給您決定:實質性輪次的上限、如何解決有爭議的簡報、如何在重複的修復提交中縮小後續輪次的範圍,以及非阻擋性問題的去向。
有爭議的需求和範圍應交由人工處理。當 Claude Code 和 Codex 對一個驗收標準有兩種不同的解讀時,每一輪都會在新的提交中重複這個分歧。這個循環缺少了沒有人寫下來的產品意圖,而額外的審查也無法提供。請保留未解決的判斷結果,並向變更的負責人發送一個簡短的問題。
範圍問題和任何用戶會看到的問題都應以同樣的方式處理。Codex 提供證據,負責人選擇需求,Claude Code 實施該決定,然後 Codex 再根據該決定進行審查。這個循環最終會進入兩種狀態之一:當前提交的「接受」,或者一個已記錄的阻擋判斷結果加上人工對下一步的決定。
在您自己的儲存庫上運行這些規則。「Two Engines Kit」包含了審查提示詞、輪次規則和特定提交的判斷記錄。它是根據自第一個 Codex 和 Claude CLI 以來收集的資訊所建立的。獲取 Two Engines Kit。如果您希望為您設定這個循環,我會設定 Codex 在您的 Claude Code 提交合併之前進行審查。
審查設定是根據您的儲存庫、其技術棧和慣例從頭編寫的,第一次審查將在您的一個真實分支上運行。沒有任何內容是從模板或 Two Engines Kit 複製的。請參閱 AI 程式碼審查設定。
覺得值得一看?分享給朋友。
以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Codex) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。
43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。