Communitygithub.com

lainshao/modern-ppt

用一句話生成現代投屏網頁 PPT 的 Agent Skill:專業極簡風 · 12 版式 · 3 套配色 · 交互動效 · 單檔案 HTML

modern-ppt 是什麼?

這個技能讓您只需一句話或一個主題,就能快速生成一份可直接投屏放映的現代化網頁簡報(單檔案 HTML)。它內建 12 種專業版型(包含封面、目錄、圖表、時間線等)、3 套配色(預設安全橙、明亮藍、柔和粉,放映時可按 1/2/3 即時切換),以及豐富的互動效果(數字滾動、Chart.js 圖表、縮圖牆、議程逐步點亮)。技能自動處理排版規範、交互動效與配色,確保產出內容乾淨、專業且一致。支援 Cursor、Claude Code 等 AI 代理開發環境,執行時會先與使用者釐清大綱與素材,再拷貝模板、替換內容,並提供自檢流程以確保品質。注意此技能衍生自 AGPL-3.0 開源專案,使用時須遵守授權條款。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add lainshao/modern-ppt

在你喜歡的 AI 中提問

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

說明文件

Modern PPT · 現代投屏網頁 deck

生成一份單檔案 HTML 的橫向翻頁 deck:專業極簡風、乾淨克制的排版,內建 12 版式 + 交互 + 3 套配色(預設安全橙,放映按 1/2/3 切明亮藍 / 柔和粉)。鍵盤 ← →、滾輪、觸屏翻頁,ESC 出索引,B 切靜態模式。預設就是「能直接投屏放映 / 發給別人 fork 改」的成品。

來源與許可(必讀):本 skill 衍生自 規藏 guizang-ppt-skill(© op7418,AGPL-3.0)——復用了它的 Swiss 模板底盤、WebGL/ASCII 背景、翻頁/索引/動效引擎。在其上做了:安全橙主題(現擴為 3 套可切配色)、一整套投屏排版規範(下文)、12 版式 + 交互動效、已驗證版式裁剪、已修模板 bug。因此本 skill 整體仍是 AGPL-3.0:再分發須保留 LICENSE + 本段署名 + 註明改動;放公司內部倉前先過開源合規(AGPL 常被禁)。生成出來的最終 deck 不必寫署名。模板範例頁只用通用/公開內容,別烤進項目私貨(否則再分享前要現場清洗——本 skill 踩過)。

工作流(動手前先走)

  1. 澄清(用戶只給主題/模糊想法時):受眾與場景?時長(15min≈10 頁 / 30min≈18-22 頁)?預設配色(❶ 黑+橙 / ❷ 明亮藍 / ❸ 柔和三文魚粉——3 套都內建,放映時按 1/2/3 隨時切,這裡只是先定個預設;不確定就用預設黑橙)?有無素材/資料?有無硬約束(必須含 X / 不能出現 Y)?數字一律來自用戶素材,缺就標「待補」,絕不編造。
  2. 先訂大綱再動手:從源文件 / URL 做 deck,先找出那一句 thesis 當錨點(如「上下文會填滿就變笨」),全篇結論先行、圍著它轉。每頁一個觀點(標題即觀點);用「敘事弧」(鉤子→定調→主體→轉折→收束);分幕的長 deck 每 4-5 頁插一張 divider(深墨底 + 幽靈編號,見排版規範 §9)。和用戶對齊大綱再寫。先砍後寫:第一版總會過載,刪頁 / reframe 比堆料更出彩(comprehensive ≠ persuasive)。
  3. 拷模板:cp assets/template.html 項目/index.html。它是完整成品——18 頁展示全部 12 版式 + 3 套配色 + 交互(count-up / Chart.js / 縮略圖牆 / 章節 divider),已含全部 CSS/JS。改 <title>,留下要用的版式頁、刪掉不用的,把內容替換成用戶的。
  4. 先樣頁後放量:先做封面 + 2-3 張代表頁 → 截圖 review(見下「驗證」) → 用戶拍板 → 再批量產剩餘頁。每輪都截圖。
  5. 自檢:逐條過下方硬規則 + references/排版規範.md;grep 裸 font-size(正文級應趨近 0)。

排版硬規則(產出一致的關鍵 · 詳見 references/排版規範.md)

  1. 正文走單一 --fs-body token(投屏 ≈21px;影片剪輯改 32px)。所有描述/段落/卡片說明/表格儲存格都 var(--fs-body),禁止各寫各的裸 font-size。
  2. 每頁字號 ≤ 幾檔:頁標題 / 卡片標題 / 正文 / mono 角標 + 大數字特例。字號編碼層級。
  3. 欄目標題靠「分隔線 + 留白 + 角色對比」立住,不靠加大字號。用 .col-head(安靜灰字 + border-bottom:2px solid ink)。加大加粗反而和正文打架、更難讀。
  4. 正文不上色:accent / 品牌色只給標題關鍵詞、圖表資料、1px 分隔線;正文強調 = 黑色加粗,不用斜體。
  5. 內容緊跟標題連排,不錨底:禁止 margin-top:auto 把內容推到卡片底,造成「標題在天上、內容在地下」。
  6. 底部安全區 ≥6vh(.canvas-card 底 padding):滿高內容塊不要貼右下角導航提示/分頁點。
  7. 編號列表(01/02/03)用單一 grid 共享列軌 + font-feature-settings:'tnum',否則比例字體下數字寬度不同、各行標題左緣參差。
  8. 強弱用 5 格方塊刻度(領跑=5 滿格),可橫向掃讀;別只寫文字。
  9. 卡片「小標在上」而非右上角標(長標題會和角標重疊);一組卡別隨手單格高光(高光要麼有資料/焦點語義,要麼別加)。
  10. accent 不滿屏鋪(安全橙滿屏刺眼):封面/幕封用深墨底 + 關鍵詞上色;split 收束頁半屏橙可接受。

