SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-15 22:15

技能介绍

用途:对 HEAD 与用户指定固定点之间的 diff 做双轴审查。固定点可以是 commit SHA、分支名、标签、main、HEAD~5 等;未指定时需向用户询问。

主要能力:Standards 轴检查代码是否符合本仓库文档化的编码标准,并附带一组固定的 Fowler 代码坏味道基线(如 Mysterious Name、Duplicated Code、Feature Envy、Data Clumps、Primitive Obsession、Repeated Switches、Shotgun Surgery、Divergent Change、Speculative Generality、Message Chains、Middle Man、Refused Bequest)。仓库文档标准优先于基线;基线项始终是判断性提示,不是硬性违规;工具已强制的内容跳过。Spec 轴检查规格要求是否缺失或部分实现、diff 中是否有未被要求的行为(范围蔓延)、以及看似实现但实现有误的要求。两轴作为并行子代理运行,避免上下文互相污染,再由技能汇总结果。

使用方式:先固定基准点,记录 git diff <fixed-point>...HEAD(三点,与 merge-base 比较)及 git log <fixed-point>..HEAD --oneline;用 git rev-parse <fixed-point> 确认引用可解析且 diff 非空。然后按顺序寻找规格来源:提交信息中的 issue 引用(如 #123、Closes #45、GitLab !67)、用户传入的路径、docs/、specs/ 或 .scratch/ 下与分支或功能匹配的规格文件;找不到时询问用户,若确无规格则跳过 Spec 子代理并注明。再搜索仓库中所有记录编码方式的文件,CODING_STANDARDS.md 或 CONTRIBUTING.md 存在时必须纳入。最后并行发起两个子代理并汇总。

输出:分别以 ## Standards 和 ## Spec 标题呈现两份报告,不合并、不重排;结尾给出一行摘要,说明每轴发现总数及各自最严重问题,不跨轴选唯一赢家。

限制:需要已提供 issue 跟踪器,否则提示用户运行 /setup-matt-pocock-skills;规格缺失时 Spec 轴跳过;子代理报告各限 400 词以内。资料未提供具体安装命令、收费或平台信息。