# Subapi 三角色专业评审与博弈优化报告（用户代表/测试专家/网关专家，v1）

- 版本：v1.0
- 日期：2026-03-18
- 评审方式：专业 skills 驱动的线上联合评审（不进行线下评审）
- 角色范围：用户代表、测试专家、网关专家
- 关联文档：
  - `subapi_design_comprehensive_review_findings_v1_2026-03-17.md`
  - `subapi_expert_review_wargame_plan_v1_2026-03-17.md`
  - `subapi_integration_risk_controls_execution_tasks_v1_2026-03-17.md`
  - `router_core_takeover_execution_plan_v3_2026-03-17.md`

## 1. 结论先行

本轮三角色联合结论：`CONDITIONAL GO`。

触发条件：

1. 用户代表视角的迁移可接受性门槛必须上线（迁移成功率、回退时效、告知时效）。
2. 测试专家视角的阻断性质量门禁必须前置（契约漂移、流式回归、账务一致性）。
3. 网关专家视角的替换可逆性必须可验证（能力矩阵、降级策略、故障域隔离）。

若任一条件未满足，则默认进入 `NO-GO` 候选。

## 2. 角色化评审结果

## 2.1 用户代表评审（迁移可用性与商业可接受性）

### 关键风险

1. 迁移路径有技术灰度，但缺少“用户侧感知”的分层告知与承诺边界。
2. 缺少“兼容回归时用户可自助止血”的最小工具（例如一键切换备用入口提示）。
3. 账务争议处理存在流程草案，但未形成对外 SLA 承诺模板。

### Red vs Blue 博弈

1. Red：先做技术替换，用户沟通后补，会更快。
2. Blue：没有用户侧承诺，迁移中断会直接伤害续费与口碑。
3. 裁决：以“客户信任优先”为准，迁移计划必须绑定沟通与 SLA 机制。

### 角色结论

1. 等级：`P0`（商业阻断）
2. 通过条件：
   - 迁移事件分级与通知模板上线。
   - 用户可见状态页/告警消息与回退指引就绪。
   - 账务争议 SLA 文档签署生效。

## 2.2 测试专家评审（质量门禁与回归可证据性）

### 关键风险

1. 已有验收用例，但“阻断发布”的自动化回归证据链还不完整。
2. 流式边界（no-replay）与 failover 组合场景尚缺高压故障注入报告。
3. 接管率统计和契约口径已在收敛，但仍需长期漂移监控机制。

### Red vs Blue 博弈

1. Red：核心链路手工回归即可，自动化先不做全量。
2. Blue：S2 阶段变更频率高，手工回归无法稳定阻断风险发布。
3. 裁决：核心链路必须“自动化阻断 + 手工抽检”双轨。

### 角色结论

1. 等级：`P0`（质量阻断）
2. 通过条件：
   - 契约漂移检测任务接入 CI，失败即阻断。
   - 流式/Failover/账务一致性场景有固定回归套件。
   - 每轮升波必须附带可复核证据包（日志、指标、报告）。

## 2.3 网关专家评审（架构可替换性与运行风险）

### 关键风险

1. 现有方案明确了接管目标，但仍需防止适配层能力分散导致替换困难。
2. Provider 差异快速增加时，若没有能力矩阵和降级策略，故障半径会变大。
3. 缺少针对“适配器接口稳定性”的长期治理规范（版本与兼容边界）。

### Red vs Blue 博弈

1. Red：优先快速接入更多供应商，治理后置。
2. Blue：没有能力分层和降级策略，规模越大越难收敛风险。
3. 裁决：先固化能力矩阵与降级模型，再扩接新供应商。

### 角色结论

1. 等级：`P1`（高风险）
2. 通过条件：
   - 发布统一的 Provider 能力矩阵（鉴权、流式、工具调用、账务字段）。
   - 定义三层降级策略（同平台换号、同区域换平台、全局降级）。
   - 明确 Adapter SPI 的兼容版本规则。

## 3. 联合裁决与规划优化

## 3.1 规划优化项（新增）

1. 新增“迁移可接受性门槛”：
   - `migration_success_rate >= 99%`（试点租户）
   - `migration_incident_notify_sla <= 15 分钟`
   - `rollback_effective_time <= 30 分钟`
2. 新增“测试阻断门槛”：
   - 契约漂移检测必须通过
   - 流式 no-replay 回归必须通过
   - 账务一致性抽样必须通过
3. 新增“网关治理门槛”：
   - Provider 能力矩阵覆盖率 `=100%`（已接入供应商）
   - 降级策略演练通过（每周至少一次）
   - Adapter SPI 版本规则可追踪

## 3.2 执行策略优化（博弈后定稿）

1. 迁移节奏从“纯流量百分比驱动”升级为“流量 + 用户体验双门槛”驱动。
2. 质量策略从“验收测试清单”升级为“CI 阻断 + 演练证据包”双重门禁。
3. 网关扩容策略从“先接入再治理”改为“先矩阵治理再扩容”。

## 4. 任务映射（新增）

| 新任务ID | 来源角色 | 任务 | 截止日期 | 验收标准 | 证据产物 |
|---|---|---|---|---|---|
| UXR-001 | 用户代表 | 迁移旅程验收走查（含通知链路） | 2026-03-22 | 迁移异常 15 分钟通知链路实测通过 | `reports/user_representative_migration_walkthrough_2026-03-22.md` |
| UXR-002 | 用户代表 | 账务争议流程演练与反馈闭环 | 2026-03-25 | 争议演练通过且用户反馈关闭 | `reports/user_billing_dispute_drill_2026-03-25.md` |
| TST-001 | 测试专家 | 契约漂移检测接入 CI 阻断 | 2026-03-22 | 漂移失败即阻断发布 | `tests/compat/contract_drift_ci_report.md` |
| TST-002 | 测试专家 | 流式+Failover 高压回归套件 | 2026-03-24 | no-replay 与切换策略稳定通过 | `tests/compat/stream_failover_stress_report.md` |
| TST-003 | 测试专家 | 升波证据包标准化 | 2026-03-23 | 每次升波有统一证据目录 | `evidence/*/wave_gate_bundle.md` |
| GAT-001 | 网关专家 | Provider 能力矩阵与缺口清单 | 2026-03-22 | 已接入供应商覆盖率 100% | `docs/gateway/provider_capability_matrix_v1.md` |
| GAT-002 | 网关专家 | 三层降级策略与演练脚本 | 2026-03-25 | 演练可在 30 分钟内止血 | `docs/gateway/degrade_playbook_v1.md` |
| GAT-003 | 网关专家 | Adapter SPI 版本兼容规范 | 2026-03-26 | 新增适配器必须通过 SPI 兼容校验 | `docs/gateway/adapter_spi_versioning_v1.md` |
| EXP-007 | 联合评审 | 三角色联合复审与放行结论 | 2026-03-27 | 形成 GO/CONDITIONAL GO/NO-GO | `review/rounds/round2_compat_billing_review.md` |

## 5. 决策建议（提交管理层）

1. 批准三角色新增任务并纳入 `Daily Gate` 与 `Weekly Gate`。
2. 将 `EXP-007` 设为 `EXP-006` 最终决议前置条件。
3. 将用户代表意见纳入风险接受记录，避免纯技术维度放行。

## 6. 本轮产出清单

1. 三角色评审与博弈优化报告（本文档）。
2. 任务映射建议（UXR/TST/GAT/EXP-007）。
3. 规划与执行文档的回链更新（由对应文档维护）。
