歸藏 PPT Skill 是開發者歸藏(op7418)維護的開源代理技能,在 GitHub 累積 29,595 顆星標與 2,027 次複製,採用 AGPL-3.0 授權。它以單一 HTML 檔案輸出橫向翻頁簡報,內建電子雜誌與瑞士國際主義兩套視覺系統,並附演講者模式、三十二種版式與版式校驗腳本。

歸藏 PPT Skill 儲存庫 README 開頭畫面,頂部為多語言連結列,下方標題寫著「Guizang PPT Skill · 網頁 PPT / 配圖 / 封面」,接著是專案徽章、兩套視覺系統說明與一行安裝指令 npx skills add,並穿插電子雜誌風與瑞士國際主義風的效果展示圖

專案於四月二十三日建立,程式碼規模約五點五 MB,主語言為 HTML 與 JavaScript,最新正式版本為五月十五日的 v1.1.0。它不產生 PPTX 檔案,而是輸出一份可直接用瀏覽器打開的 HTML 簡報,翻頁、動效、備註與計時全部寫在同一個檔案內。

作者在「一人公司:被 AI 折疊的組織」等線下分享場合反覆使用這套流程,並把遇到的問題寫進檢查清單。專案同時獲得 360 安全龍蝦、Kimi work 與 Cola Skill 金牌贊助,以及真格 Token Grant 支持。

歸藏 PPT Skill 是什麼?

歸藏 PPT Skill 屬於開源代理技能,讓代理以單一 HTML 檔案生成橫向翻頁簡報。內建電子雜誌與瑞士國際主義兩套視覺系統,附三十二種版式與版式校驗腳本。

它在代理環境中運作,而非獨立應用。安裝後在 Claude Code 或 Codex 中輸入一句「幫我做一份瑞士風 PPT」,代理便讀取技能文件、挑選樣板、填入內容、執行校驗,最後交付可雙擊打開的 HTML 檔案。

適用範圍寫得相當具體。線下分享、行業內部講話、私享會、產品發布與 demo day 屬於建議場景;大段表格、培訓課件與需要多人協作編輯的場合,文件明確列為不適用。

歸藏 PPT Skill 儲存庫首頁頂部,顯示專案名稱 op7418/guizang-ppt-skill、說明文字「AI-agent Skill for generating polished HTML slide decks」、約二萬九千五百顆星標、二千次複製,以及右側 About 區塊的主題標籤

為什麼要用 HTML 而非 PPTX?

HTML 與 CSS 屬純文字,代理可直接讀取、修改與驗證,排版精度高於 Markdown。單檔交付無需建置或伺服器,演講工具隨檔附帶,代價是無法直接匯出 PPTX。

格式選擇直接影響代理能否穩定產出。PPTX 是壓縮的二進位格式,修改時需處理 XML 結構與版面座標,出錯後難以用肉眼判斷;HTML 則是純文字,代理能逐行閱讀,也能用腳本量測渲染結果。

單檔交付簡化了流通環節。檔案可直接開啟、演示、截圖或傳送,不需要安裝簡報軟體,觀眾屏與計時器同樣寫在同一個檔案內,換機演示時不必重新設定環境。

代價出現在協作與格式轉換兩處。沒有原生協作編輯,多人同時修改仍需回到版本控制;官方亦明言當前核心交付是 HTML,若有 PPTX 需求,建議把 HTML 當成視覺稿再另行轉換。

兩套視覺系統有何分別?

電子雜誌風以襯線標題、流體 WebGL 背景與暖色構成,適合敘事與觀點表達。瑞士國際主義風以無襯線、十六列網格與單一高飽和錨點色構成,適合數據、產品與方法論。

電子雜誌風的參照物是 Monocle 雜誌。標題使用 Noto Serif SC 與 Playfair Display 等襯線字體,首頁帶流體、等高線或色散背景,配色偏暖,對應十種頁面佈局與五套電子墨水主題。

瑞士國際主義風的參照物是 Massimo Vignelli 與 Helvetica Forever。全程無襯線,十六列網格、直角色塊、一像素細線,禁用陰影、漸變與圓角,對應二十二種具名版式與四套錨點色。

兩套風格的自由度並不相同。電子雜誌風允許在版式文件內自行擴充;瑞士風要求同步更新樣板、版式文件、鎖定規則與校驗器四個位置,缺一即無法通過檢查。

瑞士風的版式約束如何運作?

瑞士風限制正文頁只能使用 S01 至 S22 的具名版式,禁止臨時發明結構。校驗器會攔截居中標題、實驗版式、SVG 內寫字與圖片脫離槽位,並在可行時量測溢出與留白。

