SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 11-07 16:46

技能介绍

该技能用于对代码变更进行双轴审查。用户需提供一个固定点(如 commit SHA、分支名、标签、main、HEAD~5 等),技能会捕获 git diff <fixed-point>...HEAD(三点比较,基于 merge-base)和 git log <fixed-point>..HEAD --oneline,并先确认固定点可解析、diff 非空。

用途:从两个独立维度审查代码变更——标准轴判断代码是否符合仓库文档化的编码规范;规格轴判断代码是否忠实实现来源 issue 或规格。

主要能力:标准轴会搜索仓库中所有记录代码写法的文件(如 CODING_STANDARDS.md、CONTRIBUTING.md 必须包含),并在仓库无文档时使用固定的 Fowler 代码坏味道基线(包括神秘命名、重复代码、依恋情结、数据泥团、基本类型偏执、重复 switch、散弹式修改、发散式变化、夸夸其谈通用性、过长的消息链、中间人、被拒绝的遗赠等),每个坏味道均为启发式判断,且仓库文档标准优先于基线,工具已强制的内容跳过。规格轴寻找来源规格:优先从 commit 消息中的 issue 引用获取,其次用户传入的路径,再找 docs/、specs/、.scratch/ 下与分支名或功能匹配的规格文件;若找不到则询问用户,用户表示没有规格时规格子智能体跳过并报告“无可用规格”。

使用方式:用户指定固定点后,技能确认 diff 非空,识别规格来源和标准来源,然后并行启动两个子智能体(各自使用全新上下文),标准子智能体按文件/hunk 报告违反文档标准之处(引用标准文件和规则)及发现的基线坏味道(引用 hunk),区分硬性违规与判断性意见;规格子智能体报告规格要求中缺失或部分实现的内容、diff 中未被要求的行为(范围蔓延)、以及看起来已实现但实现有误的要求,每条发现引用规格行。最后在 ## Standards 和 ## Spec 标题下分别展示两份报告(原文或稍作清理),不合并或重新排序,并以一行总结每轴发现总数及各自最严重问题。

适用场景:需要对一个分支或提交区间进行规范性审查和规格符合性审查的代码评审流程,尤其适合有文档化编码标准或来源 issue 的项目。

限制:必须由用户提供固定点;若规格缺失则规格轴跳过;标准轴依赖仓库文档和固定的坏味道基线;子智能体报告字数限制在 400 字以内;不跨轴选择单一最严重问题。若 issue tracker 未提供,需用户运行 /setup-matt-pocock-skills。