# 线损家族变体扩展计划

> **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. 后续是否继续向更广场景扩展，可以建立在这份线损家族扩展结果上