SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-16 07:24

技能介绍

用途:对 HEAD 与用户提供的固定点之间的 diff 做双轴审查。标准轴检查代码是否符合仓库文档化的编码规范;规格轴检查代码是否忠实实现来源 issue/规格。两轴由并行子代理运行,避免相互污染上下文,再由本技能汇总结果。

主要能力:固定点可为 commit SHA、分支名、标签、main、HEAD~5 等;若用户未指定需询问。使用 git diff <fixed-point>...HEAD(三点,与 merge-base 比较)并记录 git log <fixed-point>..HEAD --oneline。先确认固定点可解析(git rev-parse <fixed-point>)且 diff 非空。规格来源按顺序查找:提交信息中的 issue 引用(#123、Closes #45、GitLab !67 等,经 docs/agents/issue-tracker.md 工作流获取)、用户传入路径、docs/、specs/ 或 .scratch/ 下匹配分支名或功能的规格文件;找不到则询问,若确无规格则跳过规格子代理并报告“no spec available”。标准来源包括 CODING_STANDARDS.md、CONTRIBUTING.md 等仓库文档,并始终附带 Fowler 代码坏味道基线(《重构》第 3 章),仓库文档优先于基线,基线项均为判断性提示而非硬性违规,工具已强制的内容跳过。

使用方式:需先提供 issue tracker;若 docs/agents/issue-tracker.md 缺失,提示用户运行 /setup-matt-pocock-skills。随后并行启动两个子代理,标准子代理提示需包含 diff 命令、提交列表、标准来源文件及完整坏味道基线;规格子代理提示需包含 diff 命令、提交列表及规格路径或内容。最后在 ## Standards 与 ## Spec 标题下原样或轻度清理呈现两份报告,不合并、不重排,末尾给出一行总结:每轴发现总数及各轴最严重问题,不跨轴选唯一赢家。

适用场景:需要同时评估代码规范符合度与规格实现忠实度的代码审查。

限制:两轴刻意分离,不合并或重排发现;基线坏味道始终为判断性提示;规格缺失时规格轴跳过;未提供固定点需询问;未提供 issue tracker 需先运行指定命令。