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

5.1 KiB
Raw Blame History

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. 后续开发顺序固定,不再反复讨论边界归属