Communitygithub.com

Kuneosu/make-slide

**make-slide** 是一個通用技能,讓 AI 程式碼代理能產生單一 HTML 檔案的簡報,內含講者備註。輸出永遠是獨立 `.html` 檔案,所有 CSS 與 JS 皆內嵌,無需建置步驟、框架或額外依賴(字型 CDN 除外)。

make-slide 是什麼?

make-slide 是一個專為 AI 程式碼代理(如 Claude Code、Gemini CLI、Codex、Cursor 等)設計的通用技能,用於生成專業級、單一檔案的 HTML 簡報。其核心優勢在於完全獨立:所有樣式與互動功能皆內嵌於單一 `.html` 檔案中,無需建置工具、框架或網路連線(字型 CDN 除外)。技能支援多種輸入模式,包括僅提供主題、提供原始資料或提供完整講稿,並會根據輸入自動分析合適的投影片數量與語氣。使用者可從 10 種精心設計的主題中選擇,涵蓋技術、企業、教育與創意等場景。產生流程包含結構化步驟:分析輸入、選擇主題、確認圖片需求、產生大綱、參考主題範本、生成 HTML 與講者備註,並可選擇性產出完整講稿。最終輸出包含鍵盤與觸控導航、全螢幕模式、講者備註面板、進度條、投影片計數器、PDF 匯出支援,以及使用 Prism.js 的語法高亮功能。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add Kuneosu/make-slide

在你喜歡的 AI 中提問

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

預覽

來自技能 README

make-slide preview

說明文件

make-slide — AI 簡報技能

概述

make-slide 是一個通用技能,讓 AI 程式碼代理能產生單一 HTML 檔案的簡報,內含講者備註。輸出永遠是獨立 .html 檔案,所有 CSS 與 JS 皆內嵌 — 無需建置步驟、框架或額外依賴(字型 CDN 除外)。

任何 AI 程式碼工具(Claude Code、Gemini CLI、Codex、Cursor 等)都能讀取此檔案並依照指示產生專業簡報。

儲存庫:github.com/kuneosu/make-slide 主題畫廊:make-slide.vercel.app


何時使用

當使用者的請求符合以下任何模式時,啟動此技能:

  • 「做一份關於...的簡報」
  • 「為...建立投影片」
  • 「建立投影片組」
  • 「把這個轉成簡報」
  • 「做一場關於...的演講」
  • 「為...建立募資簡報」
  • 「產生簡報投影片」
  • 任何涉及:簡報、投影片、投影片組、演講、主題演講、募資簡報、投影片放映 的請求

輸入模式

根據使用者的輸入判斷適用的模式:

模式 A:僅有主題

使用者僅提供主題,以及選擇性的時長或聽眾。

「做一場 15 分鐘關於 AI 趨勢的演講」
「建立一份關於微服務架構的簡報」

→ 你需從頭設計結構、內容與講者備註。

模式 B:提供內容/資料

使用者提供原始資料(文件、筆記、數據、文章)。

「把這份文件轉成簡報」
「根據這些會議記錄建立投影片」

→ 你將資料整理並精煉成投影片與講者備註。

模式 C:提供講稿

使用者提供書面講稿或演講稿。

「為這份講稿建立投影片」
「製作與此演講搭配的視覺投影片組」

→ 你分析講稿的結構並建立相符的視覺投影片。講稿本身成為講者備註。


工作流程

請依序執行以下步驟:

步驟 1:分析輸入

  • 判斷輸入模式(A、B 或 C)
  • 估算合適的投影片數量:
    • 5 分鐘演講 → 8-12 張投影片
    • 10 分鐘演講 → 12-18 張投影片
    • 15 分鐘演講 → 18-25 張投影片
    • 20 分鐘演講 → 25-30 張投影片
    • 30 分鐘演講 → 30-40 張投影片
  • 識別目標聽眾與語氣(技術、商業、休閒、學術)
  • 從對話中偵測使用者的語言(以該語言產生內容)

步驟 2:選擇主題

提供使用者主題畫廊連結供瀏覽:

在此瀏覽主題:https://make-slide.vercel.app

如果使用者未選擇主題,根據情境推薦一個:

  • 技術/開發者演講 → minimal-dark 或 neon-terminal
  • 商業/企業 → corporate 或 minimal-light
  • 新創募資簡報 → gradient-pop 或 keynote-apple
  • 數據/分析 → data-focus
  • 教育/工作坊 → paper 或 playful
  • 設計/創意 → magazine
  • 產品發表 → keynote-apple
  • 休閒/團隊活動 → playful

