用途:检查并解释已保存的 codex-plan-loop 自动化运行记录,回答“这次运行发生了什么、为什么停止、各阶段进展如何”等问题。
主要能力:先用确定性的 codex-plan-log 辅助命令获取摘要,再按需读取原始产物。可查看最新或历史运行、运行路径、阶段状态、停止原因、计划摘要、Bucket II 数量、进度阶段、审查轮次、验证结果与已应用修复,并区分包装层状态与内部 Codex 阶段状态。
使用方式:先确认当前目录是目标 git 仓库,若用户指定其他仓库则切换,路径不明确时询问。常用命令包括 codex-plan-log show latest --json、codex-plan-log list、codex-plan-log path <run-id|latest>,以及 codex-plan-log transcript latest、codex-plan-log events latest 等事件级查询。原始产物包括 final-summary.json、cycle--progress-parsed.json、cycle--review--parsed.json、.transcript.log、*.stderr.log 和 *.jsonl。回答时应引用支持结论的文件路径或阶段名,并保持 JSONL 摘录简短。
适用场景:排查运行停止原因、核对审查与验证结果、追踪 Bucket II 阻塞项、定位具体阶段产物。
限制:辅助命令为只读,除非用户明确要求清理,否则不要编辑或删除已保存的运行目录。缺少 .git/codex-plan-loop/ 表示该仓库没有保存包装运行;缺少 final-summary.json 通常表示包装在最终报告前退出。阶段成功不代表整体成功,包装可能因审查发现阻塞 Bucket II、验证失败或达到审查上限而停止。codex-plan-loop 使用全新的 codex exec 轮次,transcript.log 是可读自动化记录,jsonl 是原始事件流。