baoyu-slide-deck

幻灯片生成器

将内容转换为专业的幻灯片图片，并提供灵活的样式选项。

用法

/baoyu-slide-deck path/to/content.md
/baoyu-slide-deck path/to/content.md --style sketch-notes
/baoyu-slide-deck path/to/content.md --audience executives
/baoyu-slide-deck path/to/content.md --lang zh
/baoyu-slide-deck path/to/content.md --slides 10
/baoyu-slide-deck path/to/content.md --outline-only
/baoyu-slide-deck  # Then paste content

脚本目录

重要：所有脚本都位于此技能的 scripts/ 子目录中。

Agent 执行说明：

1. 确定此 SKILL.md 文件所在的目录路径，并将其设为 SKILL_DIR
2. 脚本路径 = ${SKILL_DIR}/scripts/<script-name>.ts
3. 将本文档中的所有 ${SKILL_DIR} 替换为实际路径

脚本参考：

脚本	用途
scripts/merge-to-pptx.ts	将幻灯片合并为 PowerPoint
scripts/merge-to-pdf.ts	将幻灯片合并为 PDF

选项

选项	描述
--style <name>	视觉样式（参见样式库）
--audience <type>	目标受众：初学者、中级用户、专家、高管、普通受众
--lang <code>	输出语言（en、zh、ja 等）
--slides <number>	目标幻灯片数量
--outline-only	仅生成大纲，跳过图片生成

样式库

样式	描述	最适合
blueprint（默认）	技术示意图、网格纹理	架构、系统设计
chalkboard	黑色黑板、彩色粉笔	教育、教程、课堂
notion	SaaS 仪表板、卡片式布局	产品演示、SaaS、B2B
bold-editorial	杂志封面、醒目字体、深色	产品发布、主题演讲
corporate	藏青色/金色、结构化布局	投资者演示文稿、提案
dark-atmospheric	电影感深色模式、发光点缀	娱乐、游戏
editorial-infographic	杂志式解读、扁平插画	科技解读、研究
fantasy-animation	吉卜力/迪士尼风格、手绘	教育、故事叙述
intuition-machine	技术简报、双语标签	技术文档、学术内容
minimal	极简干净、大量留白	高管简报、高端内容
pixel-art	复古 8 位风格、大块像素	游戏、开发者演讲
scientific	学术图表、精确标注	生物学、化学、医学
sketch-notes	手绘风格、温暖亲切	教育、教程
vector-illustration	扁平矢量、复古可爱	创意内容、儿童内容
vintage	做旧纸张、历史风格	历史、遗产、传记
watercolor	手绘质感、自然温暖	生活方式、健康、旅行

自动选择样式

内容信号	选定样式
tutorial、learn、education、guide、intro、beginner	sketch-notes
classroom、teaching、school、chalkboard、blackboard	chalkboard
architecture、system、data、analysis、technical	blueprint
creative、children、kids、cute、illustration	vector-illustration
briefing、academic、research、bilingual、infographic、concept	intuition-machine
executive、minimal、clean、simple、elegant	minimal
saas、product、dashboard、metrics、productivity	notion
investor、quarterly、business、corporate、proposal	corporate
launch、marketing、keynote、bold、impact、magazine	bold-editorial
entertainment、music、gaming、creative、atmospheric	dark-atmospheric
explainer、journalism、science communication	editorial-infographic
story、fantasy、animation、magical、whimsical	fantasy-animation
gaming、retro、pixel、developer、nostalgia	pixel-art
biology、chemistry、medical、pathway、scientific	scientific
history、heritage、vintage、expedition、historical	vintage
lifestyle、wellness、travel、artistic、natural	watercolor
默认	blueprint

设计理念

这套幻灯片旨在供阅读和分享，而非现场演示：

• 每张幻灯片都必须不需口头说明即可独立理解
• 组织内容，让读者滚动浏览时能循序渐进
• 在每张幻灯片中包含所有必要的背景信息
• 针对社交媒体分享和离线阅读进行优化

文件管理

输出目录

每个会话都会创建一个以内容 slug 命名的独立目录：

