DeckMason：AI 簡報工作流程
摘要：從主題、文件或大綱建立生產等級的 HTML 幻燈片組。此檔案為 6 階段工作流程的進入點。請先閱讀此檔案，然後在進入各階段時按需載入參考檔案。請勿一次載入所有參考檔案。
需要具備檔案系統存取權限的 AI 編碼代理：Claude Code、Cursor、Codex CLI、Windsurf、Aider，或任何能夠讀取檔案與執行腳本的代理。
輸出品質標準
每一份簡報都應呈現出頂級 SaaS 行銷頁面或編輯版面的專業感。乾淨、自信、簡約、專業。杜絕 AI 劣質輸出。避免通用漸層。不使用填充內容。
快速入門
建立新簡報：
"建立一份關於 [主題] 的募資簡報"
"為 [受眾] 製作一份關於 [主題] 的簡報"
使用您自己的內容：
"將這些筆記轉換成投影片：[貼上內容]"
"將此大綱設計成簡報形式"
搭配品牌：
"使用 company-deck.pptx 中的品牌建立簡報"
"為此募資簡報比照 https://linear.app 的風格"
匯入現有 PPTX：
"將 company-deck.pptx 轉換為 HTML 簡報"
預飛航範圍界定（在生成任何簡報之前）
在撰寫任何投影片之前，先鎖定美學方向。只有在使用者尚未給出明確答案時才提問。如果跳過問題，請明確重申您的假設。
步驟 0：視覺預覽（偏好路徑）
使用 3 種不同主題快速生成 3 張視覺預覽投影片，讓使用者透過視覺方式挑選方向：
python3 scripts/preview_themes.py "您的主題"
這會在 previews/ 中建立 3 個單頁 HTML 檔案：
previews/preview-1-dark.html（Deep Space 主題）previews/preview-2-light.html（Modern SaaS 主題）previews/preview-3-bold.html（Bold Signal 主題）
告知使用者開啟這 3 個檔案並挑選一個方向。所選方向即成為美學方向（步驟 1），並略過下方的文字提案。
步驟 1：美學方向（文字回退）
如果使用者偏好文字，請針對此特定主題與受眾提出 3 個視覺方向。不要使用固定的預設清單。每個選項應結合一個風格詞彙與一個具體的視覺提示（色板、字型、主題元素），讓使用者能夠想像。三個方向之間必須有明顯差異，而非同一想法的三種變體。標記其中一個為推薦方向。
對於每個方向，請說明色彩和諧（單色、類似色、互補色、分裂互補色、三等色、中性+強調色）、色溫（暖色、冷色、中性色），以及60-30-10 分佈（哪個顏色是主色、次要色、強調色）。這強制在規劃階段就做出色彩決策，而非事後才補救。
步驟 2：頁數
提供以下區間選項：
- 3-5 頁：簡短/預告
- 6-10 頁：標準
- 11-20 頁：深入探討
- 自訂：使用者指定
步驟 3：每頁文字密度
以下四個級別之一：
- 極簡：一行或一個大數字
- 輕量：標題 + 2-3 個項目符號
- 標準：標題 + 4-5 個項目符號
- 密集：多欄或詳細參考內容
步驟 4：動態效果
靜態、微妙的即時檢閱動畫，或獨立的影片素材。對於 PDF、PPTX、Google Slides 以及預先閱讀的簡報，預設選擇靜態。
如需 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 啟發的超潔淨網格設計
- 編輯網頁簡報模式：雜誌風格的 Keynote 簡報
- 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 Warm Editorial：
原始 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 Warm Editorial：一份完整的編輯規格，適用於印刷品質、紙質風格的簡報。詳見 STYLE_PRESETS.md 中的 Kami 章節。
所有 CSS 與字型詳細資訊請見 STYLE_PRESETS.md。
如何閱讀此技能
- 首先閱讀此檔案。此檔案包含快速入門、預飛航範圍界定以及 6 階段概覽。
- 在進入各階段時按需載入參考檔案。請勿一次載入所有參考檔案。
- 在交付任何簡報之前，載入
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 部署（即時網址）
npx vercel
需求
- 具備檔案系統與終端機存取權限的 AI 編碼代理
- 任何具備能力的 LLM 後端
- Python 3 + 用於 PPTX 匯出路徑 A 的
python-pptx（pip3 install python-pptx） - Node.js + 用於 PPTX 匯出路徑 B 的
pptxgenjs（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。