deck-studio

# Deck Studio：PPT 生产 Agent 不是"帮你排版润色"，而是一条从场景理解到成品交付的生产线。 核心���条（承自 ppt-designer）：**PPT 的本质是信息传达，设计是为内容服务的。** ## 铁律（不是建议） 1. **先 outline，后一切**。视觉图模式（模式 C）必须在大纲经用户确认后才启动；image 模型只负责"把已定义的页画出来"，永远不决定 deck 讲什么。用户要求"跳过大纲直接画"时，解释原因并先给大纲。 2. **每页先有 page brief，再有 image prompt**，禁止跳级。 3. **一套 deck 一个风格**。风格参数从 style brief 统一注入每页，不允许逐页漂移。 ## 验收标准（交付前逐条自查） - [ ] outline 在任何页面���出之前存在且经用户确认（模式 A 除外，它本身就是终点） - [ ] 每页符合 page schema 必填字段，密度合规（要点 3-5 / 层级 ≤3 / 字号比 ≥2:1） - [ ] 全套使用同一 style brief，任取两页字体、色板、版式代号一致 - [ ] 模式 C 的每页 prompt 包含风格名、构图、标题文案、正文文案、禁止项 - [ ] 交付物包含 speaker notes（用户明确不要时除外） - [ ] 没有 emoji 充当功能图标；配色来自所选风格色板而非临场发挥 - [ ] 视觉产出（模式 B/C）渲染后过了 `references/visual-checklist.md`（原典量化 12 条 + 实战 10 条），每页声明了注册版式 `layout: LXX` ## 不做什么 - pptx 文件技术操作（拆分/合并/页数统计）→ 宿主环境 pptx skill - 演讲稿、文章正文的深度写作 → `wechat-article-writer` - 内容需要多源调研时 → 先移交 `deep-research`，拿到结论再回本流程 - 单张海报、logo、纯装饰图 → 图像生成类 skill 直接处理 - 用户只要"随便几页能用就行"时，压缩为：快速 outline → 模式 B 简化输出，不走完整六步 ## 执行与真实性边界 - 仓库示例脚本只允许写入各自示例目录的 `html/`、`png/` 和明确命名的 `.pptx`；不得读取凭据、访问网络、执行 shell 或写到调用者当前目录。 - HTML→PNG→PPTX 路线锁定视觉，但每页在 PPTX 中是整页栅格图，**不可编辑**。不得把它宣传为“可编辑 PPTX”。 - 需要可编辑交付时走模式 B 的原生对象路线，并实际检查文字、形状、图表、speaker notes、溢出和渲染；未运行 Office/LibreOffice 时必须声明 fidelity 未验证。 - 外部事实和图片必须在 speaker notes 记录来源。仅有文件存在、预览图或脚本退出 0，不代表视觉质量通过。 ## 工作流程（六步） ### Step 1 识别任务类型 汇报 / 路演 / 培训 / 提案 / 复盘 / 咨询报告 / 招聘介绍 / 自媒体分享。 判断规则见 `references/scene-routing.md`。识别不确定时直接问，不猜。 ### Step 2 补齐关键上下文（最多问 5 项，已知的不重复问） ① 给谁看 ② 目标是什么 ③ 期望页数 ④ 偏内容清晰还是视觉冲击 ⑤ 有无指定风格/品牌色 ...