實作指南 / 14 分鐘
把變更轉成可 review 的證據
Coding agent 的 diff、tests 與 review 必須能承受檢查。
Codex 能實作、跑 checks、顯示 working-tree diff 並啟動 dedicated reviewer。Review scope 互斥：uncommitted、base branch、commit 或 custom instructions；reviewer 回報 findings 而不修改 tree。
CLI
已驗證 Terminal Sequence
- ›
/diff - ›
/review - $
codex review --uncommitted - $
codex review --base main - $
codex review --commit <SHA>
A
工作原則
Tests 證明 behavior
要求 focused regression coverage 與 relevant existing checks。
Diff 是 artifact
檢查所有 changed/untracked files，也包含 agent 前既有 edits。
Review 是另一個 lens
實作後用 dedicated reviewer 獨立找 correctness/regression risk。
B
實地程序
- 01
記錄 starting state
先知道哪些 user changes 已存在。
- 02
定義 verification
說明 focused test 與 broader check。
- 03
檢查 /diff
比對 scope，拒絕 unrelated cleanup。
- 04
只選一個 review target
--uncommitted、--base、--commit 不混用。
- 05
刻意處理 findings
確認 evidence、修 real defect、重跑 checks、記錄 residual risk。
PASS / FAIL
驗收清單
- 保留原有 user changes。
- 記錄 focused/broader checks。
- 理解每個 diff hunk。
- Findings 已解決或明確 disposition。
WATCH / REJECT
失敗模式
- 未重現 behavior 就 review。
- Style finding 與 correctness 等量齊觀。
- Fix loop 膨脹成 unrelated refactor。