claw/docs/superpowers/plans/2026-04-18-g3-paginated-enrichment-plan.md

G3 Paginated Enrichment Plan

Status: Draft Date: 2026-04-18 Author: Codex Upstream Spec: 2026-04-18-g3-paginated-enrichment-design.md

Plan Intent

本计划用于把 G3 分页补数家族设计拆解为可执行任务，目标是把当前 paginated_enrichment 从“宽泛的复杂 workflow 标签”推进到“具备证据层、最小合同、canonical baseline 和 fail-closed 判定”的正式主线 archetype。

本计划严格限定在 G3 / P0-3 落地，不扩展到：

1. G6/G7/G8
2. 全量 95598 家族并发整改
3. 登录恢复或宿主 transport 重构
4. 102 个场景大规模铺开

Success Baseline

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

1. 95598工单明细表 不再只是“复杂工单类”模糊样本
2. 生成链能够显式恢复：
   • main request
   • pagination plan
   • enrichment requests
   • export plan
3. localhost:*、宿主注入和 BrowserAction 不再被误判为业务主链
4. G3 具备最小可编译合同和独立 gate
5. 证据不足时结果稳定 fail-closed
6. 95598、12398、流程超期风险工单明细 能作为第一扩展样板进入复用验证

Scope Guardrails

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

1. 不把 G3 回退为普通分页表识别
2. 不把宿主桥接能力提前混入 G3 合同
3. 不为了先生成 skill 而放松 gate
4. 不并发展开 G6/G7/G8
5. 不在本计划中做真实内网人工验证

Target Samples

本计划整改与回归只围绕以下两个样板：

1. 95598工单明细表
2. 95598、12398、流程超期风险工单明细

其中角色固定为：

1. 95598工单明细表
   • 作用：P0-3 主样板
   • 目标：冻结 G3 canonical
2. 95598、12398、流程超期风险工单明细
   • 作用：第一扩展样板
   • 目标：验证 G3 合同与证据层是否可复用

Workstreams

本计划拆为五条工作流：

1. WS1 G3 边界冻结与样板建档
2. WS2 G3 证据层建模
3. WS3 G3 Scene IR / compiler gate / readiness 建设
4. WS4 G3 P0 canonical 与失败 taxonomy 冻结
5. WS5 G3 真实样本回归与报告

Phase Overview

本计划按五个阶段推进：

1. Phase 0：冻结 G3 边界与样板
2. Phase 1：建立 G3 证据层
3. Phase 2：建立 G3 最小合同与 gate
4. Phase 3：冻结 P0-3 canonical
5. Phase 4：回归真实样本并输出首轮报告

执行顺序固定为：

Phase 0 -> Phase 1 -> Phase 2 -> Phase 3 -> Phase 4

Phase 0：冻结 G3 边界与样板

Objective

先把 G3 的问题边界、主样板和扩展样板固定下来，避免开发过程中把工单类、宿主桥接类和导出分析类重新混在一起。

WS1：G3 边界冻结与样板建档

Task 1

冻结 G3 正式定义：

1. 不是普通分页表
2. 不是宿主桥接型
3. 而是“主查询链 + 分页链 + 补数链 + 导出链”并存的复杂 workflow 报表

Task 2

冻结 95598工单明细表 为唯一 P0-3 主样板。

Task 3

冻结 95598、12398、流程超期风险工单明细 为第一扩展样板。

Task 4

固化 G3 进入条件：

1. 存在主查询链候选
2. 存在分页控制证据
3. 存在补数或关联详情链
4. 最终结果依赖分页拉全、补齐、导出或汇总

Task 5

固化 G3 排除条件：

1. 单请求即可完成的普通报表
2. 仅靠 BrowserAction 推进、无稳定业务主链
3. 以本地落库分析或文档产物为主体
4. localhost:* 或宿主依赖明显压过业务证据

Deliverables

1. G3 family definition
2. G3 样板清单
3. G3 进入条件与排除条件
4. G3 与其它家族边界说明

Exit Criteria

1. 95598工单明细表 不再作为模糊工单样本讨论
2. G3 不再与宿主桥接型、文档产物型场景混淆

Phase 1：建立 G3 证据层

Objective

把源码直接压成 Scene IR 的路径升级为：先形成 G3 可裁决证据，再归约成 Scene IR。

WS2：G3 证据层建模

Task 6

定义 main_request_candidate，承载：

1. 主查询 endpoint
2. 查询参数模板
3. 时间范围或主过滤条件

Task 7

定义 pagination_candidate，承载：

1. 页码字段
2. pageSize 字段
3. 翻页终止条件
4. 滚动窗口或区间推进规则

Task 8

定义 enrichment_request_candidate，承载：

1. 详情补查
2. 二次接口
3. 关联补数

Task 9

定义 join_key_candidate，承载：

1. 工单号
2. 流程号
3. 用户号
4. 设备号
5. 其它主补链关联键

Task 10

定义 export_candidate，承载：

1. 导出接口
2. 导出参数
3. 导出前置动作
4. 产物类型

Task 11

定义 workflow_step_candidate，承载：

1. 主查
2. 翻页
3. 补查
4. 聚合
5. 导出

之间的顺序关系。

Task 12

定义 dedupe_or_merge_rule_candidate，承载：

1. 去重规则
2. 主从并回规则
3. 跨页累积规则

Task 13

定义 host_bridge_candidate 与 localhost_dependency_candidate，确保宿主链只作为独立证据保留。

Task 14

建立证据归并与冲突裁决规则，明确：

1. 哪些属于业务主链
2. 哪些属于宿主桥接
3. 哪些属于结果导出链

