SuperAPI AI 工具集

changes-review

编程与开发

查看项目

更新于 11-06 09:11

技能介绍

用途

changes-review 是一个代码变更审查技能,用于对指定的代码差异进行聚焦审查。其目标是发现所请求差异中的真实缺陷,并在被要求时收敛修复,同时不损失覆盖范围或质量。

主要能力

  • 支持多种审查范围:暂存变更、未暂存变更、命名文件、当前分支/PR 差异、历史提交及显式提交范围。
  • 默认范围为当前工作区变更,包括 git status、git diff、git diff --cached 及相关未跟踪文件。
  • 对每个变更文件进行分诊并编写简短计划,创建审查任务。
  • 检查正确性、成功/错误路径、空值/边界状态、资源清理、异步/并发问题,并追踪调用方与契约。
  • 强制对完整审查目标调用 $why-review 进行整体理由审查,即使没有发现也要执行。
  • 当变更涉及数据访问、热路径、缓存、并发、批处理吞吐或渲染密集 UI 时,运行 $performance-review。
  • 当变更涉及集成测试或性能测试质量时,调用相应的审查模式。
  • 支持仅审查模式(默认)和 --fix-loop 修复循环模式。
  • 支持 --loop-owner=caller 将只读审查结果返回给修复协调者。
  • 支持 --defer 将特定职责委派给命名调用方。

使用方式

该技能通过技能调用机制触发。在 Codex 兼容环境中,通过 $skill-name 调用,加载注册的 .agents/skills/<name>/SKILL.md 并执行。当工作流步骤或用户要求聚焦的代码变更审查时使用。默认执行仅审查,返回验证后的报告而不修改源码;使用 --fix-loop 启用共享的三轮修复循环。审查前需创建任务,跟踪分诊、审查、验证、修复、重新审查和最终检查,保持一个任务进行中并在完成时附上证据。

适用场景

  • 对暂存、未暂存、分支差异或简单拉取请求进行代码审查。
  • 需要结构化、可验证的审查流程,包括整体理由审查和适用专家审查。
  • 需要在审查后收敛修复并重新审查的场景。
  • 涉及数据访问、性能、集成测试、性能测试、领域实体质量等特定关注点的变更。

限制

  • 历史评估仅为审查模式:修复当前文件需要商定的当前目标,无法使不可变的历史差异收敛。
  • 历史 PR 成员关系不能从当前分支成员关系推断;已合并或压缩的 PR 需要显式提交或验证范围。
  • 必需检查无法运行时保持不可用状态,绝不标记为 PASS。
  • 修复循环遵循 review-policy,轮次预算和扩展需用户批准。
  • 具体收费、价格、平台支持等信息暂未提供。