Communitygithub.com

Kuneosu/make-slide

**make-slide** 是一个通用的 AI 编程助手技能,用于生成包含演讲者备注的单文件 HTML 演示文稿。输出始终是一个独立的 `.html` 文件,所有 CSS 和 JS 都内联其中——无需构建步骤,无需框架,除了字体 CDN 外无任何依赖。

make-slide 是什么?

make-slide 是一个专为 AI 编码助手设计的技能,用于创建功能完整的单文件 HTML 演示文稿。它旨在无缝集成到 Claude Code、Gemini CLI、Codex、Cursor 等 AI 编码工具的工作流中,让代理能根据用户提示自动生成专业级幻灯片。该技能支持三种输入模式:仅提供主题(代理自行设计内容)、提供原始材料(代理提炼和组织内容)、或提供完整演讲稿(代理根据脚本创建匹配的视觉幻灯片)。生成的文件是一个独立的 HTML 文件,包含 16:9 比例、键盘/触屏导航、演讲者备注面板、全屏模式、进度条和 PDF 导出功能。它还提供 10 种不同主题(如 minimal-dark、neon-terminal、corporate 等),并能自动处理图片占位符、语法高亮代码块以及自适应排版。该技能通过从 GitHub 仓库 [github.com/kuneosu/make-slide](https://github.com/kuneosu/make-slide) 获取主题参考文件,生成与所选题材(科技、商业、教育等)完美匹配的演示文稿。

兼容平台✓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


何时使用

当用户的请求符合以下任一模式时,激活此技能:

  • “帮我做个关于……的演示文稿”
  • “为……创建幻灯片”
  • “构建一个幻灯片组”
  • “把这个转成演示文稿”
  • “做个关于……的演讲”
  • “为……创建一个 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 获取所选主题的参考文件:

  1. reference.html —— 包含所有幻灯片类型、样式、导航和交互功能的完整示例演示文稿。这是你的主要模板。
  2. 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风格最佳适用场景参考 HTMLREADME
1minimal-dark简洁深色背景、白色版式、现代简洁技术会议、开发者演讲、开源演示reference.htmlREADME.md
2minimal-light明亮白色背景、精确版式、苹果风格通用演示、企业会议、学术讲座reference.htmlREADME.md
3corporate海军蓝与金色点缀、专业结构化布局商业演示、投资人会议、季度报告reference.htmlREADME.md
4gradient-pop鲜艳紫粉橙渐变、玻璃形态卡片创业 pitch、产品发布、营销活动reference.htmlREADME.md
5neon-terminal终端风格深色主题、霓虹绿/青、扫描线效果开发者会议、黑客马拉松、CTF 赛事、安全演讲reference.htmlREADME.md
6paper温暖牛皮纸美学、衬线字体、陶土色点缀教育讲座、学术会议、工作坊、研究reference.htmlREADME.md
7keynote-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 占位符

未提供图片 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 — 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 字体
  • 确保代码块具有适当的内边距和圆角,以匹配主题风格

相关技能