SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-16 06:20

技能介绍

用途:对 HEAD 与用户指定固定点(commit SHA、分支、标签、main、HEAD~5 等)之间的 diff 做双轴审查。标准轴检查代码是否符合本仓库文档化的编码规范;规格轴检查代码是否忠实实现原始 issue/规格。两轴由并行子代理运行,避免上下文互相污染,最后汇总结果。

主要能力:固定点解析与 diff 捕获(git diff <fixed-point>...HEAD 三点比较,配合 git log <fixed-point>..HEAD --oneline);规格来源识别(提交信息中的 issue 引用、用户传入路径、docs/、specs/、.scratch/ 下的规格文件);标准来源加载(调用 /project-context,加载 diff 涉及的每个领域及 glossary.md);内置 Fowler 代码坏味道基线(Mysterious Name、Duplicated Code、Feature Envy、Data Clumps、Primitive Obsession、Repeated Switches、Shotgun Surgery、Divergent Change、Speculative Generality、Message Chains、Middle Man、Refused Bequest),仓库文档标准优先于基线,基线项一律为判断性提示而非硬性违规,工具已强制的内容跳过。

使用方式:先确定固定点,未指定则询问;确认固定点可解析且 diff 非空;再定位规格来源,找不到则询问,用户确认无规格时规格轴跳过并报告「no spec available」;随后加载 /project-context 标准,若该技能缺失需提示用户运行 /setup-project-context;最后并行启动两个子代理,各自输出不超过 400 字的报告,汇总时按 ## Standards 与 ## Spec 分列,不合并、不重排,末尾给出一行总结(各轴发现总数与各轴最严重问题),不跨轴选唯一赢家。

适用场景:需要同时验证「是否合规」与「是否做对」的代码审查,尤其是变更可能通过一轴而失败另一轴的情况。

限制:规格缺失时规格轴无法运行;标准轴依赖 /project-context,缺失时只能使用通用基线;CONTRIBUTING.md 仅作定位参考,不作为标准来源;具体安装命令、收费与平台信息暂未提供。