約束的目的是可重現。設計系統一旦開放自由排版,每次產出的品質便會浮動,作者選擇以「不允許」換取穩定。四套錨點色為克萊因藍、檸檬黃、檸檬綠與安全橙,文件明言不允許隨手寫十六進位色值。

品牌色並非完全封閉。腳本 gz-theme.mjs 接收品牌主色後,按該風格的明度與彩度範圍收斂,並逐一檢查文字角色的對比度;達不到可讀性要求時拒絕輸出,使用者需退回預設主題。

校驗分為兩層。靜態層檢查版式編號、標題對齊、圖片槽位與危險 SVG;渲染層在有 Playwright 的環境下量測內容溢出、底部空白、導覽安全線與標題間距。中文大標題另需降一檔字號,避免佔去正文空間。

演講者模式包含哪些功能?

按右下角 P 進入演講者視圖,瀏覽器同時開啟乾淨的觀眾屏。提供當前頁與下一頁的十六比九預覽、結構化備註、分組計時、宮格選頁、激光筆、圈選、黑白屏與凍結觀眾屏。

兩套樣板共用同一套演講運行時。觀眾屏只顯示當前頁,演講者一側上下排列當前頁與下一頁,小螢幕時整頁等比縮放,不裁切亦不擠壓文字。

備註採用結構化契約。每頁需填寫標題、本頁目的、講述要點與轉場,互動、語氣、翻頁時機等欄位只在大綱提供時顯示。計時分為已進行、本頁與剩餘時間三段,排練模式記錄每頁實際時長並保存於瀏覽器本機。

現場工具涵蓋激光筆、圈選與清除,動作會同步至觀眾屏。觀眾視窗關閉或心跳超時後明確顯示未連接,並可重新開啟;退出演講時觀眾視窗自動關閉,若瀏覽器不允許自動關閉,觀眾端改為顯示演示已結束。

所有能力都在本機瀏覽器完成,不依賴實時字幕、雲端中繼、手機遙控或 AI 教練服務。這個選擇降低了現場對網路的依賴,亦意味著跨裝置同步需要自行處理。同樣以單檔交付簡報的對照案例,可參考 PPT Master 生成原生簡報的做法。

安裝與使用流程是怎樣的?

以 npx skills add 一行指令安裝,或把倉庫複製到代理的技能目錄。安裝後代理按步驟執行:選風格、七問澄清、複製樣板、填內容、生成備註、自檢與排練。

最直接的方式是執行下列指令,代理環境會把技能加入清單並附上對應的工作流說明。

npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill

若代理具備 shell 權限,也可請它把倉庫複製到 ~/.claude/skills/guizang-ppt-skill,再確認 SKILL.md、assets 與 references 三個項目存在。觸發詞包括「雜誌風 PPT」、「瑞士風 PPT」、「horizontal swipe deck」與「editorial magazine style presentation」。

執行時代理會先檢查上游是否有更新,再進入需求澄清。七個問題涵蓋風格、受眾、時長、原始素材、圖片處理、主題色與硬約束,文件說明結構一旦定錯,後期翻修的代價很高。

填內容的順序是先做主題節奏表,再從對應版式骨架挑選、粘貼、改寫文案。完成初稿後生成演講備註,對照 checklist.md 自檢,P0 級問題必須全部通過,瑞士風與演講模式另需分別執行對應校驗器。同屬輸出檔案而非原始簡報格式的另一條路線,可參考 Stirling-PDF 把 Office 轉檔搬到自架服務的做法。

專案的數據與授權現況如何?

截至十一月十日,專案累積 29,595 顆星標、2,027 次複製與 53 個未結議題,主語言為 HTML,AGPL-3.0 授權,貢獻者五人,正式版本為 v1.1.0。

29,595Stars
2,027Forks
32版式數量
5貢獻者
53未結議題
AGPL授權條款

星標成長與版本節奏並不同步。專案四月建立,五月十五日發布 v1.1.0 後未再推出正式版本,但程式碼在十月三十日仍有提交,功能以主分支形式持續更新,這種節奏在代理技能類專案中並不少見。

程式碼規模集中於樣板與文件。HTML 佔約三十五萬位元組,JavaScript 約四萬五千位元組,其餘為參考文件,瑞士風版式文件五十三 KB,檢查清單三十七 KB,雜誌風版式二十八 KB,另有截圖適配與版式鎖定規則。

