SuperAPI AI 工具集

review

设计与创作

查看项目

更新于 10-16 03:11

技能介绍

用途:对 HEAD 与固定基点之间的 diff 做多轴代码审查。默认基点为 PR 的目标分支,也可由用户显式指定 commit、tag 或 HEAD~5 等。审查范围仅限 diff 中的代码,不含提交信息、PR 标题/描述或分支名。

主要能力:四个轴各自作为独立并行子代理运行,互不污染上下文。Standards 检查代码是否符合仓库文档化规范,并评估规范本身是否合理;Spec 检查代码是否忠实实现来源工单或规格;Architecture 从 /improve-codebase-architecture 视角寻找可深化点;Divergent 判断每个改动在 PR 范围内是否为最优选择。发现项经误报过滤后按轴分别呈现,不跨轴合并或重排。

使用方式:先确定固定基点,有 PR 时用 gh pr view --json baseRefName -q .baseRefName,无 PR 时回退到 gh repo view --json defaultBranchRef -q .defaultBranchRef.name;用户显式指定则原样使用。diff 命令为 git diff <fixed-point>...HEAD,提交列表用 git log <fixed-point>..HEAD --oneline 仅作理解上下文。随后识别规格来源(提交信息中的工单引用、用户传入路径、docs/、specs/ 或 .scratch/ 下的规格文件),找不到则询问,无规格时 Spec 轴跳过并报告。再收集规范来源(CLAUDE.md、AGENTS.md、CONTRIBUTING.md、CONTEXT.md、docs/adr/、STYLE.md、STANDARDS.md 及 eslint.config.*、biome.json、tsconfig.json 等配置)。先做一次分诊:纯外观改动只跑 Standards 与 Spec;明显自动化或无实质改动则跳过;其余或存疑时跑全部四轴。之后并行派发各轴子代理,每个子代理读取自己的 brief 文件。发现项经 FILTER.md 门控过滤误报,正确性轴做独立逐项验证,按文件+行去重。最后按轴标题汇总,并给出一行总结。可选:仅当用户要求时以批量全内联 PR 评论发布,已审查过的 PR 只发增量,跳过已关闭/已合并/草稿 PR。

适用场景:需要从多个独立维度审查代码变更、避免单一视角掩盖问题的开发流程。

限制:具体阈值、评分细则与始终丢弃清单以 FILTER.md 为准;发布评论机制以 COMMENTS.md 为准;资料未提供这些文件的详细内容。