| name | ppt-page-plan |
| description | 当只需要重做某一页的页面目标、内容块、布局方向或视觉需求,而不希望重跑整套 storyboard 时使用。 |
PPT 单页规划
ppt-review 发现某页叙事角色、内容块或布局方向有问题时,进入本 skill 做最小范围的页面级规划修正。
目标
仅修改指定 page_id 对应的页面规划,并保持整套叙事连贯。
触发条件
ppt-review 判定某页 narrative_role 模糊或与上下页重叠
ppt-review 判定某页 payload_budget 与实际内容不匹配
ppt-review 判定某页 content_blocks 缺失或冗余
ppt-review 判定某页 layout_intent 与页面类型冲突
- 用户主动要求重新规划某一页
输入
storyboard.json(必须已存在且可读)
- 指定
page_id
- 用户补充要求(如有)
- 可选的
style-spec.json(用于确认 style_variant 映射)
- 可选的
task-pack.json(用于确认 content_density_profile)
输出
- 更新后的
storyboard.json,仅修改目标 page_id 对应的 StoryboardPage 对象
- 对其他页面的最小影响说明(如果有)
执行规则
1. 依赖检查
- 读取
storyboard.json,确认 page_id 存在且锚点有效。
- 如果
page_id 不存在或页面锚点已失效,停下并反馈,不要猜测。
- 读取
style-spec.json,确认目标页引用的 style_variant 在 page_type_variants 中存在。
2. 问题诊断
- 对照
ppt-review 的问题描述或用户要求,定位需要修改的字段。
- 可修改的字段范围:
title、narrative_role、audience_takeaway、layout_intent、style_variant、payload_budget、content_blocks、visual_requirements、data_requirements、asset_requirements、unresolved_issues、presenter_intent。
- 不可修改的字段:
page_id、page_number、section(除非用户明确要求换章节)。
3. 内容块调整
- 如果需要增减
content_blocks,必须同步更新 payload_budget 中的 claim_count、evidence_count、structure_block_count。
- 新增的
content_blocks 必须填写 source_claim_ids 和 source_evidence_ids,引用 research-pack 中实际存在的条目。
- 删除的
content_blocks 对应的内容应说明去向(合并到其他块、移到其他页、或确认不需要)。
4. payload_budget 调整
- 必须参照
task-pack.json.content_density_profile 和 style-spec.json.density_rules 重新评估预算。
analysis-heavy 页允许更高预算;showcase-light 页可适当降低但不能为零。
- 调整后的预算必须与
content_blocks 实际数量和深度匹配。
5. 影响范围评估
- 检查上一页的
audience_takeaway 是否仍然能平滑过渡到本页。
- 检查下一页的
narrative_role 是否因本页变化而需要调整。
- 如果存在影响,在输出中明确列出需要同步更新的最小页面范围,但不主动修改其他页面。
6. 写回
- 仅覆盖
storyboard.json 中目标 page_id 对应的对象,其他页面保持不变。
- 写回后验证 JSON 格式正确、
total_pages 未变。
可处理的问题类型
- 叙事角色模糊:
narrative_role 过于宽泛或与相邻页重叠
- 内容块不足:
content_blocks 数量少于 payload_budget 要求
- 内容块冗余:承载了不属于本页的内容
- 布局方向错误:
layout_intent 与 style_variant 的 layout_shell 冲突
- 资产需求缺失:
asset_requirements 未覆盖页面语义所需的图片或插画
- 视觉需求不清:
visual_requirements 描述模糊,无法指导 ppt-page-html
用户回显
- 开始反馈:说明当前锁定的
page_id 和本次只会调整该页规划。
- 完成反馈:总结本页规划变化、是否影响相邻页,以及
下一步。
关键原则
- 消费前必须先确认
storyboard.json 真实存在且可读。
- 如果目标文件不存在、
page_id 不存在或页面锚点已失效,先补齐依赖,不要猜测。
- 只修这页,不重跑整套。
- 保持
page_id 稳定,便于前端回填。
- 如果页面改动会影响上下页过渡,明确指出需要同步更新的最小范围。
style_variant 必须引用 style-spec.json 中已声明的 variant,不要重新发明名称。
asset_requirements 必须用可指导分流的提示(如 real-photo、svg-illustration、svg-icon),不要写模糊描述。
禁止事项
- 不要重跑整套 storyboard。
- 不要修改其他
page_id 的内容。
- 不要更改
page_id 或 page_number。
- 不要在没有
research-pack 引用的情况下伪造 source_claim_ids 或 source_evidence_ids。
- 不要把
payload_budget 全部清零以"简化"页面。
- 不要因为修改困难就建议整套重做。