---
name: quality-code-review
description: 执行与候选版本绑定的语义代码评审，覆盖规格一致性、架构、安全、性能、可靠性、可观测性和可维护性。开发、设计实现一致性修复、提交前、合并请求或专项审计中出现实现风险时使用；受影响代码或约束契约变化后重跑。
metadata:
  version: 1.1.17
---

# 代码质量评审

> **领导速读：** 对照设计和风险检查候选代码的正确性、安全、可靠性和可维护性。

## 一、管理视角

- **何时使用：** 实现风险发生变化、修复完成或提交前需要专业代码评审时。
- **主要输入：** 冻结候选版本、差异、设计规格、公开契约和验证结果。
- **主要输出：** 按严重度排列的代码发现、证据、影响和修复要求。
- **职责边界：** 默认只评审不修改；风格偏好不能冒充缺陷。

## 二、执行方法

评审可观察风险和契约影响，不评判个人风格偏好。

### 执行流程

1. 固定候选版本和差异基线，读取约束规格、仓库说明和受影响公开契约。
2. 读取 `references/code-review.md`。
3. 仅在证明影响所需范围内，检查变更行之外的调用路径和所有权。
4. 执行最小相关构建、测试、架构检查以及安全或性能探测。
5. 区分已确认缺陷与需要测量的风险。
6. 将决定绑定到候选版本和约束源哈希；受影响实现或契约变化后标记为 `STALE`。
7. 先报告发现；除非用户要求修复，否则不编辑文件。

### 项目画像驱动规则

当项目画像或仓库说明指出本地代码评审策略时加载它。根据仓库证据推导受影响模块、接口、安全、持久化、前端、运行时和验证边界，不依赖命名项目模板。

### 输出

使用 P0—P3 以及 `PASS`、`PASS WITH FOLLOW-UP` 或 `BLOCKED`。每项发现必须包含精确位置、失败场景、证据、影响和必要修复。列出已执行命令、准确结果、未测试区域和残余风险。