SuperAPI AI 工具集

review

编程与开发

查看项目

更新于 10-15 21:08

技能介绍

用途:对 HEAD 与用户指定固定点之间的 diff 做双轴审查。规范轴检查代码是否符合仓库文档化的编码规范;规格轴检查代码是否忠实实现原始 issue、PRD 或规格。两条轴线作为并行子 agent 运行,互不污染上下文,再由本技能汇总发现项。

主要能力:确定固定点并捕获 diff 命令 git diff <fixed-point>...HEAD(三个点,比较 merge-base),同时用 git log <fixed-point>..HEAD --oneline 记录 commit 列表;按顺序查找规格来源(commit 消息中的 issue 引用、用户传入路径、docs/、specs/ 或 .scratch/ 下匹配的 PRD/规格文件);收集规范来源(CLAUDE.md、AGENTS.md、CONTRIBUTING.md、CONTEXT.md、docs/adr/、.editorconfig、eslint.config.、biome.json、prettier.config.、tsconfig.json、STYLE.md 等);并行启动两个 general-purpose 子 agent 分别审查规范与规格;最后在 ## 规范 和 ## 规格 标题下并排呈现两份报告,不合并或重新排序,并附一行总结。

使用方式:用户指定固定点(commit SHA、分支名、tag、main、HEAD~5 等);若未指定则询问以什么为基准。规格来源缺失时询问用户,若用户说没有则跳过规格子 agent 并注明“无可用的规格”。若 docs/agents/issue-tracker.md 缺失,需运行 /setup-matt-pocock-skills。

适用场景:审查分支、PR、进行中的变更,或要求从某固定点开始审查。

限制:规范子 agent 跳过工具已强制执行的内容;规格缺失时规格轴无法执行;两条轴线刻意分开报告,不合并发现项。