SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-16 06:21

技能介绍

用途:对 HEAD 与用户指定固定点之间的差异做双轴代码审查。标准轴判断代码是否符合本仓库已文档化的编码规范;规格轴判断代码是否忠实实现来源 issue、PRD 或规格。两轴由并行子代理运行,避免相互污染上下文,再由本技能汇总结果。

必要用法:需先提供固定点(commit SHA、分支名、tag、main、HEAD~5 等);未指定则询问。先确认固定点可解析(git rev-parse <fixed-point>)且差异非空。差异命令为 git diff <fixed-point>...HEAD(三点,与 merge-base 比较),并用 git log <fixed-point>..HEAD --oneline 记录提交列表。规格来源依次查找:提交信息中的 issue 引用、用户传入的路径、docs/、specs/ 或 .scratch/ 下与分支或特性匹配的 PRD/规格文件;找不到则询问用户,若无规格则跳过规格子代理并标注。若缺失 docs/agents/issue-tracker.md,需先运行 /setup-matt-pocock-skills。标准来源包括仓库中说明代码写法的文件(如 CODING_STANDARDS.md、CONTRIBUTING.md);此外标准轴始终附带一组 Fowler 代码坏味道基线,仓库标准优先,基线均为带标签的判断性提示,且跳过工具已强制检查的内容。

输出:在 ## Standards 与 ## Spec 下分别呈现两份报告,不合并、不重排;结尾给出一行摘要,含每轴发现总数及各自最严重问题。两轴分开是为避免一轴掩盖另一轴。

限制:固定点无效或差异为空应在此阶段失败。规格缺失时规格轴跳过。具体效果与收费等资料暂未提供。