步驟 3:檢查圖片需求

詢問使用者:

「您是否希望我在投影片中標示圖片插入點?如果是,我會在大綱中標記位置,您可以提供圖片網址。如果不是,我會使用樣式化的佔位符。」

  • 是 → 在大綱中標記圖片位置,要求使用者提供圖片網址
  • 否 → 使用 CSS 佔位符(表情符號、SVG 圖示、CSS 形狀),並與主題相符

步驟 4:產生大綱

建立逐張投影片的大綱,包含:

  • 投影片編號
  • 投影片類型(參考下方「投影片類型參考」)
  • 標題
  • 重點/內容摘要
  • 圖片放置位置(如適用)

將大綱呈現給使用者確認。在獲得批准或修改前,請等待。

步驟 5:取得主題參考

從 GitHub 取得所選主題的參考檔案:

  1. reference.html — 包含所有投影片類型、樣式、導航與互動功能的完整範例簡報。這是你的主要範本。
  2. README.md — 設計指南,包含色票、字體排印、間距規則與設計理念。

使用下方「主題清單」中列出的原始 GitHub 網址。

步驟 6:產生 HTML

以 reference.html 為範本:

  • 複製精確的 HTML 結構、CSS 樣式與 JS 功能
  • 將示範內容替換為使用者的實際內容
  • 保留所有互動功能(導航、全螢幕、講者備註等)
  • 符合主題的字體排印、顏色、間距與動畫
  • 確保使用的所有投影片類型與參考中的模式相符

步驟 7:產生講者備註

將講者備註以 data-notes 屬性加入每張投影片的 <div>:

<div class="slide" data-notes="歡迎大家。今天我要談的是...">
  • 備註應口語且自然
  • 在需要時加入時間提示(例如「[停頓]」、「[2 分鐘]」)
  • 不要只是重複投影片文字 — 加以延伸
  • 包含投影片之間的轉折(例如「現在讓我們進入...」)

步驟 8:產生講稿(僅限模式 A 與 B)

對於模式 A 與 B,另外產生一個獨立的 script.md 檔案,包含:

  • 按投影片組織的完整演講稿
  • 每節的時間估算
  • 與聽眾互動的提示
  • 需要強調的重點

對於模式 C,使用者已有講稿 — 跳過此步驟。

步驟 9:儲存與交付

  • 將簡報儲存為 index.html(或使用者指定的檔案名稱)
  • 將講稿儲存為 script.md(如有產生)
  • 提供啟動本地伺服器以供預覽:
    # Python
    python -m http.server 8000
    # Node.js
    npx serve .
    

主題清單

#主題 ID風格最適合參考 HTMLREADME
1minimal-dark乾淨深色背景、白色字體排印、現代極簡技術會議、開發者演講、開源簡報reference.htmlREADME.md
2minimal-light明亮的白色背景、精準字體排印、Apple 風格一般簡報、企業會議、學術講座reference.htmlREADME.md
3corporate海軍藍與金色點綴、專業結構化版面商業簡報、投資者會議、季度報告reference.htmlREADME.md
4gradient-pop鮮豔紫色-粉紅-橙色漸層、玻璃態卡片新創募資簡報、產品發表、行銷活動reference.htmlREADME.md
5neon-terminal終端機風格深色主題、螢光綠/青色、掃描線效果開發者會議、黑客松、CTF 活動、安全演講reference.htmlREADME.md
6paper溫暖牛皮紙美學、襯線字體、陶土色點綴教育講座、學術會議、工作坊、研究reference.htmlREADME.md
7keynote-apple戲劇性深色/漸層背景、Apple keynote 風格產品發表、主題演講會議、高層簡報reference.htmlREADME.md
8magazine編輯式雜誌版面、不對稱設計、戲劇性字體排印設計簡報、作品集審查、品牌指南reference.htmlREADME.md
9data-focus乾淨數據中心版面、儀表板美學、趨勢指標數據分析、KPI 儀表板、財務審查、統計報告reference.htmlREADME.md
10playful圓角、粉彩顏色、表情符號點綴、彈性動畫團隊工作坊、休閒技術演講、回顧、社群活動reference.htmlREADME.md

HTML 需求

每個產生的簡報必須包含以下所有功能。這些是不可妥協的。

檔案結構

  • 單一獨立 .html 檔案
  • 所有 CSS 內嵌在 <style> 標籤中
  • 所有 JS 內嵌在 <script> 標籤中
  • 除了下方列出的 CDN 連結外,無外部檔案

