用途:在 Codex 会话中扮演监督者角色,启动并监控 codex-plan-loop 包装器;真正的进度推进与审查由全新的 codex exec 阶段完成,当前会话负责启动、监控、解释并停在需要人工决策处。
主要能力:启动运行前做预检并确认目标仓库与计划文件;支持用用户指定的选项运行,如 codex-plan-loop <plan-file> --max-cycles 1 --network --model <model>;默认最多 20 个循环、workspace-write、无网络、审查上限 5、实时日志;监控阶段级事件(progress 与 review 的开始/结束、提交、停止状态、Bucket II 决策、验证失败);用 codex-plan-log 系列命令检查已保存的运行。
使用方式:需从目标 git 仓库根目录操作,先执行 git rev-parse --show-toplevel、git status --porcelain=v1、command -v codex-plan-loop、command -v codex-plan-log、test -f <plan-file> 等预检,并在启动前获得明确确认;在长驻终端中运行 codex-plan-loop <plan-file>。查看运行可用 codex-plan-log show latest --json、list、path、transcript、events 等命令,先看摘要再看原始文件。
适用场景:需要人工监督的自动化编码计划执行、按阶段审查与提交、以及在阻塞或需决策时交由用户判断的场景。
限制:启动要求工作区干净,运行日志写入 .git/codex-plan-loop/;包装器退出为 blocked、decision_needed、failed 或 validation_failed 时需检查证据并询问用户,不应自动重跑或实现 Bucket II 项;部分运行可能缺少 final-summary.json;缺少 .git/codex-plan-loop/ 表示该仓库未保存过运行记录。