AI 多角色代码审查流水线（v0.2）

v0.2 变更：① 新增校验 AI 角色（meta-review——学术实证支持，RevAgent critic）；② 反过拟合纪律（审查只报正确性/契约/需求缺口——其余 Nit）；③ 维度优先级（设计/契约/并发优先）；④ 定级加 Nit 档（可忽略） v0.3 变更：⑤ 新增 references/dimensions.md（评审维度清单 + 自动/人工归属列——补齐 Google 8 维第 3「复杂度」缺口）；⑥ G 输入处理三连（协作者输入一律实证核实→规模纠正→解法判定）；⑦ shepherd 闭环推动责任（默认校验 AI 兼任，例外可委托其他角色）

3+ AI 角色流水线：实现 AI（唯一完整上下文）→ 2+ 审查 AI（独立审查）→ 对弈收敛 → 统一修复 模型：单一职责（审查者无实现包袱——消除自我确认偏误）+ 实证定级 + 状态机交接 跨项目通用；专用定制在 references（按需覆写）

1. 角色模型

2. 流水线（7 阶段）

3. 交接契约（流水线核心——比流程本身更重要）

3.1 统一发现格式（finding schema——机器可解析）

id: {agent}-{P0|P1|P2|P3}-{n}    # agent 前缀消歧
位置: file:line
类别: 契约偏差/并发/内存/逻辑/可维护性/测试/文档
问题: 一句话
证据: 代码原文或工具输出引用（可追溯）；**删除/缺失/新增类 finding 必须附版本对证据（旧版有→新版无，如 git show 双版本对比）——评审报告实证护栏（复盘模式 10）**
定级: P0/P1/P2/P3                # 见 references/grading.md
修复建议: 明确动作 + 影响面
状态: open                       # 状态机流转

3.2 状态机（每条发现可视化流转）

open → confirm（实现AI实证核验：成立/撤回/降级）
     → reply（审查AI回执：接受/补证据/撤回）
     → fix（架构师裁决修改清单后）
     → verify（编译+测试+sanitizer）
     → close（CI 绿）

这六个状态只活在评审文件里。登记进问题台账时按下表映射，台账的枚举是唯一 schema： open/confirm/reply → open；fix → fixing；verify → verifying；close → closed。 Nit 级发现只写评审文件的 Nit 表，不进台账正文（references/grading.md），项目收尾时按技术债一次登记。

3.3 权威状态文件（唯一权威源——所有角色读它对齐）

• 路径：<日期>/<卡号>/评审.md（与卡同目录，见 sop/collaboration-flow.md §9.1）
• 内容：全部发现 + 状态 + 待拍板项 + 轮次——持续更新——防多 AI 信息不同步

3.4 G 输入处理（协作者三问）

协作者（G）输入一律走三连：① 是否实证（证据链 file:line / 工具输出）？② 规模是否夸大（2 处 vs 全局）？③ 正确解是否与直觉相同（直觉方向对、解法可能不同——nothrow→try/catch、手动锁→RAII）？处理 = 校验 AI 实证核实 → 规模纠正 → shepherd 汇总 → G 拍板；不直接采纳、不直接反驳。

4. 纪律（硬红线）

5. 与其他 skill 关系

• incident-review（复盘）：审查发现的问题 → 归因复盘；四分类台账由项目台账承接
• iso（重工程轨道）：审查收口 → 契约修订 / 关键决策记录
• 专用定制：项目级覆写 references（review-plan 范围 / grading 口径 / 工具命令）

6. 续接

1. 读 <日期>/<卡号>/评审.md（权威状态）
2. 读 references/review-plan.md（范围与纪律） 2.5 读 references/dimensions.md（评审清单 + 归属——P1 逐维覆盖）
3. 从 P2（未完成阶段）继续