sn-ppt-creative

1# sn-ppt-creative
2 
3把公共 Story 转译成一套 16:9 整页视觉：每页生成一张完整 PNG，并可组装为 PPTX。
4Creative 负责视觉转译，不负责 Research，不生成自己的内容大纲。
5 
6## 前置与目录边界
7 
8必须存在：
9 
10- `<DECK_DIR>/task_pack.json`
11- `<DECK_DIR>/info_pack.json`
12- `<DECK_DIR>/outline.md`
13- `task_pack.choices.output == "creative"`，或旧任务的 `ppt_mode == "creative"`
14 
15`DECK_DIR` 只能取 `task_pack.deck_dir` 的绝对路径。所有生成产物只写到该目录；不得写入
16用户 home 根目录、宿主 workspace 根目录、Skill 目录、repo、`/tmp` 或另一个 workspace。
17已有任务必须复用原 `DECK_DIR`，不得另建目录。
18 
19把当前 Skill 所在目录记为只读的 `SKILL_ROOT`，把同级 `sn-ppt-tools/` 解析为绝对
20`PPT_TOOLS_DIR`。开始生图前读取
21`$PPT_TOOLS_DIR/references/capability-policy.md`。文本推理、风格判断和视觉理解使用宿主
22Agent 原生能力；图片生成优先使用宿主原生工具，原生能力不存在或一次实际调用失败时，
23才使用 PPT 整包自带的 `image_generate.py`。
24 
25不得调用 `model_client.py`、`sn_agent_runner.py`，不得要求用户在 Agent 外再配置文本或
26视觉模型 API。
27 
28## 公共 Story 契约
29 
30开始和恢复时重新读取磁盘上的 `outline.md`。它固定：
31 
32- 页数、页序和标题；
33- 每页核心结论、内容依据、上屏内容边界和前后关系；
34- 用户明确保留、删除或修改的内容。
35 
36Creative 可以决定视觉隐喻、艺术媒介、构图、页面动势和信息图形语言，但不能：
37 
38- 合并、拆分、增删或重排页面；
39- 改变标题和核心结论的含义；
40- 恢复用户从 outline 删除的内容；
41- 自行搜索事实、补案例或另写 `outline.json`；
42- 因整页生图偏好而牺牲事实、逻辑或文字可读性。
43 
44发现现有材料不足时，保留对应页位并明确缺口，返回 Entry/Story；不得在 Creative 内补做
45Research。
46 
47## 设计丰富度
48 
49读取 `task_pack.choices.design_richness`：
50 
51- `restrained`：收敛构图、材质、文字装饰和视觉隐喻，优先稳定与清晰。
52- `rich`：默认，在清晰信息层级上提供充分画面、页型变化和跨页一致性。
53- `high_creative`：允许更大胆的构图、艺术媒介、英雄页面和视觉动势，但不牺牲文字
54  可读性、事实和 Story。
55 
56丰富度只控制视觉投入，不改变页数、结论和 Research 边界。本发布版不再提供额外的
57Artistic/Classical 分线选择。
58 
59## 产物
60 
61```text
62style_spec.md
63pages/
64  page_001.prompt.txt
65  page_001.png
66  page_002.prompt.txt
67  page_002.png
68...
69<deck_id>.pptx
70```
71…