Files
claw/docs/superpowers/plans/2026-04-18-g1-boundary-reassignment-plan.md

194 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# G1 边界收敛与家族重排实施计划
> Date: 2026-04-18
> Status: Draft
> Source:
> - `docs/superpowers/specs/2026-04-17-scene-skill-60-to-90-roadmap-design.md`
> - `examples/g1_batch_round1/`
## 1. Plan Intent
本计划用于处理 `G1` 通用单页报表组边界过宽的问题。
通过对以下 4 个边界样本的实测与结构分析,已经确认当前 `G1` 分类存在误收问题:
1. `高低压新增报装容量月度统计表`
2. `电能表现场检验完成率指标报表`
3. `计量资产库存统计`
4. `95598供电服务月报`
结论不是“是否继续观察”,而是“必须整改”:
1. `G1` 的定义必须收紧
2. 这 4 个样本必须重排
3. 后续实施必须按新边界推进,不能继续把这 4 个样本混在同一类里
## 2. Rectification Objective
本轮整改目标固定为:
1. 收紧 `G1` 定义,避免继续污染 `single_request_table`
2. 将 4 个边界样本重新分配到正确家族
3. 为后续实现提供明确顺序,不再把边界样本混做“通用报表”
## 3. Final Reassignment Decision
本计划执行时4 个样本的正式归类结论固定如下:
1. `高低压新增报装容量月度统计表`
- 保留在 `G1`
- 子型标记为:`G1-E 轻量补查汇总型`
2. `电能表现场检验完成率指标报表`
-`G1` 拆出
- 新家族标记为:`G6 宿主桥接多步查询型`
3. `计量资产库存统计`
-`G1` 拆出
- 新家族标记为:`G7 多接口盘点汇总型`
4. `95598供电服务月报`
-`G1` 拆出
- 新家族标记为:`G8 抓取落库分析出文档型`
## 4. Scope Guardrails
本计划边界固定如下:
1. 不修改线损家族 `G2`
2. 不扩展到全部 `102` 个场景同步重排
3. 只处理 `G1` 边界定义与这 4 个边界样本
4. 不在本计划内直接实现 `G6/G7/G8` 全部能力
5. 本计划优先产出“边界收敛 + 家族重排 + 实施顺序”
## 5. Phase Overview
执行顺序固定为:
`Phase 0 -> Phase 1 -> Phase 2 -> Phase 3`
### Phase 0: 冻结整改口径
目标:
1. 冻结 `G1` 修订定义
2. 冻结 4 个样本的正式重排结论
退出标准:
1. 后续不再把这 4 个样本同时作为 `G1` 候选讨论
### Phase 1: 收紧 G1 边界
目标:
1.`G1` 明确收敛为“通用单页报表”
2. 把不属于 `G1` 的结构特征显式列为排除条件
必须落地的对象:
1. `G1` 修订定义
2. `G1` 进入条件
3. `G1` 排除条件
4. `G1-E` 作为上边界子型的说明
退出标准:
1. `single_request_table` 不再承接宿主桥接型、盘点型、落库分析型场景
### Phase 2: 样本重排与家族建档
目标:
1. 把 4 个样本正式移到对应家族
2.`G6/G7/G8` 建立最小定义
必须落地的对象:
1. 样本重排表
2. `G6` 最小定义
3. `G7` 最小定义
4. `G8` 最小定义
退出标准:
1. 4 个样本不再处于“G1 模糊候选”状态
### Phase 3: 后续实施顺序固定
目标:
1. 确定后续开发顺序
2. 避免多家族并发扩散
固定顺序:
1. 先继续推进 `高低压新增报装容量月度统计表`
- 作为 `G1-E`
2. 再单开 `G6`
- `电能表现场检验完成率指标报表`
3. 再评估 `G7`
- `计量资产库存统计`
4. 最后评估 `G8`
- `95598供电服务月报`
退出标准:
1. 后续任务顺序明确
2. `G1` 不再继续吞入新边界样本
## 6. Family-Level Rectification Rules
### 6.1 G1 修订规则
`G1` 仅保留以下场景:
1. 单系统、单页面承载
2. 存在相对清晰的主请求链
3. 请求模板与响应路径可直接恢复
4. 最终结果为单表或单次统计汇总
5. 不依赖复杂宿主桥接
6. 不依赖本地落库与 SQL 分析
### 6.2 G1 排除规则
出现以下特征之一,即不再归入 `G1`
1. `BrowserAction / sgBrowserExcuteJsCode` 主导业务请求推进
2. 存在明显多轮 callback 串联 workflow
3. 同场景内存在多个业务 endpoint 分类型扫数
4. 报表前需要本地落库、二次分析或 SQL 聚合
5. 输出以 Word 文档流水线而非直接表格结果为主
## 7. Implementation Priority
优先级固定如下:
1. `P0`
- `高低压新增报装容量月度统计表`
- 目标:验证 `G1-E` 是否可作为 `G1` 上边界稳定成立
2. `P1`
- `电能表现场检验完成率指标报表`
- 目标:验证 `G6` 的最小 workflow 定义
3. `P2`
- `计量资产库存统计`
- 目标:验证 `G7` 的多 endpoint 聚合边界
4. `P3`
- `95598供电服务月报`
- 目标:验证 `G8` 的抓取落库分析链路边界
## 8. Deliverables
本计划完成时至少产出:
1. `G1` 边界修订文案
2. 4 个边界样本重排表
3. `G6/G7/G8` 最小家族定义
4. 后续实施优先级清单
## 9. Completion Criteria
本计划完成的标志是:
1. `G1` 定义被正式收紧
2. 4 个边界样本完成正式重排
3. `高低压新增报装容量月度统计表` 被确定为 `G1-E`
4. `电能表现场检验完成率指标报表``计量资产库存统计``95598供电服务月报` 不再继续作为 `G1` 样本使用
5. 后续开发顺序固定,不再反复讨论边界归属