用途
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,轮次预算和扩展需用户批准。
- 具体收费、价格、平台支持等信息暂未提供。