performance-review

审计代码的性能合约。范围：$ARGUMENTS（空则审计 git diff main..HEAD）。

公共步骤模板见 skills-spec/01_skill_authoring_guide.md §A-§E。本 Skill 不生成代码，故第 5 步测试同步不适用。

本 Skill 是 新增的审计类 Skill。"代码 ↔ 约束"一致性审计。

第 0 步：🚫 模块 + 启用状态检查

1. 读 BUILD_STATUS.md §0 —— 命中 🚫 模块的文件跳过审计
2. 读 INDEX.md §0 AIWeave 采纳进度 —— 如 docs-spec/22_performance_contract 标 ⬜ 未启用 → 跳过本 Skill，提示"本工程未启用 22，跳过 performance-review"

第 1 步：读取约束源

读以下文件（按顺序）：

1. docs/architecture/performance_contract.md —— §1 SLA + §2 热路径清单 + §3 内存预算 + §4 数据访问约束 + §6 背压策略 + §7 性能回归
2. docs/architecture/ai_dev_guide.md §10.2 —— grep 锚 rule-id 索引（R-PERF-* / R-CACHE-* / R-LOCALMIRROR-STALE-READY）；§10.10 尾延迟 / 运行时调优类（R-TAIL-*）；§10.9 部署运行时（R-DEPLOY-GOMAXPROCS / R-RUNTIME-MEMLIMIT）
3. docs/circuit_breaker/circuit_breaker_design.md §2 —— 熔断参数（避免与 22 双源真相）
4. docs/BUILD_STATUS.md §11 —— 约束清单状态轨道

第 2 步：扫描代码范围

按 $ARGUMENTS 确定扫描范围：

• 空 / 当前 PR：git diff main..HEAD --name-only 取新增/修改的 .go 文件
• hot-path-only：仅取 performance_contract.md §2 清单中列出的文件
• 文件路径：直接以该路径为范围

第 3 步：热路径分类

对每个被扫描的 .go 文件，判定其是否属于"热路径"：

• 在 §2 热路径清单中显式列出 → 热路径
• 入口路由匹配 §2 清单中的路径 → 热路径
• service 方法被热路径直接或间接调用（≤ 1 跳）→ 准热路径
• 其他 → 普通路径

热路径文件适用 §3 全部 grep 锚 + §2.2 "禁止操作"列；普通路径仅适用 §3 中标 "all-paths" 的 grep 锚。

第 4 步：grep 锚检查（R-PERF-* 7 项 + R-DEPLOY/R-RUNTIME/R-TAIL 尾延迟 6 项 + SLO/profiling 2 项）

grep 锚定位为"信号级"非"判定级"。所有命中标 🟡 待复核；最终判定由人工 reviewer 决定。

R-DEPLOY-GOMAXPROCS / R-RUNTIME-MEMLIMIT / R-TAIL-* 多为信号级（🟡），grep 仅给线索，判定结合 deployment.md §4/§7 + performance_contract.md §6.4 时序与幂等语义。

检查 R-PERF-HOT-REFLECT：热路径用反射

范围：热路径 + 准热路径文件
grep 模式：'reflect\.'
误报排除：
  - 文件含 //go:build !hotpath 标记
  - 行末含 // aiweave:allow=R-PERF-HOT-REFLECT 注解

检查 R-PERF-HOT-FMT：热路径用 fmt.Sprintf

范围：热路径 + 准热路径文件
grep 模式：'fmt\.Sprintf\(|fmt\.Errorf\('
误报排除：
  - 错误路径（与 if err != nil 相邻）—— 错误路径不算热
  - 仅 fmt.Errorf 用于 wrap error
  - 行末含 // aiweave:allow=R-PERF-HOT-FMT 注解

检查 R-PERF-LOOP-DB-QUERY：for 循环内 DB 查询（N+1）

范围：所有路径
grep 模式：'for [^{]*\{[\s\S]{0,300}?\.(Find|First|Where|Take)\('
误报排除：
  - 显式批量 API（In(...) / Pluck / Scan）
  - 循环次数硬编码 ≤ {Loop-DB-safe}（如 < 5）
  - 行末含 // aiweave:allow=R-PERF-LOOP-DB-QUERY 注解