DeckMason: AI 演示文稿工作流
摘要：根据主题、文档或大纲创建可用于生产环境的 HTML 幻灯片组。本文档是 6 阶段工作流的入口点。请先阅读本文，然后按需加载引用文件（进入每个阶段时）。不要一次性加载所有引用文件。
需要一个具备文件系统访问权限的 AI 编码代理：Claude Code、Cursor、Codex CLI、Windsurf、Aider，或任何能读取文件和运行脚本的代理。
输出质量标准
每一份演示文稿都应感觉像是顶级 SaaS 营销页面或社论版面。干净、自信、简洁、专业。没有 AI 垃圾内容。没有通用渐变。没有填充文案。
快速开始
新建演示文稿：
"创建一个关于 [主题] 的宣传 Deck"
"为 [受众] 制作一个关于 [主题] 的演示文稿"
使用你自己的内容：
"将这些笔记变成幻灯片：[粘贴内容]"
"将此大纲样式化为演示文稿"
使用品牌：
"使用 company-deck.pptx 中的品牌创建演示文稿"
"为这个宣传 Deck 匹配 https://linear.app 的风格"
导入现有的 PPTX：
"将 company-deck.pptx 转换为 HTML 演示文稿"
预飞行范围界定（在生成任何 Deck 之前）
在编写任何幻灯片之前，先锁定审美方向。仅当用户未给出明确答案时才跳过问题。如果跳过，请明确重述假设。
步骤 0：视觉预览（首选路径）
使用 3 种不同主题快速生成 3 张视觉预览幻灯片，供用户直观选择方向：
python3 scripts/preview_themes.py "你的主题在这里"
这将在 previews/ 目录下创建 3 个单页 HTML 文件：
previews/preview-1-dark.html（深空主题）previews/preview-2-light.html（现代 SaaS 主题）previews/preview-3-bold.html（大胆信号主题）
告诉用户打开这 3 个文件并选择一个方向。所选方向将成为审美方向（步骤 1），跳过下面基于文本的方案。
步骤 1：审美方向（文本备用方案）
如果用户更倾向于文本，请针对该特定主题和受众提出 3 个视觉方向。不是来自固定的预设列表。每个选项应结合一个氛围词 + 一个具体的视觉提示（调色板、字体、图案），以便用户直观感受。这三个方向必须在感觉上有显著差异，而不是同一想法的三种变体。标记其中一个为推荐。
对于每个方向，说明颜色调和（单色、类似、互补、分割互补、三色、中性+强调色）、色温（暖、冷、中性）以及60-30-10 分布（哪种颜色是主色、次色、强调色）。这迫使在设计阶段就做出颜色决策，而不是事后才考虑。
步骤 2：页数
提供选项区间：
- 3-5 页：简短/预告
- 6-10 页：标准
- 11-20 页：深入探讨
- 自定义：用户指定
步骤 3：每页文本密度
四个级别之一：
- 最少：一行文字或一个大数字
- 轻量：标题 + 2-3 个要点
- 标准：标题 + 4-5 个要点
- 密集：多列或详细参考内容
步骤 4：动效
静态、微妙的现场审阅动效，或单独的视频素材。对于 PDF、PPTX、Google Slides 以及预读类的 Deck，默认选择静态。
关于 GSAP 驱动的动画模式（渐入向上、交错显示、裁剪路径显示、缩放进入、左右滑入、模糊进入），请参阅 references/animation-patterns.md。当用户希望进行实时 HTML 审阅或类似 Keynote 的播放时使用这些模式。
只有在这些内容都锁定之后，才能继续到提纲阶段。
6 阶段工作流（概览）
阅读此概览以了解整个流程。在进入每个阶段时加载相应的引用文件。
| 阶段 | 名称 | 作用 | 引用文件 |
|---|---|---|---|
| 预飞行 | 范围界定 | 视觉预览或 4 个文本问题：审美方向、页数、文本密度、动效 | 本文件（上文） |
| 0 | 简报 | 记录请求、默认设置和假设。编写包含受众、叙事弧、核心诉求和成功标准的简报。还涵盖 PPT 导入工作流。 | references/phase0-brief.md |
| 1 | 结构 | 金字塔原理、断言-证据标题、论文、对比节拍、产品设计层级 | references/phase1-structure.md |
| 2 | 提纲 | 页面类型分类法、10 种编辑布局类型、幻灯片数量缩放 | references/phase2-outline.md |
| 3 | HTML | 画布缩放架构、视口适配、垂直预算数学、一页一想法、HTML 结构、动画模式、DOM 规则、网格比例 | references/phase3-html.md |
| 4 | 图片 | 7 种命名图片角色、图片类型分类法、图片幻灯片模式、图表反模式 | references/phase4-images.md |
| 5 | 打磨 | 页面节奏、字体层级、色彩理论系统、AI 痕迹、行业约束、语音指导、设计师眼光审视、叙事主线 | references/phase5-polish.md |
| 6 | 导出 | PPTX（python-pptx 或 pptxgenjs）、PDF、Vercel 部署 | references/phase6-export.md |
专用模式（按需加载）
- 电影幻灯片模式：22 秒影片片段，包含 5 个场景，用于工作流演示
- 瑞士国际严格模式：受 Vignelli 启发的超洁净网格设计
- 社论网页 Deck 模式：杂志风格的 Keynote Deck
- HTML 幻灯片模板库：来自
beautiful-html-templates的 32 个生产级模板 - 主题变体协议：锁定之前提供 3 个不同的视觉方向
- 设计哲学学派系统：针对模糊需求提供 5 个学派
- 演讲者备注叠加层：N 键切换，每张幻灯片自动更新
- 品牌导入工作流：从 PPTX、网站 URL 或品牌指南 PDF 中提取主题
所有专用模式的完整详细信息：references/specialized-modes.md
质量护栏（交付前加载）
所有质量护栏、禁用词、数据垃圾规则、30% 文案裁剪规则、交付前自查、故障排除和需求：references/quality-guardrails.md
风格预设
参见 STYLE_PRESETS.md 以获取 31 种精选风格（11 种原始 + 20 种扩展）以及 Kami 温暖编辑风格：
原始 11 种： Modern SaaS（默认）、Neon Cyber、Midnight Executive、Deep Space、Terminal Green、Paper & Ink、Swiss Modern、Soft Pastel、Warm Editorial、Brutalist、Gradient Wave
扩展 20 种： Bold Signal、Electric Studio、Creative Voltage、Dark Botanical、Notebook Tabs、Pastel Geometry、Split Pastel、Vintage Editorial、Liquid Glass Bento、Engineering Blueprint、Watercolor Map、Golden Serif Quote、Chalkboard Lesson、Exploded Layer Stack、Hyperreal Product、Summary Infographic、Cobalt Grid、8-Bit Orbit、Raw Grid、Broadside
Kami 温暖编辑： 适用于印刷质量的纸质风格 Deck 的完整编辑规范。参见 STYLE_PRESETS.md 中的 Kami 部分。
完整的 CSS 和字体细节在 STYLE_PRESETS.md 中。
如何阅读此技能
- 首先阅读此文件。它包含快速开始、预飞行范围界定和 6 阶段概览。
- 在进入每个阶段时按需加载引用文件。不要一次性加载所有引用文件。
- 在交付任何 Deck 之前，加载
references/quality-guardrails.md并运行自查清单。 - 对于专用模式（电影、瑞士严格、社论网页等），仅在用户请求该模式时加载
references/specialized-modes.md。 - 对于 GSAP 动画，当用户希望动效超越标准 CSS 过渡时，加载
references/animation-patterns.md。
这种渐进式信息结构可节省上下文令牌。原始的单文件 SKILL.md 为 1,195 行。此入口点约为 200 行。每个引用文件仅在需要时加载。
导出快速参考
# PPTX 导出（路径 A：python-pptx，基于图像）
python3 scripts/pptx_export.py presentation.html --output presentation.pptx
# PPTX 导入（将现有 .pptx 转换为 DeckMason 的 JSON）
python3 scripts/pptx_import.py input.pptx --output decks/input_deck.json
# 视觉预览（3 个主题供用户选择）
python3 scripts/preview_themes.py "你的主题"
# PDF 导出（无头 Chrome）
chrome --headless --print-to-pdf=presentation.pdf --run-all-compositor-stages-before-draw --virtual-time-budget=5000 presentation.html
# Vercel 部署（实时 URL）
npx vercel
需求
- 一个具备文件系统和终端访问权限的 AI 编码代理
- 任何有能力的 LLM 后端
- Python 3 +
python-pptx用于 PPTX 导出路径 A（pip3 install python-pptx） - Node.js +
pptxgenjs用于 PPTX 导出路径 B（npm install pptxgenjs） - 现代浏览器（Chrome/Edge/Firefox/Safari）
无需额外的 API 密钥。所有内容在本地运行。
npm 安装（可选）
# 快速开始，无需克隆
npx deckmason init [目录]
# 全局安装
npm install -g deckmason
deckmason init
deckmason themes
deckmason preview "你的主题"
deckmason import company-deck.pptx
有关完整的 npm 说明，请参阅 README.md。