SuperAPI AI 工具集

review-loop

测试与质量

查看项目

更新于 10-28 16:13

技能介绍

用途

review-loop 用于对代码变更获取跨模型的第二意见。它把审查工作交给另一家厂商的模型作为“对侧”(Claude 运行时用 Codex,Codex 运行时用 Claude Opus),以弥补编写变更的模型自身的盲点。适用对象包括 diff、分支、PR、提交范围、文件集合,以及计划或规格文档。该技能只做协调:验证、合并、报告和修复,不自行新增发现。

主要能力

  • 固定审查目标:解析 PR、分支、提交范围、文件集、计划/规格或工作区变更,读取意图与仓库标准文档,并按需调用 /principles 选定适用原则。
  • 生成代码审查包:通过脚本从技能目录构建数据包,可指定 base、since、head 或 working,固定不可变修订并快照工作区变更,列出锁文件、二进制及生成/第三方文件但排除在 diff 之外;以 diff 大小作为基线。
  • 双模型审查:第一轮为全量审查,对侧模型优先异步派发;当对侧为 Codex 且 diff 涉及可运行代码时,并行派发 Codex 正确性检查;同模型并行运行 /code-review(标准与规格两个轴)与 /thermo-nuclear-review 正确性与安全审查。计划目标仅由对侧审查。
  • 验证与合并:逐条对照代码核实发现,剔除不成立项并附一句理由;按根因分组编号,记录提出者、严重度与处理决定(fix、follow-up、skip)。
  • 报告:以轮次、结论和审查者计数开头,按严重度列出每条发现,附路径行号、提出者和处理决定,并提供折叠的检查证据与丢弃理由。
  • 修复与复审:在所属分支上应用修复并运行针对性检查,获授权时逐条提交;按基线比较增量大小,必要时裁剪无必要新增代码;下一轮仅由对侧做增量复审,只报告新增或仍未关闭的问题。

使用方式

在实现工作流(如 /implement、/implement-spec 或 Pstack playbook)中,循环会在轮次间自动应用修复并复审。独立审查请求先报告第一轮并等待,用户确认后再运行完整循环。公开评论、合并和 PR 状态变更仍需各自授权。代码目标通过 node scripts/packet.ts --repo <repo> 并配合 --base、--since、--head 或 --working 构建审查包(Bun 也可运行)。循环在结论为 Clean、达到三轮上限或出现需要用户决策的发现时停止,结束时删除审查包目录。

适用场景

适合需要跨模型交叉验证的代码审查、实现后的最终审查、计划评审,以及“审查—修复—再审查”直到干净的迭代流程。

限制

跨模型审查依赖 /swarm 的对侧路由;对侧审查失败后若重试与回退均未返回,则本轮记为单模型并注明原因。codex 正确性检查失败记为缺口,本轮继续。同一模型审查与 Codex 正确性检查仅在第一轮运行。若某轮重复出现此前已修复的同类发现,需先调用 /principle-attack-the-premise。超过三轮未达 Clean 时,未关闭发现交由用户处理;自动化运行中将其置于 PR 描述顶部并标记分支未验证。