Decks — 用「在幻灯片下面写评论」的方式做演示文稿

技能简介

Decks 是一套面向 AI 编程 Agent 的演示文稿制作技能（Claude Code / Codex 直接可用），把做 PPT 变成对话式的评审流程：你在某页幻灯片下面留一条评论，Agent 改页面，然后在同一页回复你——说明它改了什么、问你一个问题，或者解释为什么某处故意不动。作者是 StrategyU 的咨询顾问培训师，他把自己的整套方法论（结论先行、幽灵稿、行动标题、横纵流、五秒测试、十秒测试）写进了技能的 SKILL.md，让 Agent 每次写页面、改页面都按这套原则执行，而不是随手排版。

核心能力

• 评论驱动改稿：每页幻灯片下方即评论区，Agent 的回复也贴在页面上，评审痕迹不丢失。
• 结论先行：先给建议，再给证据；只有听众强烈怀疑时才倒过来铺陈。
• 幽灵稿先行：先把每一页的标题按顺序写出来，再动手做页面——这是修故事线最便宜的时刻。
• 行动标题：标题必须是完整句子并说出观点（「Q3 营收增长 22%，由企业版扩张驱动」而不是「Q3 营收」）。
• 纵流与横流校验：纵流保证正文能证明标题，横流保证只读标题也能讲完整故事。
• Checks 检查面板：把五秒测试、十秒测试、标题测试、横纵流检查做成按键，随时自查。
• 单文件成稿：每份 Deck 是本地一个独立 HTML 文件，带自己的 git 历史，可全屏演示、可导出 PDF。
• 客户版导出：Client copy 只保留幻灯片本身，方便直接发给客户。
• 本地优先：服务只跑在你自己机器上，除模型调用外不外传任何内容。

安装配置

1. 一句提示安装：让 Agent 克隆仓库到 ~/decks，执行 ./setup.sh，然后用 python3 server.py 启动服务并打开 http://localhost:8790。
2. 手动安装：git clone decks && cd decks && ./setup.sh && python3 server.py。
3. 环境要求：Python 3.9+、Node.js 18+、git（可选，用了才有版本历史）；截图、审计、PDF 导出与缩略图需要 Node.js + 无头 Chrome，setup.sh 会安装 playwright-core 并在找不到 Chrome 时下载约 150 MB 的 Chromium。
4. Linux 上截图或 PDF 失败时，补装系统库：(cd tools && sudo npx playwright-core install-deps chromium)。

使用步骤

1. 首次启动后 ~/slide-decks/ 会生成 Deck 注册表与一份练习用的示例稿。
2. 告诉 Agent 你要做什么、给谁看、希望对方记住哪一句话。
3. 用 ./sb new 建稿，Agent 先按幽灵稿方式列出全部标题给你确认。
4. 确认故事线后开始建页，在浏览器里边看边在页面下留评论。
5. 说「process changes」（或点页面上的 Ask Claude）让 Agent 处理本轮修改，它会在页面上逐条回复。
6. 定稿后导出 PDF 或用 Client copy 生成客户版。

适用场景

• 咨询/方案汇报：需要多层论证结构与严谨故事线的商业提案。
• 融资与销售材料：强调结论先行、每页一个观点的对外材料。
• 内部复盘与评审：用 Checks 面板自查逻辑漏洞，替代人工逐页挑错。
• 教学与培训：边做边学方法论，Agent 同时充当执行者与教练。
• 个人日常做稿：不想再打开 PowerPoint 手动对齐文本框的独立工作者。

适用人群

• 咨询顾问、战略与商业分析岗
• 需要频繁做汇报的产品经理与创业者
• 使用 Claude Code / Codex 且愿意用命令行工具的知识工作者
• 讲授结构化表达与幻灯片方法论的培训师

工作原理

Decks 由三部分组成：server.py（仅用 Python 标准库，负责服务页面、保存状态、提供 sb 使用的 JSON API）、sb 命令行（Agent 的操作入口）与 tools/browser.mjs（无头 Chrome 完成标题提取、编辑、提案、截图、审计、PDF 与缩略图）。每份 Deck 目录下的 .slidebuilder/ 保存 state.json（评审者的编辑、评论、页序）与 review.json（Agent 的回复、轮次、变更标记与你的决策）；服务只在提供页面时注入一小段启动脚本加载状态，Deck 文件本身保持干净。服务只接受来自自身页面、sb 与无头工具的修改，其它网站无法写入评论或删除稿件。

官方链接

• GitHub：https://github.com/paulmil11/decks
• 方法论来源：https://strategyu.co
• 协议：代码 MIT，模板内容 CC BY 4.0