# G2 家族扩展整改计划

> **Status:** Draft
> **Date:** 2026-04-18
> **Author:** Codex
> **Upstream Inputs:**
> [2026-04-18-g2-remediation-plan.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/plans/2026-04-18-g2-remediation-plan.md)
> [2026-04-18-g2-second-round-remediation-report.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/reports/2026-04-18-g2-second-round-remediation-report.md)

## Plan Intent

本计划用于承接上一轮 `G2` 主样本整改结果，把目标从“修通 `tq` 主样本”推进到“扩展 `G2` 家族变体覆盖”。

上一轮已经证明：

1. `台区线损大数据-月_周累计线损率统计分析` 可以进入候选验证名单
2. `G2` 主样本链路已经具备可编译性
3. `白银线损周报`
4. `线损同期差异报表`

这两份剩余真实样本仍然稳定 `fail-close`

因此，本计划的核心目标不是重做上一轮主样本整改，而是补齐 `G2` 家族内部剩余两类变体的识别与合同恢复能力。

## Success Baseline

本计划完成后的最低成功口径固定为：

1. `白银线损周报` 不再因为 `G2` 合同缺失而直接阻断
2. `线损同期差异报表` 不再被粗暴套入 `tq` 主报表模板
3. 生成器能够明确区分至少两类新增 `G2` 家族子型
4. 新增子型具备各自最小可解释合同
5. 对证据不足的样本继续 `fail-close`
6. readiness 与“是否达到候选验证名单”保持一致
7. 输出第三轮 `G2` 家族扩展回归报告

## Scope Guardrails

执行过程中保持以下边界不变：

1. 不切换到 `G1`
2. 不切换到 `G3`
3. 不展开统一登录、隐藏域登录或宿主 transport 重构
4. 不扩展到 102 个全量场景
5. 不把本计划扩散成通用 scene skill 平台重写
6. 不否定上一轮 `tq` 主样本已经收敛的口径

## Target Samples

本计划只围绕以下三份 `G2` 家族真实样本执行：

1. `台区线损大数据-月_周累计线损率统计分析`
2. `白银线损周报`
3. `线损同期差异报表`

其中角色区分为：

1. `台区线损大数据-月_周累计线损率统计分析`
   作用：`G2-A` 主样本基线，不允许回退
2. `白银线损周报`
   作用：`G2-B` 周报单侧 mode 变体
3. `线损同期差异报表`
   作用：`G2-C` 混合联动变体

## Family Expansion Hypothesis

基于上一轮报告，本计划先将 `G2` 家族收束为三类：

1. `G2-A`
   定义：`tq` 主报表型，具备稳定的 `month/week + cols1/cols2 + mode-specific request/response`
   当前状态：已进入候选验证名单
2. `G2-B`
   定义：周报偏单侧 mode 变体，存在 `week/tjzq` 与线损主接口，但缺少与主样本同等级的双模式列合同
   当前代表：`白银线损周报`
3. `G2-C`
   定义：线损主链路与外部系统联动混合变体，存在线损接口和联动接口并存的情况
   当前代表：`线损同期差异报表`

本计划的整改原则是：

1. 不强行把 `G2-B/G2-C` 编造成 `G2-A`
2. 先把三类子型边界立住
3. 再让每类子型各自拥有最小合同

## Workstreams

本计划拆为五条工作流：

1. `WS1` G2 子型分层与判定收束
2. `WS2` G2-B 周报变体合同补齐
3. `WS3` G2-C 混合联动变体隔离
4. `WS4` G2 家族 readiness 分级重整
5. `WS5` 真实样本第三轮回归与报告

## Phase Overview

本计划按四个阶段推进：

1. Phase 0：冻结家族扩展目标
2. Phase 1：建立 `G2-A/G2-B/G2-C` 子型边界
3. Phase 2：分别补齐 `G2-B/G2-C` 最小合同
4. Phase 3：回归三份真实样本并输出扩展报告

执行顺序固定为：

`Phase 0 -> Phase 1 -> Phase 2 -> Phase 3`

## Phase 0：冻结扩展目标

### Objective

把上一轮已经收敛出来的家族事实冻结下来，避免再次把问题表述成“主样本没修好”。

### Tasks

1. 固化 `G2-A` 已达标口径
2. 固化 `G2-B` 与 `G2-C` 的直接 blocker
3. 固化本计划只补家族扩展，不回退主样本链路

### Exit Criteria

1. `tq` 主样本被视为基线，不再作为待整改对象
2. 家族扩展问题被明确表述为“变体支持缺失”

## Phase 1：建立子型边界

### Objective

让系统能区分 `G2-A/G2-B/G2-C`，而不是所有 `G2` 一律走同一套路。

### WS1：G2 子型分层与判定收束

#### Task 1

审计当前 `G2` 真实样本信号差异，明确以下边界：

