SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-15 20:08

技能介绍

用途:对 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 非空,坏引用或空 diff 应在此处失败。规格来源按顺序查找:提交信息中的 issue 引用(#123、Closes #45、GitLab !67 等,经 docs/agents/issue-tracker.md 工作流获取)、用户作为参数传入的路径、docs/、specs/ 或 .scratch/ 下匹配分支名或功能的规格文件;找不到则询问用户,若用户说没有,规格子代理跳过并报告“no spec available”。标准来源为仓库中记录代码写法的文件,如 CODING_STANDARDS.md 或 CONTRIBUTING.md;此外标准轴始终携带 Fowler 代码坏味道基线(Refactoring 第 3 章),仓库文档标准优先于基线,基线项均为带标签的启发式判断(如“possible Feature Envy”),非硬性违规,工具已强制的内容跳过。

使用方式:若 docs/agents/issue-tracker.md 缺失,提示用户运行 /setup-matt-pocock-skills。并行启动两个子代理:标准子代理提示包含完整 diff 命令与提交列表、找到的标准来源文件列表及完整坏味道基线,要求按文件/hunk 报告违反文档标准之处(引用标准文件与规则)及发现的基线坏味道(命名并引用 hunk),区分硬违规与判断项,400 词以内;规格子代理提示包含 diff 命令与提交列表、规格路径或内容,报告规格要求缺失或部分实现、diff 中未被要求的行为(范围蔓延)、看似实现但实现有误的要求,每条引用规格行,400 词以内。汇总时在 ## Standards 与 ## Spec 标题下分别呈现两份报告,不合并、不重排,最后给出一行总结:每轴发现总数及各自最严重问题,不跨轴选唯一赢家。

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

限制:规格缺失时规格轴跳过;基线坏味道始终为判断项;仓库文档标准覆盖基线;工具已强制的内容跳过;固定点必须可解析且 diff 非空。其他收费、平台等信息暂未提供。