sn-ppt-entry

1# sn-ppt-entry
2 
3统一接收 PPT 生成请求，建立唯一任务目录，准备材料。Standard 先完成定向外部证据补充，
4Deep 先完成完整 Research，**下一步必须调用 `sn-ppt-story` 生成公共 `outline.md`**，再按 `choices.output` 分发到 `sn-ppt-standard`、`sn-ppt-dazzle` 或 `sn-ppt-creative`。
5 
6这是一套 Skill 的入口，不是独立运行时。文本理解、视觉理解和推理使用宿主 Agent
7已有能力。普通搜索、图片搜索和图片生成优先使用宿主原生工具；原生能力不存在或实际
8调用不可用时，才使用 PPT 整包自带的 `sn-ppt-tools`。不得要求用户另外配置模型客户端，
9不得调用 `model_client.py`、`stage.py` 或为本流程再造 CLI 调度层。
10 
11## Box-Agent 兼容入口
12 
13在 Box-Agent 中，从本次加载的 Skill 提示取得 Entry 的绝对 Skill Root，记为
14`<ENTRY_SKILL_ROOT>`。Entry 的所有确定性脚本都必须使用
15`python "<ENTRY_SKILL_ROOT>/scripts/<name>.py"` 调用；禁止使用 `$SKILL_DIR`、当前工作目录
16或相对的 `skills/` 路径。所有任务产物仍必须写入同一个绝对 `$DECK_DIR`，并在调用 Story
17和出口 Skill 时逐字复用该路径。
18 
19## 三个独立选择
20 
21### 执行深度
22 
23- `draft`：尽快形成可看的方向稿。默认不做外部事实搜索，大纲完成后直接生产。
24- `standard`：质量和等待时间平衡。Story 前由 Entry 做定向外部搜索和证据补充，不运行
25  完整 `sn-deep-research`；生成前让用户看 `outline.md`。
26- `deep`：先完成 `sn-deep-research`，再生成正式 `outline.md`；生成前让用户确认。
27 
28Entry 根据任务复杂度、事实时效性、材料完整度和用户措辞推荐一档，同时展示
29Draft / Standard / Deep。用户可以覆盖；用户未覆盖时采用推荐，不为这个选择增加一轮
30阻塞问答。
31 
32### 输出格式
33 
34- `static_html` -> `sn-ppt-standard`
35- `dynamic_html` -> `sn-ppt-dazzle`
36- `creative` -> `sn-ppt-creative`
37 
38用户提供已有 PPTX、模板或半成品并要求修改时，直接进入 `sn-ppt-edit`，不是先走生成
39出口。Static HTML 仍由 `sn-ppt-standard` 自己后处理（默认导出 PPTX）。Entry 只负责路由、验证真实文件并登记 artifact。
40 
41### 设计丰富度
42 
43- `restrained`（克制）：政企、学术、法务、财务或明确要求简洁。
44- `rich`（丰富）：默认，适合多数业务汇报、产品介绍和正式演示。
45- `high_creative`（高创意）：发布会、品牌传播、创意提案或明确要求强视觉。
46 
47用户明确指定时直接采用；否则结合场景、受众、输出格式和措辞推荐。显示当前选择与
48三档名称，但不单独阻塞。用户在生成前、确认大纲时或后续修改中覆盖时，更新同一份
49…