合併之前,怎樣審查 AI 寫出的程式
對着你的要求檢查 diff:不該動的檔案、錯誤處理、新的依賴,以及真正覆蓋這次改動的測試。你可以在 git 或 pull request 裏審查,也可以讓另一個代理先看一遍,或者用 Coppice 這樣的看板:寫程式之前先批准計劃,合併之前再對着計劃審查 diff。
為甚麼這件事難辦
代理寫程式,比你讀得快。一個小要求,回來可以是一大份 diff,裏面有你沒有要求的改動,摘要卻說一切正常。逐行讀太慢。掃一眼又會漏掉錯誤。
難處在於你要知道代理本來該做甚麼。沒有這一點,你分不清某項改動該不該出現在 diff 裏,還是沒有人要求的範圍。
diff 裏要看甚麼
無論用哪種方式審查,都看這些:
- 範圍。 你沒有預計的檔案,例如 lockfile、遷移、設定,或重新命名。
- 錯誤路徑。 輸入缺失、呼叫失敗,或者值是空的時候會怎樣。
- 依賴和存取。 新的套件、指令碼、憑證,或誰能讀取、誰能修改資料的變化。
- 測試。 真正跑過這次改動的測試,而不是摘要裏說測試通過的那一行。
做法一:在 git 或 pull request 裏審查
把代理的分支和你的主分支做 diff,或者開一個 pull request,像審同事的工作那樣審。任何代理、你已經在用的任何工具都可以。
限制是你只看得到結果。你要求的內容留在聊天紀錄裏,所以你是拿 diff 去對記憶裏的那次要求。
做法二:先讓另一個代理審查
自己看之前,叫另一個代理先審這份 diff,例如用 Codex 審 Claude Code 寫的內容。它能抓住明顯的問題,並給你一份該看的位置清單。
這份審查是第二意見,不是簽字放行。diff 仍要你讀,決定也仍是你做。
做法三:用 Coppice,先批准計劃
Coppice 是一套桌面軟件,把程式設計代理放在同一塊工作看板上。寫任何程式之前,代理先寫計劃,由你批准。工作做完後,Coppice 把 diff 放在你批准的計劃旁邊,並標出計劃裏沒有提到的檔案。接受這次工作並不合併。甚麼時候進主分支,由你決定。
- 安裝 Coppice,並加入你的專案。
- 寫一張工單,讓代理開始工作。PM 代理寫出計劃。
- 讀計劃。批准它,或要求修改。
- 工單進入 Wait for Human Review(等待人工審查)之後,審查程式碼。在行上寫評論,或接受這次工作。
- 準備好了再合併。
看起來是這樣。工單要在 Settings 裏加一個深色模式開關。PM 代理的計劃有三步:加上開關、沿用現有的 theme hook、再加一項設定測試。

工作回來之後,已批准的計劃放在 diff 旁邊。有兩處顯眼。新元件自己保存主題狀態,而不是沿用現有的 theme hook;而且只改了一個檔案,所以沒有設定測試。接受之前,這兩處都值得寫一條評論。

核心概念說明工單會經過的每一步。
選哪一種
- 一個代理的小改動: 在 git 或 pull request 裏審查。
- 改動較大,而且你想先有人過一遍: 讓另一個代理看,然後你自己再讀。
- 代理的工作多,而且你想在寫程式之前先就計劃說好: 用 Coppice。由快速上手開始。