用途
code-quality-review 是一个代码质量审查技能,适用于三种明确场景:
- 评估收到的代码审查反馈;
- 按用户指定的名称审查特定代码;
- 在宣称任务完成之前,验证完成声明是否有证据支撑。
如果用户要求审查当前改动、未提交工作、暂存/未暂存差异或分支间差异,应改用配套的 changes-review 技能。两个技能共享同一套审查协议,只在入口意图上不同(显式范围/反馈/完成门禁 对比 git diff)。
主要能力
- 报告驱动两阶段审查:先创建审查报告文件(tmp/reports/code-review-{date}-{slug}.md),逐文件审查并增量更新报告,然后重读报告做整体评估,最后汇总最终结论。
- 影响面与风险前置分析:在逐文件审查之前,先用 grep/读取调用方与依赖方评估影响面;可选使用代码图提示(如 .code-graph/graph.db 存在时);检测依赖升级、数据库迁移、事件总线、API 契约、安全、配置、基础设施等高风险变更类型。
- 全链路影响追踪:追踪主要受影响流程在客户端↔服务端以及服务/事件/外部两个边界上的触点,并将每个接缝分类为 NONE/ADDITIVE/BREAKING。
- 项目规范检索:审查前必须检索项目内的编码规范、架构文档、测试约定和设计系统文档,并以代码库既有惯例优先。
- 修复循环:发现项先经验证,再只修复阻断当前轮次的有效发现项,修复后重启完整复审;默认上限 3 轮。第 1 轮要求关闭所有已验证严重级别,从第 2 轮起 CRITICAL/HIGH/MEDIUM 阻断,仅 LOW 可延后。
- 反馈评估与完成门禁:反馈评估使用所提供的证据;完成声明必须有验证证据,禁止表演式认同(如"你说得对!")。
使用方式
该技能以 SKILL.md 形式注册在 .agents/skills/<name>/ 下,调用方式是 $skill-name 加载并执行。执行时要求:按声明顺序执行步骤,不得跳过、重排或合并(除非用户明确批准);每步开始/结束时更新待办状态;每个完成或跳过的步骤都必须附简要证据或明确跳过理由;若 Task 工具不可用,需维护等价的分步计划跟踪器。涉及子代理时,用户调用或 AI 检测到激活即授权使用所需的 spawn_agent 子代理。作为叶子审查者被派发时,只审查指定范围并返回报告,批量调度、验证、修复循环、复审轮次和用户提问属于调用方职责。
适用场景
- 对显式指定的文件集合做系统性代码审查;
- 评估他人提交的审查意见是否成立;
- 在声明工作完成前核验证据;
- 高风险变更(共享契约、多调用方、跨模块/跨服务流程、公共 API)的深度审查。
限制
- 不处理当前 diff、暂存/未暂存差异和分支差异,这类请求应路由到 changes-review。
- 发现项缺少 file:line 证据时不得记录;置信度需超过 80% 才可行动。
- 代码图查询结果可能过时或不完整,只能作为提示,必须通过读取验证。
- 该技能依赖项目内既有文档、计划与实际工具能力;所需能力若确实不可用,需携带步骤/证据停止并向用户提问。
- 资料未提供该技能的收费、价格或平台支持信息。