SuperAPI AI 工具集

review

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

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

主要能力与流程:

  1. 固定基准点:用户给出的提交 SHA、分支名、标签、main、HEAD~5 等原样使用;未指定则询问“Review against what — a branch, a commit, or main?”,未得到前不继续。记录 diff 命令 git diff <fixed-point>...HEAD(三点,与 merge-base 比较),并用 git log <fixed-point>..HEAD --oneline 记录提交列表。
  2. 识别规格来源:按顺序查找提交信息中的 issue 引用(#123、Closes #45、GitLab !67 等,经 docs/agents/issue-tracker.md 的工作流获取)、用户作为参数传入的路径、docs/、specs/ 或 .scratch/ 下与分支名或功能匹配的 PRD/规格文件。找不到则询问用户;若用户表示没有,Spec 子代理跳过并报告“no spec available”。
  3. 识别规范来源:仓库中记录代码应如何编写的文件,常见位置包括 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 等。机器强制执行的规范只记录,不重复检查工具已检查的内容。
  4. 并行启动两个子代理:单条消息中发起两个 Agent 工具调用,均使用 general-purpose 子代理。Standards 子代理读取规范文档与 diff,按文件/hunk 报告违反文档化规范之处,引用规范(文件+规则),区分硬性违规与判断性取舍,跳过工具强制项,400 词以内。Spec 子代理读取规格与 diff,报告规格要求但缺失或部分实现的需求、diff 中未被要求的行为(范围蔓延)、看似实现但实现有误的需求,每条发现引用规格原文,400 词以内。
  5. 汇总:在 ## Standards 与 ## Spec 标题下分别呈现两份报告,可原样或轻度清理,不合并、不重排发现,两轴刻意分开以便独立查看。最后一行总结每轴发现总数及最严重问题(如有)。

适用场景:需要同时从规范符合度与规格实现度两个维度审查代码变更时。

限制:需要用户提供固定点;规格缺失时 Spec 轴跳过;依赖 docs/agents/issue-tracker.md 获取 issue,若缺失需运行 /setup-matt-pocock-skills;两轴报告各限 400 词以内。其他收费、平台等信息暂未提供。