Deliverables

1. G3 evidence schema
2. G3 evidence type dictionary
3. 证据归并规则
4. 95598工单明细表 第一版证据样例

Exit Criteria

1. 主链、分页链、补链、导出链、宿主链能够分槽呈现
2. localhost:* 不再混入业务主链

Phase 2：建立 G3 最小合同与 Gate

Objective

把 G3 的判定标准从“看起来像分页补数场景”升级为“最小业务合同是否成立”。

WS3：G3 Scene IR / compiler gate / readiness 建设

Task 15

定义 G3 最小合同，至少包括：

1. main_request
2. pagination_plan
3. enrichment_requests[]
4. join_keys[]
5. export_plan
6. merge_or_dedupe_rules

Task 16

在 Scene IR 中承载 G3 专属结构，不再退化成普通 paginated_enrichment 空壳字段。

Task 17

增加 G3 gate，至少包括：

1. g3_main_request_resolved
2. g3_pagination_contract_complete
3. g3_enrichment_contract_complete
4. g3_join_key_resolved
5. g3_export_path_identified
6. g3_runtime_scope_compatible

Task 18

定义 blocker / readiness 判定口径，要求能区分：

1. 业务证据不足
2. 分页合同不闭合
3. 补数合同不闭合
4. 导出链依赖宿主
5. 运行时依赖未满足

Task 19

落地 fail-closed 规则：

1. 主请求链缺失，阻断
2. 分页链存在但终止条件不明，阻断
3. 补数链存在但 join key 不明，阻断
4. 只有导出动作没有业务主链，阻断
5. 宿主桥接证据明显多于业务证据，阻断

Task 20

补充测试，证明未闭合 G3 样本不能伪装成 runnable skill。

Deliverables

1. G3 minimal contract table
2. G3 gate table
3. G3 blocker / readiness table
4. G3 Scene IR example

Exit Criteria

1. G3 已拥有独立 gate
2. 未闭合结果会准确阻断
3. compiler 不再吞入未闭合 G3 IR

Phase 3：冻结 P0-3 Canonical

Objective

把 95598工单明细表 做成 G3 的第一版标准答案、关键证据基线和失败 taxonomy 基线。

WS4：G3 P0 canonical 与失败 taxonomy 冻结

Task 21

冻结 95598工单明细表 的 canonical Scene IR。

Task 22

冻结关键证据清单，至少包括：

1. 主请求链
2. 分页链
3. 补数链
4. join key
5. 导出链
6. 宿主依赖

Task 23

冻结验收检查表，至少检查：

1. 主链是否恢复
2. 分页链是否恢复
3. 补链是否恢复
4. join key 是否恢复
5. 导出链是否恢复
6. 宿主链是否被隔离
7. readiness 是否与真实闭合程度一致

Task 24

冻结失败 taxonomy，至少包括：

1. main_chain_missing
2. pagination_incomplete
3. enrichment_incomplete
4. join_key_missing
5. export_only_without_business_chain
6. host_bridge_pollution
7. runtime_dependency_unresolved

Task 25

建立“生成结果 vs canonical”对齐方式。

Deliverables

1. G3 P0 canonical Scene IR
2. G3 P0 evidence baseline
3. G3 acceptance checklist
4. G3 failure taxonomy table

Exit Criteria

1. 95598工单明细表 成为 G3 第一版统一校准源
2. 后续 G3 回归都可以对照固定 taxonomy

Phase 4：真实样本回归与首轮报告

Objective

先用 P0 主样板建立闭环，再用一个扩展样板验证 G3 合同是否具备复用性。

WS5：G3 真实样本回归与报告

Task 26

重新生成 95598工单明细表。

Task 27

按统一口径检查：

1. archetype
2. bootstrap
3. main request
4. pagination plan
5. enrichment requests
6. join keys
7. export plan
8. localhost / host bridge separation
9. readiness / blocker

Task 28

输出 G3 P0 validation report，结论只允许以下三种：

1. 通过
2. Fail-closed 且理由准确
3. 误判，需要整改

Task 29

重新生成 95598、12398、流程超期风险工单明细。

Task 30

对比其与 P0 样板之间：

1. 哪些合同可复用
2. 哪些 blocker 是家族共性
3. 哪些是扩展样板特有复杂度

Task 31

输出 G3 first-round family expansion report。

Deliverables

1. G3 P0 样板生成结果
2. G3 P0 验证报告
3. G3 扩展样板生成结果
4. G3 首轮家族扩展报告

Acceptance Criteria

1. 95598工单明细表 至少达到“结构恢复完整”或“Fail-closed 理由准确”
2. 扩展样板不会再被粗暴压成普通分页表
3. G3 失败结果具备可解释性
4. G3 至少形成第一版家族复用口径

File-Level Targets

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

1. docs/superpowers/specs/
2. docs/superpowers/plans/
3. docs/superpowers/reports/
4. src/generated_scene/ 下与证据层、合同层、readiness 相关实现
5. tests/fixtures/generated_scene/
6. tests/

Completion Criteria

本计划完成的标志是：

1. G3 已拥有正式边界定义
2. G3 已拥有最小证据层与最小合同
3. G3 已拥有独立 gate 与 fail-closed 口径
4. 95598工单明细表 已成为 P0-3 canonical
5. G3 首轮真实样本回归已经给出正式结论

Next Step

本计划完成后，后续顺序固定为：

1. 若 G3 的 P0 与首轮扩展样板稳定，再决定是否补第二个 G1-E 样板
2. 然后再决定是否进入 G6 的独立设计与计划