sn-ppt-story

1# sn-ppt-story
2 
3把 query、全部用户材料和已经完成的研究综合成一份清楚、完整、可直接修改的
4`outline.md`。Story 统一管理内容理解和页面叙事，不生成页面，不自行开展外部研究。
5 
6## 输入边界
7 
8只接受 Entry 传入的绝对 `DECK_DIR`。开始前读取：
9 
10- `<DECK_DIR>/task_pack.json`
11- `<DECK_DIR>/info_pack.json`
12- `info_pack.raw_documents` 指向的完整 `raw_documents.json`（存在时）
13- `info_pack.research_report` 指向的 Research 主报告（存在时）
14- 用户明确要求读取的其他源文件
15- 当前 `<DECK_DIR>/outline.md`（修改或继续任务时）
16 
17用户材料是事实来源，query 是任务目标，Research 是外部证据补充。三者冲突时明确区分
18“用户要求”“材料事实”“外部证据”和“推断”，不得用顺畅文案掩盖冲突。
19 
20`task_pack.state.research.required == true` 时，Story 开始前必须已有
21`info_pack.research_report` 指向的可读报告。缺失时停止并返回 Entry 完成
22`task_pack.state.research.executor` 指定的证据路径；不得先写 outline 再补研究。Standard
23默认读取 Entry 写入的定向搜索摘要，Deep 默认读取 `sn-deep-research` 的完整报告，Story
24不把 Standard 自动升级为 Deep。
25 
26## 输出和状态
27 
28- 唯一用户叙事文件：`<DECK_DIR>/outline.md`
29- 不创建 `outline_v2.md`、story spec、页面 JSON 或另一份并行大纲。
30- 开始时把 `task_pack.state.current_stage` 更新为 `story`，状态更新为 `storytelling`。
31- 完成时把 `story` 加入 `completed_stages`，把 outline 绝对路径写入
32  `state.artifacts.outline`，把 `task_pack.params.page_count` 同步为当前连续页数，状态更新为
33  `story_ready`。
34- 修改现有大纲时覆盖同一文件，并清晰标记哪些下游页面需要重新生产；不要清除
35  Research 和材料解析的完成状态。
36 
37## 工作方法
38 
39### 1. 完整理解
40 
41阅读与任务相关的全部内容，而不是只看标题、摘要或开头。材料较长时可以分段读取，
42但最终综合必须覆盖：
43 
44- 可以直接使用的事实、数据、案例、定义和结论；
45- Markdown/DOCX 表格及文档内图片所承载的信息；
46- 多份材料的重复、冲突、时效和口径差异；
47- 受众真正需要做出的理解、判断或行动；
48- 仍然缺少证据、只能作为推断或需要弱化表达的内容。
49 
50`document_digest` 是索引和辅助，不替代原文。决定性数字、专有名词、时间、单位和引用
51必须回到原材料或 Research 主报告核对。
52 
53### 2. 先确定整套 Story
54 
55在排页前明确：
56 
571. 谁在什么场景下向谁表达；
582. 演示希望受众理解、相信或决定什么；
593. 全套唯一的核心观点；
604. 采用什么论证路径，为什么按这个顺序；
61…