Communitygithub.com

sharonzhang98/editorial-pptx-deck

Cursor 技能:從 HTML 幻燈片建構可編輯、編輯極簡風的商業 PPTX 簡報。

editorial-pptx-deck 是什麼?

這個技能專為 Cursor 代理程式設計,能將以 HTML 編寫的簡報幻燈片轉換為可編輯的 PowerPoint(PPTX)檔案。它遵循一套嚴格的編輯極簡設計系統,包含預定義的配色方案、字體組合與版面配置範本,確保最終產出專業且一致的品牌風格。整個工作流程包括:根據範本編寫每個幻燈片的 HTML 檔案,執行溢位檢查,最後透過 Node.js 指令稿 export_deck_pptx.mjs 產生僅含 PPTX 的輸出。技能支援多種幻燈片類型,如封面、章節分隔頁、三欄比較與對照表等,並內建高品質照片庫。所有設計都由 shared/tokens.css 中的 CSS 變數定義,品牌色、強調色與深色面板都可輕鬆替換,適合快速建立品牌化的商業簡報。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add sharonzhang98/editorial-pptx-deck

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

editorial-pptx-deck preview

說明文件

Editorial PPTX Deck

產出精緻、編輯極簡風格的幻燈片簡報,並匯出為可編輯的 PPTX。最終交付物僅為 .pptx —— HTML 幻燈片只是建構來源,不產出 PDF 或 HTML 檢視器。

運作方式

幻燈片以受限的 HTML 撰寫(每個幻燈片一個檔案),接著 scripts/html2pptx.js 將每個 DOM 元素轉換為原生的 PowerPoint 物件(真正的、可雙擊編輯的文字框)。主體固定為 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE)。

建構工作流程

複製此檢查清單並追蹤進度:

- [ ] 1. 建立專案結構(shared/ assets/ slides/ output/)
- [ ] 2. 規劃敘事架構 → 將每張幻燈片對應到一個範本類型
- [ ] 3. 從範本編寫 slides/NN-name.html(僅編輯文字)
- [ ] 4. check_overflow → 修正任何未完全符合 1280x720 的幻燈片
- [ ] 5. 匯出 PPTX(僅匯出此格式)
- [ ] 6. 清理建構來源(僅保留 .pptx)

1. 建立專案結構。 在工作目錄中建立 shared/、assets/、slides/、output/。從此技能複製 shared/tokens.css 到專案的 shared/。僅複製你會用到的照片,從此技能的 assets/ 複製到專案的 assets/。確保安裝相依套件一次:

npm i pptxgenjs playwright sharp && npx playwright install chromium

2. 規劃。 將來源內容轉換為幻燈片列表。每張幻燈片都屬於某個範本類型。典型的簡報結構 = 封面 → (章節分隔頁 → 1–3 張內容幻燈片) × 章節 → 結尾頁。文字保持簡潔;此風格要求留白充足。

3. 編寫幻燈片。 從 templates/ 複製最接近的範本到 slides/NN-name.html 並替換文字。規則:

  • 保留 <link rel="stylesheet" href="../shared/tokens.css">。
  • 標題使用襯線字體;其他所有文字使用無襯線字體(tokens.css 中已設定)。
  • 僅使用一個紅色強調色。謹慎使用深色面板 (--ink-panel) 以營造對比,其唯一強調色為金色 #C9A24B。
  • 照片透過 <img> 引入(絕不能使用 CSS background-image)。請參閱照片庫。

4. 確認尺寸。 溢出的幻燈片在 PPTX 中會被裁剪:

node scripts/check_overflow.mjs --slides slides

修正所有標記為 OVERFLOW 的項目(縮短文字或調整位置),直到全部顯示為 1280x720。

5. 僅匯出 PPTX。

node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx

幻燈片依檔名排序(01-…、02-…)。不要執行任何 PDF/HTML 匯出 —— PPTX 是唯一的交付物。

6. 清理。 刪除 slides/ 中的 HTML 與任何暫存檔案,僅保留 output/DeckName.pptx(如果使用者想疊代開發,可保留可重複使用的 shared/ 和 assets/)。

設計系統

定義於 shared/tokens.css。請勿發明新顏色。

TokenHEX用途
--ink#1A1A1A標題與主要內文
--soft#555555次要內文
--muted#8C8C8C標籤、註解、頁碼
--red#C8102E唯一強調色:條、引文、關鍵詞、底線
--red-deep#A00C24表格中的消極強調
--red-pale#FBE9EC連接晶片(例如「→」圓圈)
--box#F4F3F1淺色卡片 / 斑馬紋行
--line#E4E2DE極細分隔線
--ink-panel#1C1C1C深色對比面板
gold#C9A24B僅用於深色面板的強調色
background#FFFFFF頁面背景
  • 字體: Georgia 襯線字體用於 h*/標題;Arial/Helvetica 無襯線字體用於所有其他文字。
  • 標誌性元素: 標題左側的細紅色垂直條 + 上方小字距的紅色引文;底部居中放置小型頁碼。
  • 品牌切換: 若要符合其他公司風格,只需更改 tokens.css 中的 --red(以及選擇性更改 --ink-panel/gold)—— 無需更改其他項目。

照片庫

照片存放於此技能的 assets/。人像照片填滿右側約 40% 的分隔頁/封面面板(object-fit:cover);橫向照片適合滿版封面。

檔案方向最佳用途
sail.png人像 589×1024分隔頁 / 封面右側面板(預設)
lighthouse-cliff.png人像 627×1024分隔頁 / 封面右側面板
staircase.png直立 312×1024寧靜/抽象的分隔條
mast.png狹長 208×1024狹長分隔條
hiker-clouds.png狹長 225×1024狹長分隔條
lighthouse-sunset.png橫向 1024×721滿版封面 / 頂部帶區
sailboat-deck.png橫向 1024×721滿版封面 / 頂部帶區

透過更改 <img src="../assets/….png"> 來替換照片。為了整體一致性,在所有分隔頁中保持使用同一張照片(或同一個主題)。使用者也可以將自己的圖片放入 assets/。

範本目錄

位於 templates/(每個範本都是完整、不會溢位的 1280×720 幻燈片):

檔案類型
01-cover.html分割封面:左側襯線標題,右側人像照片
02-divider.html章節分隔頁:引文 + 襯線標題 + 紅色條,右側人像照片
03-three-column.html引文/標題 + 核心線 + 3 欄 + 結果條
04-mapping.html雙欄「客戶需求 → 我們方案」搭配連接晶片
05-compare-table.html3 欄比較表格,斑馬紋行
06-dark-contrast.html雙面板(淺色 vs 深色)+ 襯線頁尾線
07-pipeline.html編號水平步驟流程 + 深色輸出條
08-closing.html結尾提案:編號襯線清單 + 右側人像照片

硬性限制

若違反以下限制,HTML→PPTX 轉換將失敗或顯示錯誤。完整細節與修正方式請參閱 reference.md:

  1. 文字只能放在 <p>/<h1>–<h6> 中(絕不能有裸露在 <div> 中的文字)。
  2. 不能使用 CSS 漸層。
  3. background/border/box-shadow 僅能用於 <div>,不可用於文字標籤。
  4. 不能使用 background-image;請改用 <img>。
  5. 行內標籤(span/em/strong)不能有 margin。
  6. 主體大小固定為 1280×720;任何元素都不能溢出。

相關技能