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
何时使用
当用户的请求符合以下任一模式时,激活此技能:
- “帮我做个关于……的演示文稿”
- “为……创建幻灯片”
- “构建一个幻灯片组”
- “把这个转成演示文稿”
- “做个关于……的演讲”
- “为……创建一个 pitch deck”
- “生成演示文稿幻灯片”
- 任何涉及以下关键词的请求:演示文稿、幻灯片、组稿、演讲、主题演讲、提案、幻灯片放映
输入模式
根据用户的输入确定适用模式:
模式 A:仅提供主题
用户仅提供主题,可选择提供时长或受众信息。
“做一个关于 AI 趋势的 15 分钟演讲”
“创建一个关于微服务架构的演示文稿”
→ 你需从头设计结构、内容和演讲者备注。
模式 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 - 创业 pitch →
gradient-pop或keynote-apple - 数据/分析 →
data-focus - 教育/工作坊 →
paper或playful - 设计/创意 →
magazine - 产品发布 →
keynote-apple - 休闲/团队活动 →
playful
步骤 3:检查图片需求
询问用户:
“您是否需要我标记幻灯片中的图片插入点?如果需要,我会在大纲中注明,您提供图片 URL。如果不需要,我将使用样式化占位符。”
- 是 → 在大纲中标记图片位置,请求用户提供图片 URL
- 否 → 使用 CSS 占位符(表情符号、SVG 图标、CSS 形状),与主题匹配
步骤 4:生成大纲
创建逐张幻灯片的大纲,包含:
- 幻灯片编号
- 幻灯片类型(参考下方“幻灯片类型参考”)
- 标题
- 关键要点 / 内容摘要
- 图片放置位置(如适用)
将大纲呈现给用户确认。等待用户批准或修改后再继续。
步骤 5:获取主题参考
从 GitHub 获取所选主题的参考文件:
- reference.html —— 包含所有幻灯片类型、样式、导航和交互功能的完整示例演示文稿。这是你的主要模板。
- README.md —— 设计指南,包括配色方案、版式、间距规则和设计理念。
使用下方“主题列表”部分列出的 GitHub raw URL。
步骤 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 | 明亮白色背景、精确版式、苹果风格 | 通用演示、企业会议、学术讲座 | reference.html | README.md |
| 3 | corporate | 海军蓝与金色点缀、专业结构化布局 | 商业演示、投资人会议、季度报告 | reference.html | README.md |
| 4 | gradient-pop | 鲜艳紫粉橙渐变、玻璃形态卡片 | 创业 pitch、产品发布、营销活动 | reference.html | README.md |
| 5 | neon-terminal | 终端风格深色主题、霓虹绿/青、扫描线效果 | 开发者会议、黑客马拉松、CTF 赛事、安全演讲 | reference.html | README.md |
| 6 | paper | 温暖牛皮纸美学、衬线字体、陶土色点缀 | 教育讲座、学术会议、工作坊、研究 | reference.html | README.md |
| 7 | keynote-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 占位符
未提供图片 URL 时,使用与主题匹配的样式化占位符:
<!-- 基于表情符号的占位符 -->
<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>
当用户提供 URL 时
<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字体 - 确保代码块具有适当的内边距和圆角,以匹配主题风格