slide-deck/{topic-slug}/
├── source-{slug}.{ext}    # Source files (text, images, etc.)
├── outline.md
├── outline-{style}.md     # Style variant outlines
├── prompts/
│   └── 01-slide-cover.md, 02-slide-{slug}.md, ...
├── 01-slide-cover.png, 02-slide-{slug}.png, ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

Slug 生成：

1. 从内容中提取主题（2-4 个词，使用 kebab-case）
2. 示例："Introduction to Machine Learning" → intro-machine-learning

冲突处理

如果 slide-deck/{topic-slug}/ 已存在：

• 追加时间戳：{topic-slug}-YYYYMMDD-HHMMSS
• 示例：intro-ml 已存在 → intro-ml-20260118-143052

源文件

将所有源文件复制并命名为 source-{slug}.{ext}：

• source-article.md（正文内容）
• source-diagram.png（对话中的图片）
• source-data.xlsx（附加文件）

支持多个来源：文本、图片、对话中的文件。

工作流

步骤 1：分析内容

1. 保存源内容（如果是粘贴的内容，则保存为 source.md）
2. 按照 references/analysis-framework.md 进行深入的内容分析
3. 确定风格（使用 --style 或根据特征自动选择）
4. 检测语言（源内容语言与用户偏好语言）
5. 规划幻灯片数量（使用 --slides 或动态确定）

步骤 2：生成大纲变体

1. 根据内容分析生成 3 种风格的大纲变体
2. 按照 references/outline-template.md 组织结构
3. 将每种变体保存为 outline-{style}.md

步骤 3：用户确认

通过一次 AskUserQuestion 提出所有适用选项：

问题	提问时机
风格变体	始终（3 个选项 + 自定义）
语言	仅当源内容语言 ≠ 用户语言时

选择后：

• 将选中的 outline-{style}.md 复制为 outline.md
• 如果用户提出要求，则重新生成其他语言版本
• 用户可以编辑 outline.md 进行微调

如果使用 --outline-only，则在此处停止。

步骤 4：生成提示词

1. 阅读 references/base-prompt.md
2. 结合大纲中的风格说明
3. 添加每张幻灯片的具体内容
4. 保存到 prompts/ 目录

步骤 5：生成图片

1. 选择可用的图片生成技能
2. 生成会话 ID：slides-{topic-slug}-{timestamp}
3. 使用相同的会话 ID 生成每张幻灯片
4. 报告进度："已生成 X/N"

步骤 6：合并为 PPTX 和 PDF

npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <slide-deck-dir>

步骤 7：输出摘要

Slide Deck Complete!

Topic: [topic]
Style: [style name]
Location: [directory path]
Slides: N total

- 01-slide-cover.png ✓ Cover
- 02-slide-intro.png ✓ Content
- ...
- {NN}-slide-back-cover.png ✓ Back Cover

Outline: outline.md
PPTX: {topic-slug}.pptx
PDF: {topic-slug}.pdf

修改幻灯片

有关以下内容，请参阅 references/modification-guide.md：

• 编辑单张幻灯片的工作流
• 添加幻灯片（并重新编号）
• 删除幻灯片（并重新编号）
• 文件命名约定

参考资料

文件	内容
references/analysis-framework.md	演示文稿的深入内容分析
references/outline-template.md	大纲结构和 STYLE_INSTRUCTIONS 格式
references/modification-guide.md	编辑、添加和删除幻灯片的工作流
references/content-rules.md	内容和风格指南
references/base-prompt.md	图片生成的基础提示词
references/styles/<style>.md	完整的风格规范

备注

• 图片生成：每张幻灯片需 10-30 秒
• 生成失败时自动重试一次
• 对敏感公众人物使用风格化替代形象
• 通过会话 ID 保持风格一致

扩展支持

通过 EXTEND.md 自定义风格和配置。

检查路径（按优先级排序）：

1. .baoyu-skills/baoyu-slide-deck/EXTEND.md（项目）
2. ~/.baoyu-skills/baoyu-slide-deck/EXTEND.md（用户）

如果找到扩展文件，请在步骤 1 前加载。扩展内容会覆盖默认设置。