SuperAPI AI 工具集

review

测试与质量

查看项目

更新于 10-24 16:19

技能介绍

用途

该技能用于在合并工作前对代码差异进行双轴审查,帮助发现两类问题:代码是否违反仓库既定的编码规范,以及代码是否忠实实现了原始 issue、PRD 或规格说明。

主要能力

  • 双轴并行审查:规范轴检查差异是否符合仓库文档化的编码标准;规格轴检查差异是否实现了来源需求。两个子代理并行运行,各自上下文互不污染,最终由主技能汇总。
  • 固定点对比:以用户指定的提交 SHA、分支名、标签、main、HEAD~5 等作为固定点,用 git diff <fixed-point>...HEAD(三点比较,基于 merge-base)获取差异,并用 git log <fixed-point>..HEAD --oneline 获取提交列表。
  • 规格源识别:依次从提交信息中的 issue 引用(如 #123、Closes #45、GitLab !67 等,需配合 docs/agents/issue-tracker.md 工作流)、用户传入的路径、docs/、specs/、.scratch/ 下匹配分支名或功能的 PRD/规格文件中查找。找不到时询问用户;若无规格则跳过规格轴并注明。
  • 规范源识别:收集仓库中记录编码方式的文件,如 CLAUDE.md、AGENTS.md、CONTRIBUTING.md、CONTEXT.md、CONTEXT-MAP.md、各上下文的 CONTEXT.md、docs/adr/、.editorconfig、eslint.config.、biome.json、prettier.config.、tsconfig.json,以及根目录或 docs/ 下的 STYLE.md、STANDARDS.md、STYLEGUIDE.md 等;工具已强制检查的内容不重复检查。
  • 结果汇总:在 ## Standards 和 ## Spec 两个标题下分别呈现两份报告,不合并、不重新排序,最后给出一行总结,包括每轴发现数量及最严重问题(如有)。

使用方式

  1. 确认固定点;未指定时主动询问。
  2. 记录 diff 命令与提交列表。
  3. 按顺序识别规格源与规范源文件列表。
  4. 用单条消息发起两个 Agent 工具调用(均使用 general-purpose 子代理),分别附带差异命令、提交列表及对应源文件,要求各在 400 字以内报告发现。
  5. 汇总呈现两份报告并附一行总结。

依赖提示:若 docs/agents/issue-tracker.md 缺失,需运行 /setup-matt-pocock-skills。

适用场景

  • 合并前的架构或代码质量审查。
  • 需要分别评估「是否符合规范」与「是否实现需求」的场景,避免一个维度掩盖另一个维度。

限制

  • 必须提供固定点,否则不继续。
  • 规格源缺失时规格轴无法执行,仅作说明。
  • 审查基于仓库中实际存在的规范文档与规格文件;资料未提供其他自动化检查或强制执行能力。