216 lines
5.8 KiB
Markdown
216 lines
5.8 KiB
Markdown
# 线损家族变体扩展计划
|
||
|
||
> **Status:** Draft
|
||
> **Date:** 2026-04-18
|
||
> **Author:** Codex
|
||
> **Upstream Inputs:**
|
||
> [2026-04-18-g2-family-expansion-plan.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/plans/2026-04-18-g2-family-expansion-plan.md)
|
||
> [2026-04-18-g2-family-expansion-third-round-report.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/reports/2026-04-18-g2-family-expansion-third-round-report.md)
|
||
|
||
## Plan Intent
|
||
|
||
本计划用于承接当前已经收敛出的 `G2-A/G2-B/G2-C` 三类线损子型，把目标从“修通三个代表样本”推进到“可复制扩展更多线损变体”。
|
||
|
||
当前已经证明：
|
||
|
||
1. `G2-A` 双模式主报表型可生成
|
||
2. `G2-B` 周报单侧 mode 型可生成
|
||
3. `G2-C` 混合联动型可生成
|
||
|
||
因此，下一阶段不再围绕这三个样本反复微调，而是要把“线损场景 -> 子型 -> 最小合同 -> 候选验证”这条复制链做出来。
|
||
|
||
## Success Baseline
|
||
|
||
本计划完成后的最低成功口径固定为：
|
||
|
||
1. 新增一批线损真实场景能够被归入现有子型或新子型
|
||
2. 每个新增子型都有最小合同标准
|
||
3. 至少每类新增子型有 2 到 3 个真实样本完成迁移验证
|
||
4. 不能归类或合同不足的样本继续 `fail-close`
|
||
5. 形成一份“线损家族实施映射表”
|
||
6. 输出一轮新的线损家族扩展报告
|
||
|
||
## Scope Guardrails
|
||
|
||
执行过程中保持以下边界不变：
|
||
|
||
1. 不扩展到非线损报表家族
|
||
2. 不处理统一登录、隐藏域登录或宿主 transport 重构
|
||
3. 不在本计划中做真实内网人工验证
|
||
4. 不把本计划扩散成 102 个全量场景一次性铺开
|
||
5. 不回头推翻已经收敛的 `G2-A/G2-B/G2-C` 结果
|
||
|
||
## Phase Overview
|
||
|
||
本计划按五个阶段推进：
|
||
|
||
1. Phase 0：冻结线损扩展基线
|
||
2. Phase 1：建立线损变体分组清单
|
||
3. Phase 2：为新增变体建立最小合同标准
|
||
4. Phase 3：按分组扩展 fixture / 判定 / 生成链路
|
||
5. Phase 4：回归真实样本并输出扩展报告
|
||
|
||
执行顺序固定为：
|
||
|
||
`Phase 0 -> Phase 1 -> Phase 2 -> Phase 3 -> Phase 4`
|
||
|
||
## Phase 0：冻结扩展基线
|
||
|
||
### Objective
|
||
|
||
把当前已经达成的线损家族基线冻结下来，作为后续横向复制的起点。
|
||
|
||
### Tasks
|
||
|
||
1. 固化 `G2-A/G2-B/G2-C` 当前口径
|
||
2. 固化这三类子型的最小合同事实
|
||
3. 固化本计划不再回到“主样本修通”阶段
|
||
|
||
### Exit Criteria
|
||
|
||
1. `G2-A/G2-B/G2-C` 被视为已建立的家族基线
|
||
2. 扩展工作被明确表述为“更多线损变体复制”
|
||
|
||
## Phase 1：建立线损变体分组清单
|
||
|
||
### Objective
|
||
|
||
先把“还要扩哪些线损场景”分组，而不是直接零散补样本。
|
||
|
||
### Tasks
|
||
|
||
1. 从现有线损场景中筛出最接近当前家族的候选样本
|
||
2. 按结构而不是按名称分组，至少分成：
|
||
- 双模式主报表型
|
||
- 周报/日报单侧模式型
|
||
- 排行/明细主链路型
|
||
- 线损主链路 + 外部系统联动型
|
||
- 异常诊断/详情下钻型
|
||
3. 每组先挑 2 到 3 个代表样本
|
||
|
||
### Deliverables
|
||
|
||
1. 线损变体分组清单
|
||
2. 每组代表样本名单
|
||
|
||
### Exit Criteria
|
||
|
||
1. 不再按单个场景零散推进
|
||
2. 后续整改对象以“分组”为单位推进
|
||
|
||
## Phase 2：建立新增变体最小合同标准
|
||
|
||
### Objective
|
||
|
||
为每一组新增线损变体先定义“什么叫最低可用”，再动生成器。
|
||
|
||
### Tasks
|
||
|
||
1. 为每组定义最小合同，至少明确：
|
||
- 主 endpoint
|
||
- request template
|
||
- response path
|
||
- 关键字段或 column defs
|
||
- normalize / required fields
|
||
2. 明确哪些链路属于主合同
|
||
3. 明确哪些链路属于扩展证据或风险证据
|
||
|
||
### Deliverables
|
||
|
||
1. 线损变体最小合同表
|
||
2. 每组的候选验证门槛
|
||
|
||
### Exit Criteria
|
||
|
||
1. 每组都有统一判定口径
|
||
2. 后续开发不再靠单样本临时拍脑袋
|
||
|
||
## Phase 3：按分组扩展生成链路
|
||
|
||
### Objective
|
||
|
||
把新增变体分组逐类接入 analyzer / generator / readiness。
|
||
|
||
### Tasks
|
||
|
||
1. 每一组先补 fixture
|
||
2. 每一组先补测试
|
||
3. 再补子型判定
|
||
4. 再补最小合同恢复
|
||
5. 再补 readiness 分级
|
||
|
||
### Rules
|
||
|
||
1. 任何一组都必须先有 fixture，再改逻辑
|
||
2. 不允许多个组同时无边界并行扩散
|
||
3. 一组完成后再推进下一组
|
||
|
||
### Deliverables
|
||
|
||
1. 新增线损变体 fixture
|
||
2. 新增家族回归测试
|
||
3. 对应 analyzer / generator / readiness 扩展实现
|
||
|
||
### Exit Criteria
|
||
|
||
1. 至少新增 1 到 2 类线损变体可生成
|
||
2. 原有 `G2-A/G2-B/G2-C` 不回退
|
||
|
||
## Phase 4：真实样本回归与扩展报告
|
||
|
||
### Objective
|
||
|
||
把扩展后的线损家族能力回到真实样本上验证，而不是停在 fixture 层。
|
||
|
||
### Tasks
|
||
|
||
1. 重新生成各组代表样本
|
||
2. 对比：
|
||
- 子型判定
|
||
- bootstrap
|
||
- request contract
|
||
- response / column / normalize contract
|
||
- readiness
|
||
- 是否进入候选验证名单
|
||
3. 输出线损家族扩展回归报告
|
||
|
||
### Deliverables
|
||
|
||
1. 真实样本生成结果
|
||
2. 线损家族扩展回归报告
|
||
3. 更新后的候选验证名单
|
||
|
||
### Acceptance Criteria
|
||
|
||
1. 至少 2 个以上新增线损变体组进入候选验证阶段
|
||
2. 不能归类的场景继续 `fail-close`
|
||
3. 原有三类 `G2-A/G2-B/G2-C` 不回退
|
||
|
||
## Workstream Breakdown
|
||
|
||
本计划建议按以下工作流落地：
|
||
|
||
1. `WS1` 线损变体盘点与分组
|
||
2. `WS2` 新增变体最小合同设计
|
||
3. `WS3` fixture / 回归测试扩展
|
||
4. `WS4` analyzer / generator / readiness 扩展
|
||
5. `WS5` 真实样本回归与报告
|
||
|
||
## File-Level Targets
|
||
|
||
执行本计划时，预计触达以下资产类型：
|
||
|
||
1. `docs/superpowers/plans/`
|
||
2. `docs/superpowers/reports/`
|
||
3. `tests/fixtures/generated_scene/`
|
||
4. `tests/`
|
||
5. `src/generated_scene/`
|
||
|
||
## Completion Criteria
|
||
|
||
本计划完成的标志是：
|
||
|
||
1. 线损家族不再只有三个代表样本可解释
|
||
2. 已建立“按分组复制”的扩展方法，而不是单样本修修补补
|
||
3. 后续是否继续向更广场景扩展，可以建立在这份线损家族扩展结果上
|