feat: add generated scene skill platform hardening
This commit is contained in:
木炎
@@ -0,0 +1,458 @@
|
||||
# G3 Paginated Enrichment Plan
|
||||
|
||||
> **Status:** Draft
|
||||
> **Date:** 2026-04-18
|
||||
> **Author:** Codex
|
||||
> **Upstream Spec:** [2026-04-18-g3-paginated-enrichment-design.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/specs/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` 的独立设计与计划
|
||||
Reference in New Issue
Block a user