SuperAPI AI 工具集

review

通用与其它

查看项目

更新于 10-16 09:31

技能介绍

用途:审查一个分支、PR、进行中的变更,或按用户指定的基准点审查 diff。审查分两条轴线:规范(代码是否符合本仓库文档化的编码规范)与规格(代码是否忠实实现原始 issue / PRD / 规格)。两条轴线作为并行子 agent 运行,上下文互不污染,最终由本技能汇总双方发现,并在 ## 规范 与 ## 规格 标题下并排报告,不合并、不重排发现项。

主要流程:先确定固定点(commit SHA、分支名、tag、main、HEAD~5 等),若用户未指定则询问基准;用 git diff <fixed-point>...HEAD 捕获 diff(三个点以比较 merge-base),并用 git log <fixed-point>..HEAD --oneline 记录 commit 列表;确认固定点可解析(git rev-parse <fixed-point>)且 diff 非空。再确定规格来源:commit 消息中的 issue 引用、用户传入的路径,或 docs/、specs/、.scratch/ 下匹配的 PRD。然后确定规范来源,常见于 CLAUDE.md、AGENTS.md、CONTRIBUTING.md、CONTEXT.md、docs/adr/ 及 eslint、prettier、tsconfig 等配置;工具已强制执行的内容会跳过。若仓库无文档化规范,使用来自 Fowler《重构》第 3 章的固定气味基线(如神秘命名、重复代码、特性依恋、数据泥团等),均为判断性提示,且已文档化的仓库标准优先。随后并行启动两个 general-purpose 子 agent 分别报告,最后汇总并给出每条轴线的发现总数与最严重单项问题,不跨轴线选最终赢家。

依赖与限制:issue 跟踪器应已提供,若 docs/agents/issue-tracker.md 缺失需运行 /setup-matt-pocock-skills。若找不到规格,规格子 agent 跳过并报告“无可用的规格”。各子 agent 报告限制在 400 字以内。