SuperAPI AI 工具集

codex-review-loop

编程与开发

查看项目

更新于 10-16 06:14

技能介绍

用途:在 Codex 对话中作为会话控制器监督 codex-review-loop。活跃 Codex 会话负责启动包装器、监控、解释,并在需要决策时停下;具体审查与安全修复由新的 worker codex exec 阶段完成。

启动运行:先确认目标仓库与审查范围,在目标 git 仓库根目录操作。默认范围为未提交改动;若用户指定分支、提交区间、功能或文件列表,则通过 --scope 传入。启动前执行预检:git rev-parse --show-toplevel、git status --porcelain=v1、command -v codex-review-loop、command -v codex-review-log。启动需用户明确确认,并报告仓库、范围、工作区状态与确切命令;说明该工具可能通过应用 Bucket I 安全修复来编辑文件,但绝不 stage、commit 或 push。未指定选项时使用 CLI 默认值:最多 5 次迭代、workspace-write、无网络、实时日志。只读审查加 --review-only。

示例命令:codex-review-loop --scope "uncommitted changes";codex-review-loop --scope "HEAD~1..HEAD" --review-only --max-iterations 1;codex-review-loop --scope "current uncommitted changes" --network --model <model>。

监控:轮询运行会话并报告阶段级更新,如审查阶段开始/结束、修复阶段开始/结束、已应用修复、停止状态、Bucket II 决策、校验失败。更新保持简洁。用户询问状态时报告当前阶段、最新可见事件、最近保存的运行目录(若已知)、进程是否仍在运行。用户要求停止时中断进程,再用 codex-review-log show latest --json 检查保存状态,并说明部分运行可能缺少 final-summary.json。不要在回复末尾留下必需命令会话静默运行。

检查已保存运行:优先使用确定性助手命令,如 codex-review-log show latest --json、list、path <run-id|latest>、transcript latest、transcript latest iteration-1-review、events latest、events latest iteration-1-fix --json。按从摘要到细节的方式解释运行 id、目录、最终状态、范围、Bucket I 修复数与校验结果、阶段时间线、Bucket II 决策及其是否阻塞完成、后续检查的原始路径。仅在助手输出不足时查看原始产物:final-summary.json、iteration--review-parsed.json、iteration--fix-parsed.json、.transcript.log、.stderr.log、*.jsonl。

停止与决策:当包装器以 decision_needed、blocked、failed、validation_failed 或 max_iterations_reached 退出时,检查 codex-review-log show latest --json,读取相关阶段的 transcript 或 events,解释证据并区分包装器状态与 worker 阶段状态,提出聚焦问题;除非用户明确要求,否则不自动重跑、自动恢复或实现 Bucket II 项。

限制与说明:允许初始工作区有改动,因为默认范围是未提交改动;运行日志写入 .git/codex-review-loop/;包装器使用全新 codex exec 轮次,活跃会话是监督者而非 worker;默认只应用 Bucket I 安全修复,绝不 stage、commit、push;某阶段可成功而包装器随后因 Bucket II 需决策、校验失败或达迭代上限而停止;缺少 .git/codex-review-loop/ 表示该仓库无保存运行;缺少 final-summary.json 通常表示包装器在最终报告路径前退出或被中断。