1. 哪些信号属于 `G2-A`
2. 哪些信号属于 `G2-B`
3. 哪些信号属于 `G2-C`

#### Task 2

为 `G2` 增加子型判定规则，至少能区分：

1. 双模式主报表型
2. 周报单侧 mode 型
3. 混合联动型

#### Task 3

补充 fixture 与回归测试，证明：

1. `G2-A` 不回退
2. `G2-B` 不再误套 `G2-A`
3. `G2-C` 不再误套 `G2-A`

### Phase 1 Exit Criteria

1. `G2` 家族内部已可分层
2. 生成路径不再默认所有 `G2` 都是 `tq` 主报表

## Phase 2：补齐变体最小合同

### Objective

分别为 `G2-B` 和 `G2-C` 建立“足够小但可解释”的合同。

### WS2：G2-B 周报变体合同补齐

#### Task 4

定义 `G2-B` 的最小合同，至少包括：

1. 主 mode 或主周期字段
2. 对应 request template
3. 对应 response path
4. 对应 column/required fields

#### Task 5

修改 analyzer / generator / scene ir 组装逻辑，使 `白银线损周报` 能输出非空合同，而不是继续因合同缺失直接阻断。

#### Task 6

新增或更新测试，证明 `G2-B` 可以独立成立，不依赖 `month/week` 双模式完整结构。

### WS3：G2-C 混合联动变体隔离

#### Task 7

审计 `线损同期差异报表` 中：

1. 线损主链路
2. 同期系统联动链路
3. 哪一部分属于主报表合同

#### Task 8

为 `G2-C` 建立隔离规则，避免混合联动接口污染主报表生成。

#### Task 9

定义 `G2-C` 的最小可编译合同，允许：

1. 主链路进入候选验证
2. 联动链路作为风险或扩展证据保留

而不是全部混在一起后直接失败。

#### Task 10

新增或更新测试，证明 `G2-C` 至少能稳定输出“主链路 + 联动风险”的结构化结果。

### WS4：G2 家族 readiness 分级重整

#### Task 11

为 `G2-A/G2-B/G2-C` 增加子型级 readiness gate。

#### Task 12

调整 readiness 评级逻辑，保证：

1. `G2-A` 满足完整双模式合同时可以进入 `A`
2. `G2-B` 满足其最小合同时可以进入候选验证等级
3. `G2-C` 若仅主链路闭合，也能获得可解释等级
4. 证据不足时继续 `fail-close`

#### Task 13

补充测试，证明 readiness 不会再用 `G2-A` 的标准去误判全部 `G2` 子型。

### Phase 2 Exit Criteria

1. `G2-B` 具备最小合同
2. `G2-C` 具备隔离后的最小合同
3. readiness 与子型口径一致

## Phase 3：真实样本第三轮回归

### Objective

基于扩展后的家族能力，重新回归三份真实样本并输出正式结论。

### WS5：真实样本第三轮回归与报告

#### Task 14

重新生成以下三份真实样本：

1. `台区线损大数据-月_周累计线损率统计分析`
2. `白银线损周报`
3. `线损同期差异报表`

#### Task 15

按统一口径对比：

1. 子型判定
2. bootstrap
3. request contract
4. response / column / normalize contract
5. readiness
6. 是否进入候选验证名单

#### Task 16

输出第三轮 `G2` 家族扩展整改报告，至少说明：

1. `G2-A` 是否保持稳定
2. `G2-B` 是否进入候选验证名单
3. `G2-C` 是否进入候选验证名单或仍需 fail-close
4. 剩余 blocker 是否已经从“主样本不可生成”转移为“少数变体待扩展”

### Deliverables

1. `G2` 家族扩展回归测试
2. `G2-B/G2-C` 对应 fixture
3. 第三轮真实样本生成结果
4. 第三轮 `G2` 家族扩展整改报告

### Acceptance Criteria

1. `G2-A` 不回退
2. `G2-B` 至少达到可解释合同或候选验证等级
3. `G2-C` 至少达到主链路隔离成功，不能继续被整包噪声污染
4. 三份样本不再被单一 `G2-A` 模型粗暴处理

## File-Level Targets

本计划执行时，至少会触达以下资产类型：

1. `src/generated_scene/` 下的 analyzer / generator / readiness 相关实现
2. `tests/fixtures/generated_scene/` 下的 `G2-B/G2-C` fixture
3. `tests/` 下与 scene generator / readiness / family regression 相关的测试
4. `docs/superpowers/reports/` 下的第三轮家族扩展报告

## Completion Criteria

本计划完成的标志是：

1. `G2` 已从“单主样本修通”推进到“至少三类子型可区分”
2. `白银线损周报` 与 `线损同期差异报表` 不再只是被动 fail-close
3. 下一步是否继续扩到更多线损变体，可以建立在第三轮家族扩展报告上