Guizang PPT Skill：直接在 Claude Code 中製作令人驚豔的 HTML 投影片

你是否曾經想將一篇長文、一份產品分析，甚至一篇個人散文，變成真正設計精美的投影片簡報——而不用打開 PowerPoint 跟文字方塊搏鬥？你不孤單。這正是 Guizang PPT Skill 要解決的問題。這個由 AI 思想家歸藏建立、並在實際線下演講中反覆打磨的開源 Skill，可在 Claude Code、Codex 及類似 agent 環境中執行，產生漂亮且單一檔案的 HTML 簡報。它也不只是玩具：內建兩套視覺系統、22 種鎖定版面、完整的簡報者模式，甚至可選用 AI 圖片生成來處理封面與圖表。

為什麼用 HTML 而不是 PPTX？

整個專案建立於一個簡單的賭注：HTML 是 AI agent 製作投影片的理想格式。因為 HTML 與 CSS 是純文字，agent 可以直接讀取、編輯並驗證檔案。和 Markdown 投影片簡報不同，HTML 提供像素級版面控制、動畫與響應式設計。與 PPTX 不同，最終輸出是可以在任何瀏覽器開啟、簡報、截圖或傳給同事的單一檔案。不需要建置步驟、不需要伺服器，更沒有相依性地獄。

但最大的優勢是品質控管。這個 Skill 包含驗證腳本，會檢查版面溢出、對齊，以及圖片是否保持在預期的位置。也就是說，AI 不是隨便猜測；當 Playwright 可用時，它會測量真實渲染的結果。

兩種視覺風格，對應不同故事

Skill 配備兩套樣式系統。Style A 名為「電子雜誌 × 電子墨」。想像 Monocle 雜誌融合簡約的程式碼美學。它非常適合敘事、觀點、個人分享，以及任何重視個人特色的場合。此風格有十種彈性版面，可處理章節開場、資料陳述頁、圖片網格、流程與比較。你可以從五種墨色主題中選擇：經典墨、靛青瓷、森林墨、牛皮紙與沙丘。

Style B 則走向另一條路：瑞士國際風格。它講究嚴謹的網格、一個高飽和度主色、直角、極細分隔線，以及戲劇化的字級層級。這種風格是為了事實、產品、分析與方法論而生。一共有 22 種鎖定版面，從封面與陳述，到 KPI 塔、迴圈圖、雙欄比較與結尾宣言。提供四種主色主題：克萊因藍、檸檬黃、檸檬綠與安全橘。如果你要求做一份瑞士風格簡報卻沒有指定顏色，agent 預設會推薦克萊因藍。

這種雙系統意味著你不必每次都重新發明設計的輪子。只需要說出你想要的調性，Skill 就會維持一致的視覺系統——包括像不得自訂 HEX 色碼這類嚴格規則，因為維護設計美感比讓任何人隨意配色更重要。

30 秒快速開始

安裝過程簡單得令人耳目一新。建議使用的一行指令如下：

如果你比較想讓 AI 全權處理，請把以下內容貼到 Claude Code、Cursor 或任何具有 shell 存取權限的 agent 中：

幫我安裝 guizang-ppt-skill。請將 https://github.com/op7418/guizang-ppt-skill 複製到 ~/.claude/skills/guizang-ppt-skill，安裝完成後檢查 SKILL.md、assets/、references/ 是否存在。

若是要走手動安裝，只需要執行：

安裝完成後，當你提出像這樣的要求時，Skill 就會自動觸發：

真正的實際工作流程

真正的魔法在於，這個 Skill 是結構化的工作流程，而不是模糊的提示。當你要求一份投影片時，agent 會逐步執行：選擇風格、透過七個問題釐清需求、從 assets/template.html 或 assets/template-swiss.html 複製合適的範本、依節奏表填入內容、視需求產生圖片、建立講者備註、執行驗證檢查，最後在瀏覽器中預覽投影片。

一個典型的要求可能是：「幫我把這份產品分析文件做成電子雜誌風 PPT，重點突出觀點和敘事節奏。」接著，agent 就會產生一份使用電子雜誌範本的單一 HTML 投影片，內建頁面轉場、主題色、講者備註與簡報者執行環境。

真正實用的簡報者模式

其中一個出乎意料深入的實用功能是內建的簡報者模式。點擊右下角的 P，投影片會開啟一個專屬的簡報者檢視，同時在另一個分頁開啟乾淨的觀眾視窗。你可以看到目前與下一張投影片的即時 16:9 預覽、包含目的與重點的結構化筆記、記錄已用時間與整體節奏的計時器，以及會在本機記錄每頁實際耗時的排練模式。還有雷射筆、繪圖螢光筆與一鍵黑屏／白屏等實用工具。就算網路斷線，這些功能也不會受影響——這一切全部都是本機 HTML 與瀏覽器 API，而不是雲端服務。

AI 生成圖片與封面素材

在 Codex 中，Skill 能運用 GPT-Image 2.0 / GPT-M 2.0，生成紀錄片風格照片、資訊圖表、流程圖、系統圖與 UI 示意圖。關鍵原則是：圖片是嵌入的素材，而不是獨立的海報——因此不該附加頁尾、標題或裝飾性邊框。Skill 也懂得利用內建的背景素材庫，把凌亂的螢幕截圖重新設計成乾淨的簡報素材。當你需要一致的視覺，又不想手動重做每一張投影片時，這項功能真的是一大救星。

除了投影片，同一套視覺系統也能延伸到社群封面。你可以產生 21:9 的微信公眾號首圖、1:1 的分享卡、3:4 的小紅書封面，或 16:9 的橫式影片封面——全部都與簡報的主題色和字體排版一致。

何時使用（以及何時不使用）

Guizang PPT Skill 在線下演講、內部簡報、AI 產品發表會與 Demo Day 等場合非常出色，也適合任何帶有強烈個人色彩的演說。它不太適合塞滿資料的試算表儀表板、教育訓練教材，或需要大量即時協作的簡報，因為從設計上來說，輸出就是一份靜態 HTML 檔案。

這個專案的設計哲學令人耳目一新：克制勝過花俏、結構勝過裝飾，圖片則是一等公民，並具有穩定的長寬比。如果你的機器跑不動，可以按下 B 停用 WebGL/canvas 動畫，進入低負載的靜態模式。

接下來該往哪裡去

Guizang PPT Skill 是一個開源專案，並有活躍的開發藍圖，包括更多案例研究、更多瑞士式驗證規則，以及擴充的封面規格。如果你曾希望你的 AI 助手能直接把投影片做好，那這個穩健工具今天就能一試。用上述 npx 指令安裝，把文章交給 agent，然後看它產生一份精美的 HTML 投影片——當場就能從瀏覽器開始簡報。