SuperAPI AI 工具集

review-loop

编程与开发

查看项目

更新于 11-15 07:45

技能介绍

评审循环(review-loop)是一个面向多角色协作的 Skill,用于执行“先方案评审、再编码评审”的两阶段工作流。

用途 它适用于用户要求评审循环、自评审工作流,或 planner/reviewer/coder/code-reviewer 协作、先方案后编码、多轮 Agent 评审,以及需要稳定的子 Agent 工作流依次产出方案、等待用户确认、实现代码、评审差异并保留修订记录的场景。

主要能力与流程 工作流分为两个阶段。方案循环中,planner 编写或修订 plan.md,plan-reviewer 对其进行评审。代码循环在用户确认方案后启动:coder 实施已确认方案,code-reviewer 评审产生的差异。

该工作流必须使用真实的 planner、reviewer 和 coder 子 Agent。如果当前环境无法创建新的原生子 Agent,应停止并告知用户本次会话无法运行 review-loop。Codex 和 Claude Code 的四个角色都使用宿主原生子 Agent。

使用方式 开始任务前,需要读取 references/protocol.md、references/state-machine.md 和 references/role-contracts.md,并根据当前平台读取 references/codex.md 或 references/claude-code.md;创建任务 ID;运行 scripts/init-workspace.js 创建 .agent-workflows/review-loop/<task-id>/;运行 scripts/prepare-agent-roles.js 准备当前平台的真实子 Agent 角色;在推进流程前运行 scripts/validate-state.js。maxRounds 默认为 3,用户指定最大循环轮数时传给 init-workspace.js。

在 Codex 或 Claude Code 中,运行 scripts/review-manager.js --prepare,将返回的仅含路径的提示词交给新的原生 reviewer 子 Agent,把其唯一纯 Markdown 响应保存到仓库外的临时文件,再运行 scripts/review-manager.js --finalize --input <file> --agent-id <id>。Prepare 会绑定全部输入和 Git 树,finalize 会拒绝漂移、直接校验 Markdown、写入不可变的 reviewer-run 并将规范评审保存为 reviews/*-review-N.md;不得直接调用 scripts/persist-review-markdown.js。后续只读复验使用 scripts/validate-review-markdown.js。每轮代码实现和验证完成后直接执行 coder-complete。Prepare 会把初始基线到绑定工作树的完整 diff 写入 diffs/code-diff-N.patch,作为代码 reviewer 与人工共同使用的评审交接产物。

强制规则与限制 在方案循环结束且用户明确确认方案前,不得实现代码。所有面向用户或需要用户确认的自然语言中间产物必须使用中文。不得让 reviewer 修改仓库文件,其只返回固定格式的 Markdown 文档,由编排者通过 --finalize 解析、保存并校验。plan-reviewer 和 code-reviewer 每轮必须创建全新、独立的原生子 Agent 实例,不得恢复或复用之前轮次的 reviewer,也不得继承父级会话、planner 或 coder 的上下文;planner 和 coder 可跨轮复用各自实例,但不得相互复用。不得生成、传递或记录相邻代码轮次间的增量 patch,code-diff-N.patch 始终表示初始基线到当前评审版本的差异。所有状态转换都使用 scripts/advance-state.js,不得手动编辑 state.json。reviewer 返回 approved 或循环达到 maxRounds 时停止当前循环;因达到 maxRounds 停止时用中文汇总剩余问题并询问用户要继续、接受还是修订。确认节点等待期间若已评审的方案或代码变化,优先开启新一轮评审,只有用户当前消息明确接受变化才可覆盖。只能在 max_rounds_reached 确认节点增加 maxRounds。