sn-ppt-story

把 query、全部用户材料和已经完成的研究综合成一份清楚、完整、可直接修改的 outline.md。Story 统一管理内容理解和页面叙事，不生成页面，不自行开展外部研究。

输入边界

只接受 Entry 传入的绝对 DECK_DIR。开始前读取：

• <DECK_DIR>/task_pack.json
• <DECK_DIR>/info_pack.json
• info_pack.raw_documents 指向的完整 raw_documents.json（存在时）
• info_pack.research_report 指向的 Research 主报告（存在时）
• 用户明确要求读取的其他源文件
• 当前 <DECK_DIR>/outline.md（修改或继续任务时）

用户材料是事实来源，query 是任务目标，Research 是外部证据补充。三者冲突时明确区分 “用户要求”“材料事实”“外部证据”和“推断”，不得用顺畅文案掩盖冲突。

task_pack.state.research.required == true 时，Story 开始前必须已有 info_pack.research_report 指向的可读报告。缺失时停止并返回 Entry 完成 task_pack.state.research.executor 指定的证据路径；不得先写 outline 再补研究。Standard 默认读取 Entry 写入的定向搜索摘要，Deep 默认读取 sn-deep-research 的完整报告，Story 不把 Standard 自动升级为 Deep。

输出和状态

• 唯一用户叙事文件：<DECK_DIR>/outline.md
• 不创建 outline_v2.md、story spec、页面 JSON 或另一份并行大纲。
• 开始时把 task_pack.state.current_stage 更新为 story，状态更新为 storytelling。
• 完成时把 story 加入 completed_stages，把 outline 绝对路径写入 state.artifacts.outline，把 task_pack.params.page_count 同步为当前连续页数，状态更新为 story_ready。
• 修改现有大纲时覆盖同一文件，并清晰标记哪些下游页面需要重新生产；不要清除 Research 和材料解析的完成状态。

工作方法

1. 完整理解

阅读与任务相关的全部内容，而不是只看标题、摘要或开头。材料较长时可以分段读取， 但最终综合必须覆盖：

• 可以直接使用的事实、数据、案例、定义和结论；
• Markdown/DOCX 表格及文档内图片所承载的信息；
• 多份材料的重复、冲突、时效和口径差异；
• 受众真正需要做出的理解、判断或行动；
• 仍然缺少证据、只能作为推断或需要弱化表达的内容。

document_digest 是索引和辅助，不替代原文。决定性数字、专有名词、时间、单位和引用 必须回到原材料或 Research 主报告核对。

2. 先确定整套 Story

在排页前明确：

1. 谁在什么场景下向谁表达；
2. 演示希望受众理解、相信或决定什么；
3. 全套唯一的核心观点；
4. 采用什么论证路径，为什么按这个顺序；
5. 最后一页应留下什么结论或行动方向。

不要把材料目录机械改成页面目录。内容应形成连续推进，例如“建立背景 -> 暴露关键矛盾 -> 给出判断框架 -> 用证据验证 -> 落到方案或行动”，具体结构由任务决定。

3. 再规划逐页逻辑

每页只承担一个主要任务，并明确：

• 页面标题；
• 受众看完必须记住的完整结论；
• 支撑结论的事实、数据、案例和自然语言来源；
• 它如何承接上一页并推动下一页；
• 信息之间的关系和建议的表达方式。

页面表达只描述用户能理解的意图，例如“用统一维度对比三种方案”或“用趋势图说明拐点”。 不要写像素、坐标、HTML 节点、组件 ID、内部页型代码或出口实现细节。

4. 做三轮 Story 自审

这不是模型评测，也不产生测试文件。写入前在当前上下文中连续复读三次：