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:選擇主題
提供使用者主題畫廊連結供瀏覽:
如果使用者未選擇主題,根據情境推薦一個:
- 技術/開發者演講 →
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 取得所選主題的參考檔案:
- reference.html — 包含所有投影片類型、樣式、導航與互動功能的完整範例簡報。這是你的主要範本。
- 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 | 風格 | 最適合 | 參考 HTML | README |
|---|---|---|---|---|---|
| 1 | minimal-dark | 乾淨深色背景、白色字體排印、現代極簡 | 技術會議、開發者演講、開源簡報 | reference.html | README.md |
| 2 | minimal-light | 明亮的白色背景、精準字體排印、Apple 風格 | 一般簡報、企業會議、學術講座 | reference.html | README.md |
| 3 | corporate | 海軍藍與金色點綴、專業結構化版面 | 商業簡報、投資者會議、季度報告 | reference.html | README.md |
| 4 | gradient-pop | 鮮豔紫色-粉紅-橙色漸層、玻璃態卡片 | 新創募資簡報、產品發表、行銷活動 | reference.html | README.md |
| 5 | neon-terminal | 終端機風格深色主題、螢光綠/青色、掃描線效果 | 開發者會議、黑客松、CTF 活動、安全演講 | reference.html | README.md |
| 6 | paper | 溫暖牛皮紙美學、襯線字體、陶土色點綴 | 教育講座、學術會議、工作坊、研究 | reference.html | README.md |
| 7 | keynote-apple | 戲劇性深色/漸層背景、Apple keynote 風格 | 產品發表、主題演講會議、高層簡報 | reference.html | README.md |
| 8 | magazine | 編輯式雜誌版面、不對稱設計、戲劇性字體排印 | 設計簡報、作品集審查、品牌指南 | reference.html | README.md |
| 9 | data-focus | 乾淨數據中心版面、儀表板美學、趨勢指標 | 數據分析、KPI 儀表板、財務審查、統計報告 | reference.html | README.md |
| 10 | playful | 圓角、粉彩顏色、表情符號點綴、彈性動畫 | 團隊工作坊、休閒技術演講、回顧、社群活動 | reference.html | README.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— JavaScriptprism-typescript.min.js— TypeScriptprism-python.min.js— Pythonprism-markup.min.js— HTML/XML(已包含在核心中)prism-css.min.js— CSS(已包含在核心中)prism-bash.min.js— Bash/Shellprism-json.min.js— JSONprism-java.min.js— Javaprism-go.min.js— Goprism-rust.min.js— Rust
程式碼區塊標記
<pre><code class="language-javascript">
function hello() {
console.log("Hello, World!");
}
</code></pre>
- 所有程式碼區塊使用
JetBrains Mono字型 - 確保適當的格式...