12 個版式(模板已內建範例頁,cp 後改文案即可)

三層分類,每層 divider 分幕(見排版規範 §9):

  • ① 基礎骨架:Cover 封面 · Agenda 目錄 · Page divider 章節頁 · Closing 收束
  • ② 數據·對比·圖表:Stat grid(大數字 count-up 從 0 滾)· Chart(Chart.js 柱狀+折線,逐柱升起/自動繪線 + hover tooltip + 折線標 QoQ%)· Comparison 對比矩陣(標準×選項 + 5 格刻度,主推列高亮)
  • ③ 敘事·流程·內容:Two-column 圖文分欄(右欄可換 圖/mock/圖表/代碼終端)· Three-column 三欄卡(3-grid)· Strategy house 戰略房子圖(SVG OGSM:橙屋頂使命 + 主題列×編號目標卡 + 價值觀地基)· Process/Timeline 流程時間線 · Quote 金句
  • 外加 縮略圖牆:live 克隆全部版式,一屏預覽,自動跟隨配色。

已驗證版式元件(只用這些,別發明)

  • 卡片:.sub-card(.accent/.ink)、.sub-grid-3-2(六格)、.triad(3-grid 三欄卡)
  • 數據:.cnt(count-up 數字)、.stat-card、canvas[data-chart="bar|line"](Chart.js)、5 格方塊刻度、.cmp(對比矩陣)
  • 結構:.stack-row/.stack-block、.duo-compare(雙軌對照 + .vrule)、.timeline-v/.timeline-h、.house-svg(戰略房子圖)
  • 文字:.h-xl-zh(頁標題)、.lead/.body(正文)、.t-cat/.t-meta(mono 角標)、.mk(accent 關鍵詞)
  • 版面:.split-half(收束)、slide.dark + 幽靈大編號(章節 divider)、.code-card(終端)、.chart-card、.dot-mat(點陣)
  • 18 頁範例就是這些元件的活範例,直接 copy 改文案最快。

交互 / 動效(模板已接好,</body> 前的 IIFE 自動跑)

  • 數字 count-up:<span class="cnt" data-to="85" data-dec="0">85</span> → 翻到該頁從 0 滾到 85(tnum 防抖)。
  • 圖表:<canvas data-chart="bar"> / data-chart="line",進頁自動初始化,逐柱升起 / 自動繪線 + hover tooltip;折線每點標 QoQ%。改資料在 IIFE 的 chartConfig。
  • Agenda 逐項點亮:.agenda-list[data-agenda-steps] → ←→ 每次只點亮一項,到最後一項再翻頁。
  • 縮略圖牆:.thumb-wall[data-thumb-wall] → 進頁克隆全部版式做縮略圖,自動跟隨配色。

配色(3 套 · 放映時按 1/2/3 或 URL ?scheme=)

  • 1 = 黑+橙(預設,深色頁保留)· 2 = 明亮藍(純白底)· 3 = 柔和三文魚粉(暖白底)。
  • 藍/粉兩套自動給 <body> 加 .lite → 深色頁(封面/資料/章節/金句)翻淺底。換/加配色:改 IIFE 的 SCHEMES 物件(覆蓋 --paper/--ink/--accent 等 CSS 變數)。單套配色只用一個 accent。
  • 設預設配色(用戶在澄清步選了藍/粉時):在 IIFE 末尾加一行 applyScheme('blue')(或 'salmon'),這份 deck 打開就是那套;1/2/3 仍可現場切。

已知坑(別重踩)

  • 截圖驗證陷阱:Chrome 後台標籤會凍結動畫時鐘,截圖會拍到「動畫第一幀=空白」——不是 bug,前台放映正常。驗證動效先按 B 切靜態模式(window.__setLowPowerMode(true,{persist:false}))再逐頁截圖。
  • 只用上面列的元件:模板未帶 CSS 的花式版式(matrix/four-cards/loop 等)直接用會崩。
  • 改單檔案用腳本/正則時:錨唯一串,改完數 section 數自檢(定位串撞車會誤刪頁)。
  • 配色翻淺底(.lite)覆蓋內聯白字:motion 動效會把內聯 color:#fff 歸一化成 color: rgb(255, 255, 255),body.lite .slide.dark 的選擇器要同時匹配 #fff 和 rgb(255, 255, 255) 兩種寫法,否則白字在淺底上隱身。

預覽

open 項目/index.html   # macOS,無需伺服器;斷網時 motion 自動降級為無動畫可讀

相關技能