claw/docs/superpowers/plans/2026-04-18-lineloss-family-variant-expansion-plan.md

线损家族变体扩展计划

Status: Draft Date: 2026-04-18 Author: Codex Upstream Inputs: 2026-04-18-g2-family-expansion-plan.md 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. 后续是否继续向更广场景扩展，可以建立在这份线损家族扩展结果上