用途:对实现方案做两幕式加固。第一幕(你与 Claude)以逐条提问方式逼问方案细节,核对并同步维护项目文档;第二幕把锁定后的方案交给 Codex 做对抗式评审。
主要能力:第一幕沿设计树逐支追问,每个问题给出推荐答案,一次只问一个;先查代码库再提问;对照 CONTEXT.md 术语表挑战用词、把模糊说法收敛为规范术语、用具体场景压测边界、并与代码交叉核对,发现矛盾即指出。术语确定时即时更新 CONTEXT.md,该文件仅作术语表,不放实现细节。仅在难以逆转、缺少上下文会令人困惑、且源于真实取舍三者同时成立时才建议创建 ADR。
第二幕:将 PLAN.md 交给 Codex 评审,使用 PLAN-REVIEW-LOG.md 记录过程;每轮读取评审意见并追加记录,直到 VERDICT: APPROVED 或达到 MAX_ROUNDS(默认 5)为止;由 Claude 作为最终裁决者决定是否采纳修订。
用法要点:方案确认后写入 PLAN.md,再初始化 PLAN-REVIEW-LOG.md。Codex 需 codex --version ≥ 0.130 且已登录;不要固定 -m。首轮用 codex exec -s read-only --json -o /tmp/codex-verdict.txt,后续轮次用 resume 且通过 -c sandbox_mode="read-only" 保持只读(resume 不接受 -s)。
限制:全程 Codex 只读,不得改文件;第二幕不评审已写好的代码;Claude 与 Codex 均不得在第一、二幕中写代码,需用户签字确认后才实施;循环必在 MAX_ROUNDS 终止,不伪造收敛。