授權採用 AGPL-3.0,屬較嚴格的 copyleft 條款。若把它整合進對外提供的網路服務,需評估源碼開放義務;單純用於內部簡報產出則不受影響。專案另在 npm 以 rea 系列以外的套件形式流通,安裝時應以官方倉庫與文件所列來源為準。

歸藏 PPT Skill 儲存庫的 About 側欄截圖,顯示專案說明、官方網站連結、主題標籤清單,以及 Stars 與 Forks 統計數字

使用上有哪些實際限制?

不支援匯出 PPTX,交付物為 HTML。大段表格、培訓課件與多人協作場景不適用。瑞士風版式變更需同步更新四處文件。貢獻者僅五人,維護負荷集中於作者本人。

格式轉換是最常見的疑問。官方明確表示當前核心交付是 HTML,可用瀏覽器演示、截圖或錄屏;若需要 PPTX,建議把 HTML 頁面當成視覺稿再行轉換,但這不在主流程之內。

外部資源依賴是另一項變數。樣板預設從 CDN 載入 Motion One 動效庫,雖然附有本地副本作備援,字體仍需經網路取得,離線環境下要自行替換字型檔案。

維護規模值得留意。貢獻者五人、未結議題五十三個,功能更新主要依賴作者;企業採用時建議固定 commit、自留一份本地副本,並在內部測試後才導入常規流程。

出處連結有哪些?

本文資訊整理自歸藏 PPT Skill 的 GitHub 儲存庫、README、SKILL.md 技能文件與參考文件目錄,數據截至二零二六年十一月十日。

專案原始碼與文件位於 github.com/op7418/guizang-ppt-skill,技能主文件見 SKILL.md,版式與主題定義陸續收錄於 references 目錄。作者為歸藏,X 帳號 op7418。

常見問題有哪些?

本文整理匯出格式、收費方式、自訂顏色、離線可用性、版式擴充與企業採用六項疑問,逐項說明實際邊界與替代做法。

### 可以匯出 PPTX 嗎? 目前不行。核心交付是 HTML,可用瀏覽器演示、截圖或錄屏。若一定要 PPTX,官方建議把 HTML 頁面當成視覺稿,再經其他工具轉換,但這不在主流程內,品質需自行驗證。 ### 這個技能需要付費嗎? 不需要。倉庫以 AGPL-3.0 授權公開,安裝與使用不收費。專案接受 360 安全龍蝦、Kimi work、Cola Skill 與真格 Token Grant 贊助,贊助不影響功能取用。 ### 為什麼不能自訂主題色? 設計系統以穩定產出為前提,自由選色容易破壞整體風格,因此只允許從預設主題挑選。需要品牌色時可執行 gz-theme.mjs,腳本會把顏色收進風格允許的明度與彩度範圍,並檢查對比度。 ### 沒有網路可以用嗎? 部分可用。動效庫有本地副本,但字體預設經網路取得,圖片若引用外部連結亦需連線。離線演示前應先把字型與圖片改為本地路徑,並在目標機器完整走一次。 ### 可以自己新增版式嗎? 電子雜誌風可以在版式文件內擴充。瑞士風較嚴格,需同步更新 template-swiss.html、layouts-swiss.md、swiss-layout-lock.md 與校驗器四個位置,否則新增版式會被校驗攔下。 ### 企業內部可以使用嗎? 可以,但需自行承擔維護。專案為個人維護、貢獻者五人,不提供商業支援合約。建議固定 commit、保留本地副本,並先在內部試做一份完整簡報,確認流程與品牌規範相容。

總結:歸藏 PPT Skill 適合哪些使用者?

適合需要快速產出高視覺品質簡報的講者、產品經理與工程團隊,特別是已在 Claude Code 或 Codex 環境工作者。需要 PPTX 交付或多人協作編輯的組織應另尋方案。

它的價值在於把設計決策前置。三十二種版式與受約束的主題色,讓代理不必猜測排版美學,只需在有限選項中挑選;校驗器則把「看起來還行」變成可量測的門檻,減少人工複查。

瑞士風的版式鎖定是整個專案最值得參考的設計。多數代理技能把自由度當成優勢,此專案反其道而行,用限制換取每次產出的穩定,並把限制寫成可執行腳本,而非只寫在文件裡。

評估時應注意三點:交付物是 HTML 而非 PPTX、維護集中於作者一人、離線環境需自行處理字型與圖片。若這三項都不構成障礙,它提供了一條從一句話到可演示簡報的完整路徑,值得先用一份真實文章試做再決定是否納入常規流程。