SuperAPI AI 工具集

cto-review

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:对单个 PR 进行 CTO 级战略审查,把关键判断(整体 diff 审查)放在干净的隔离上下文中执行。仅用于 PR 审查,没有心跳模式。

主要能力:三阶段顺序 ICM 程序。01-setup 以子代理运行,获取仓库上下文、PR 元数据、完整 diff 和合并状态,若 PR 为 CLOSED 未合并则短路。02-review 以子代理运行,在隔离上下文中对整体 diff 做一次连贯审查,覆盖文档缺口、外部依赖、下游/模板影响、正确性、安全、合并策略与行动项,产出结论、清单和行动项。03-synthesize-act 内联运行,发布 GitHub 评论、应用结论标签、按合并状态合并或标记、写报告文件并输出结果标记。

使用方式:位置参数解析 $ARGUMENTS,第一个 token 为 PR 编号,第二个为 org/repo,例如 /cto-review 742 fellowship-dev/booster-pack。交接文件位于 .procedure-output/cto-review/{stage}/handoff.md,01 写 setup,02 只读 setup 交接,03 读两者。阶段 01 与 02 各启动一个 Task,只传参数与对应 CONTEXT.md 路径,不传编排器历史。

限制与硬性规则:必须顺序执行,一次一个子代理,禁止并行 Task。02 是隔离判断步骤,只接收 setup 交接与自身 CONTEXT.md。整体 diff 只在一个连贯阶段审查,不按文件或维度拆分。03 必须内联运行,GitHub 副作用与 [pylot] outcome=... 标记必须来自编排器。每个阶段先写 handoff.md 再被下一阶段读取。除 CLOSED 未合并短路外不得跳过阶段。遵守合并状态:绝不合并 CLOSED PR;已合并 PR 只发合并后备注,不尝试合并。CI 为红时绝不合并,即使结论为 LGTM。无 Quest,报告仅写本地报告文件。

退出路径:成功时 03 输出 outcome="cto-review PR #{N} complete — verdict={verdict}, action={merged|labeled}" status=success;失败时输出 outcome="cto-review failed at stage NN: {reason}" status=failed;被阻止时输出 outcome="cto-review skipped: PR #{N} closed without merge" status=blocked。

参考文件包括 CONTEXT.md、shared/review-comment-format.md、shared/report-format.md 以及各阶段 CONTEXT.md。