slice-planner
slice-planner Skill 用在 launched 变更 merge 之后、开始写代码之前。它把已合并规格拆成良构的 [code] 切片,是切片的唯一事实源:切几片、每片做什么,只在这里决定一次。下游的 code-implementor 逐行消费这些切片,不再重新打分或自行分批。
本 Skill 产出结构化的 slices.json,由 openlogos slice plan 写入 tasks.md 的 ## [code] 段与 TEST_SLICE_MANIFEST.json。它不产 delta,不写业务代码,也绝不手工编辑这两个产物。
openlogos next返回proposal_step == "ready-to-implement"且next_node.id == "plan-slices",并且没有gate_id(宿主注入「规划切片」上下文)。next_node.id == "plan-slices",原因为test-slice-manifest-missing/-invalid/-stale(manifest 恢复)。- merge 完成后,用户说「划分切片」「写
[code]」「规划实现任务」。
如果 next_node 同时带有 gate_id: "slice-exit",说明切片已规划、正等待批准,不要再次运行本 Skill。
- 活跃提案已有
SPEC_MERGED(或MERGED)。没有[delta]的纯代码提案也必须先执行openlogos merge <slug>,由这次 no-delta merge 写入带type: "no_delta_spec_complete"的SPEC_MERGED。缺少该 marker 时,状态是spec-complete-required,而不是plan-slices。 - 规格 delta 已合并进主文档,或 no-delta marker 已记录本次无需文档 delta。
- 已有真实测试 ID:已合并的
logos/resources/test/*-test-cases.md(或显式复用声明)中有真实的UT-*/ST-*/SMOKE-*ID。spec-complete 后仍缺测试 ID 时,状态是test-id-required。
禁止用占位 ID 切片。前置条件不满足时停止,并提示用户先完成 merge 或补齐测试 ID。
完整规则见 切片规划规范,要点如下:
- 读已合并规格与真实测试 ID。 读提案范围、已合并的架构 / 场景 / 功能规格与测试用例文件,列出要落地的能力与可用 ID。
- 六维打分。 影响范围、行为复杂度、契约变化、测试规模、风险等级、不确定性,每项 0~2 分。0~7 分:单切片;8 分及以上:尝试垂直拆分。
- 垂直/横向判别器。 每片必须是一条端到端能力线、一个场景或一个子模块的完整闭环。「地基」「管道」「helper」「schema」「写测试」「补 reporter」「仅 UI」这类片名是横向红旗,命中即重切。
- 删后续证伪门。 对每片 i 自问两题:(a) 删掉切片 i+1..N 后 verify 能否变绿?(b) 切片 i 是否交付了端到端、可观察的能力?任一为「否」,就把它向前合并进依赖它的那一片,再重跑本门。
- 逃生口。 评分 ≥8 但没有任何垂直切法能过本门时,保留单切片并写明原因。不确定时一律合并。
- 确定每个切片。 每片自闭环:业务代码 + 该片 UT/ST + OpenLogos reporter + 必要的 golden baseline;排序保证不依赖后续切片;
task_text末尾标注覆盖的真实 ID。提案改动了 smoke 用例时,切片还要列出新增SMOKE-*ID,并要求实现 runner、写smoke-results.jsonlreporter、接入配置、跑 smoke 覆盖预检。 - 写
slices.json并执行命令。
openlogos slice plan --file slices.json成功后从磁盘读回 [code] 段,向用户展示原文。失败时每条违规都会列出 code、path 与 fix_hint,且不写入任何内容;修改 slices.json 后重跑即可。
slices.json
Section titled “slices.json”{ "slices": [ { "slice_id": "slice-01-capability", "task_text": "端到端能力切片:实现 X 并同步 UT/ST + reporter(覆盖 UT-S01-01、ST-S01-01)", "owned_test_ids": ["UT-S01-01", "ST-S01-01"], "runner_selectors": ["UT-S01-01", "ST-S01-01"], "spec_targets": ["logos/resources/test/core-S01-test-cases.md"] } ]}| 字段 | 内容 |
|---|---|
slice_id | 稳定、kebab-case、提案内唯一;推荐 slice-<两位序号>-<短名> |
task_text | [code] 条目文本,末尾标注覆盖的真实 ID |
owned_test_ids | 本变更新增或修改的每个测试 ID 恰好归属一片;禁止占位、通配与不存在的 ID |
runner_selectors | 非空,能执行该片所属测试的 selector |
spec_targets | logos/resources/test/ 下的已合并测试规格文件 |
不要提供指纹、schema、change、module、generated_at,这些由命令写入。
当 openlogos next 因 manifest 缺失、非法或过期而要求 plan-slices 时:
- 不要重新打分或重新切片。 切片划分没有问题,坏的只是 manifest。沿用旧的
slice_id与task_text(从旧 manifest 读取,或按现有[code]条目的顺序重建)。 - 用同一份输入重跑
openlogos slice plan --file <slices.json>。未改动的切片保留勾选,已有 checkpoint 继续有效,不要手工补回[x]。 - 不要删除或改名
TEST_SLICE_MANIFEST.json,不要编辑SLICE_CHECKPOINTS.jsonl或SLICES_APPROVED。 - 某个 ID 无法唯一归属时,报告歧义并停止,不做猜测。
切片划分确实有误时,修改 slices.json 后重跑同一命令即可;文本被改写的切片会重置为未勾选。
| 产物 | 写入者 |
|---|---|
slices.json(输入文件,路径自定) | 本 Skill |
logos/changes/<slug>/tasks.md 的 ## [code] 段 | openlogos slice plan |
logos/changes/<slug>/TEST_SLICE_MANIFEST.json | openlogos slice plan |
proposal.md、[delta]、[deploy] 逐字节不变。
切片写出后,告诉用户切片已就绪,slice-exit 门批准后即可进入实现。openlogos next --auto 模式下该门会自动放行,并写入 SLICES_APPROVED。
请按 slice-planner 规划本提案的 [code] 切片:先读已合并规格与真实测试 ID,六维打分,再用垂直/横向判别器与删后续证伪门逐片自检并写出结论,拆不开就显式单切。把结果写成结构化 slices.json(slice_id / task_text / owned_test_ids / runner_selectors / spec_targets),执行 openlogos slice plan --file <slices.json> 落盘,并读回 [code] 段确认。openlogos slice:写出[code]与 manifest 的命令- 切片规划规范:完整切片规则
- 测试切片清单:manifest、checkpoint 与恢复
- 上一步:
merge-executor/openlogos merge - 下一步:
code-implementor:逐片实现切片