SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 11-05 16:54

技能介绍

用途:该技能面向 Spec Kit 的代码变更审查场景,在查看差异(diff)或拉取请求时使用。其目标不是修改代码,而是验证变更是否具备应有的测试覆盖、设计一致性与术语一致性。不适合用于实现变更或执行 GitHub 上的审查发布动作。

主要能力:

  1. 测试覆盖核查:确保每项变更都有测试用例,既验证代码应有的行为,也验证代码应防止的行为,即正向与负向测试。
  2. 回归证据核查:对于错误修复类拉取请求,要求包含回归测试,证明错误在变更前可复现、变更后已修复;若审查者无法执行比对,应使用可用证据并说明该限制。
  3. 术语一致性核查:用词变更需与仓库术语保持一致;社群撰写的型录内容及其产生的文档不在检查范围内。
  4. 设计一致性核查:先识别受影响的领域,再阅读 design/ 中适用的文档;例如 CLI 命令变更对应 design/cli.md,代理整合对应 design/integration.md,工作流程步骤类型对应 design/workflow-step.md。按相关性阅读其他设计文档,不必为每个 PR 阅读全部文档。对照设计要求检查实现边界、所有权、生命周期与交付要求,并引用文档与章节而非在本技能中重复规则。
  5. 区分违规与有意变更:区分未声明的设计违规与有意的设计变更;对有意变更评估其理由与证据,仅更新设计文档本身不足以证明实现正当。

使用方式:在审查差异或拉取请求时调用该技能,按其检查项逐条评估变更,并对每项报告的不一致注明对应文档与章节。

适用场景:Spec Kit 项目的代码变更审查、拉取请求评审、错误修复回归验证、设计与术语一致性检查。

限制:不用于实现变更,不用于发布 GitHub 审查动作;社群型录内容及其生成的文档不在术语检查范围内;审查者无法执行比对时只能依据现有证据并说明限制。