必要的 CDN 依賴

<!-- Pretendard 字型(強制) -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard/dist/web/static/pretendard.min.css">

<!-- JetBrains Mono 用於程式碼區塊 -->
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&display=swap">

<!-- Prism.js 用於語法高亮(僅當存在程式碼區塊時) -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
<!-- 根據需要加入語言組件 -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-javascript.min.js"></script>

鍵盤導航

  • ← / → 方向鍵:上一張 / 下一張投影片
  • Space:下一張投影片
  • F:切換全螢幕
  • S:切換講者備註面板
  • Escape:退出全螢幕

投影片計數器

  • 顯示目前投影片編號與總數:3 / 25
  • 位置:右下角或依主題定義

進度條

  • 顯示在投影片組中位置的視覺進度指示器
  • 每次投影片切換時更新

全螢幕

  • F 鍵切換全螢幕模式
  • UI 控制項中的全螢幕按鈕
  • 使用 Fullscreen API(requestFullscreen)

講者備註面板

  • S 鍵切換講者備註面板
  • 面板顯示:
    • 目前投影片的備註(來自 data-notes 屬性)
    • 下一張投影片預覽(可能時)
  • 面板不應遮擋主投影片檢視

PDF 匯出

@media print {
  /* 隱藏所有 UI 控制項 */
  .controls, .progress-bar, .slide-counter,
  .fullscreen-btn, .speaker-notes-panel,
  nav, button { display: none !important; }

  /* 每張投影片 = 1 頁,橫向 */
  .slide {
    page-break-after: always;
    width: 100vw;
    height: 100vh;
  }

  @page {
    size: landscape;
    margin: 0;
  }
}

觸控/滑動導航

  • 向左滑動 → 下一張投影片
  • 向右滑動 → 上一張投影片
  • 使用觸控事件監聽器實作(touchstart、touchend)

投影片轉場

  • 投影片之間的淡入轉場(CSS 轉場或動畫)
  • 流暢且專業 — 無突兀跳躍

交錯元素動畫

  • 投影片內的元素依序顯示(交錯效果)
  • 使用具遞增 animation-delay 的 CSS 動畫
  • 當投影片變為啟用狀態時觸發動畫

長寬比

  • 所有投影片採用 16:9 長寬比
  • 在螢幕上置中,必要時加上黑邊

響應式設計

  • 可縮放以適應各種螢幕尺寸
  • 文字在所有解析度下保持可讀
  • 控制項適應螢幕大小

內容溢出

  • 在投影片內容區域套用 overflow-y: auto
  • 防止因投影片內容過多而被裁剪
  • 捲動條應不明顯且與主題相符

圖片處理

預設:CSS 佔位符

當未提供圖片網址時,使用與主題相符的樣式化佔位符:

<!-- 基於表情符號的佔位符 -->
<div class="image-placeholder">
  <span class="placeholder-icon">🚀</span>
  <span class="placeholder-label">產品截圖</span>
</div>

<!-- CSS 形狀佔位符 -->
<div class="image-placeholder gradient-bg">
  <svg>...</svg>
</div>

當使用者提供網址時

<img src="https://example.com/image.jpg" alt="描述" loading="lazy">
  • 永遠包含描述性的 alt 文字
  • 對摺頁下方的圖片使用 loading="lazy"
  • 設定圖片樣式以適合投影片版面,不溢出

程式碼區塊

使用 Prism.js 的語法高亮

  • 僅當簡報中存在程式碼區塊時,才加入 Prism.js CDN
  • 如果沒有程式碼區塊,則省略所有 Prism.js 的 <link> 與 <script> 標籤

支援的語言

根據需要加入 Prism.js 語言組件:

  • prism-javascript.min.js — JavaScript
  • prism-typescript.min.js — TypeScript
  • prism-python.min.js — Python
  • prism-markup.min.js — HTML/XML(已包含在核心中)
  • prism-css.min.js — CSS(已包含在核心中)
  • prism-bash.min.js — Bash/Shell
  • prism-json.min.js — JSON
  • prism-java.min.js — Java
  • prism-go.min.js — Go
  • prism-rust.min.js — Rust

程式碼區塊標記

<pre><code class="language-javascript">
function hello() {
  console.log("Hello, World!");
}
</code></pre>
  • 所有程式碼區塊使用 JetBrains Mono 字型
  • 確保適當的格式...

相關技能