SuperAPI AI 工具集

loop-review-fold

通用与其它

查看项目

更新于 10-15 21:56

技能介绍

用途:该技能是一个路由器,而非新的审查或修复实现。它在 execute-phase 打开单元 PR 之后使用,或用于对打开中的功能/修复单元执行审查与折叠。它读取 review-change 与 fold-findings 留下的持久证据,选择下一动作,并在需要用户决策或人工阶段执行时停止。不允许合并、创建无关 issue 或静默丢弃发现。

主要能力:按“当前 HEAD 上的持久状态”做首次动作匹配——若存在精确当前 REVIEW-PASS、验收匹配且无未关闭发现行,则返回 PASS;若存在针对该 HEAD 的审查结果且仍有折叠未完成行,则运行 fold-findings;若无可用的当前审查结果且无打开队列,则对当前 HEAD 运行 review-change。若 review-change 返回 REVIEW-PASS,验证精确 HEAD 回执与零打开行后返回 PASS;若返回发现,则对每个 fix-now 行运行 fold-findings,且不得在队列处理前再次审查。fold-findings 推送新 HEAD 后,需对新 HEAD 再次运行 review-change,绝不对未变化的 HEAD 二次审查。

使用方式:/loop-review-fold <NN> 用于功能单元;/loop-review-fold --fix <issue-number> 用于修复单元。第 0 步始终先发现项目,读取目标项目的 agent 指南与文档映射,验证单元、分支、PR、远端 HEAD、冻结验收产物、最新 review-change 结果/回执以及 review-findings.md。若无法验证目标、PR、验收或台账,则以 BLOCKED 停止并指明缺失输入与恢复命令,不创建替代产物。若发现未解决(DISPUTED、BLOCKED、REPLAN 或折叠后仍有打开行),停止循环并将每个此类 ID 交给 /triage-issue --prioritize-now。triage-issue 可把小型修正路由回当前单元,但不得隐藏、降级或推迟审查发现。当最小正确修正超出当前折叠时,triage-issue 必须选择重规划路由:重新运行 /plan-feature 或 /plan-fix,向 SPEC 追加明确的 P<n> 阶段并停止,由用户手动执行新阶段后再调用本循环。

输出契约:返回 REVIEW-FOLD LOOP — PASS | TRIAGE-REQUIRED | BLOCKED,并列出 Unit、PR、HEAD、First action、Review、Fold、Unresolved、Evidence 以及 → Next 的下一命令。需要 triage-issue、重规划或用户决策时使用 TRIAGE-REQUIRED。

限制:本路由器禁止实现修复、编辑审查分类、标记发现已折叠、创建无关 issue、削弱验收或检查、合并,或声称用户已实现新规划阶段。没有隐藏重试计数;循环在首次 PASS、阻塞的前置条件、未解决发现或需要人工重规划时结束。在非 Claude Code 的 agent 中,若无可用的新上下文或子代理,需在新对话中调用各委托技能,并重新读取持久 HEAD、回执与台账;若宿主无斜杠命令菜单,需打开每个具名 SKILL.md 并照其字面执行,绝不在同一上下文实现修正后声称审查干净。