baoyu-slide-deck

用途

baoyu-slide-deck 用于把内容转换为专业的幻灯片图片。其设计假设是面向阅读与分享（幻灯片可自解释、逻辑滚动流畅、适合社交媒体传播），而不是现场演讲，这一假设决定了所有布局与信息密度的取舍。

主要能力

根据内容生成大纲，并附带风格指令。
逐张生成幻灯片图片。
可将幻灯片合并为 PowerPoint（scripts/merge-to-pptx.ts）或 PDF（scripts/merge-to-pdf.ts）。
支持 17 种预设风格，覆盖技术、教育、生活方式、编辑类用途。每个预设由四个维度组合而成：纹理（texture）、氛围（mood）、字体（typography）、密度（density）。
支持自定义维度：纹理（clean、grid、organic、pixel、paper）、氛围（professional、warm、cool、vibrant、dark、neutral、macaron）、字体（geometric、humanist、handwritten、editorial、technical）、密度（minimal、balanced、dense）。
支持参考图片，用于引导风格、配色、布局或主题。
支持自动风格选择：根据内容信号匹配预设，无匹配时回退到 blueprint。
支持幻灯片数量启发式推荐：少于 1000 词推荐 5-10 张；1000-3000 词推荐 10-18 张；3000-5000 词推荐 15-25 张；超过 5000 词推荐 20-30 张（可考虑拆分）。

使用方式

该技能通过命令行选项控制行为，主要选项包括：

--style <name>：预设、custom 或自定义风格名。
--audience <type>：beginners / intermediate / experts / executives / general。
--lang <code>：输出语言（en、zh、ja 等）。
--slides <N>：目标幻灯片数量（推荐 8-25，最大 30）。
--ref <files...>：每张幻灯片应用的参考图片（风格 / 配色 / 构图 / 主题）。
--batch-size <n>：本次运行的幻灯片图片生成批大小，默认取 EXTEND.md 的 generation_batch_size，否则为 4，限制在 1-8。
--outline-only：仅生成大纲后停止。
--prompts-only：仅生成提示词后停止（跳过图片生成）。
--images-only：跳到第 7 步；需要已有 prompts/。
--regenerate <N>：重新生成指定幻灯片，如 3 或 2,5,8。

工作流程共 9 步：

设置与分析。
确认（必需；第一轮，若选“自定义维度”则进行第二轮）。
生成大纲。
审阅大纲（条件性）。
生成提示词。
审阅提示词（条件性）。
生成图片。
合并为 PPTX/PDF。
输出摘要。

确认策略：默认在生成前确认。显式调用技能、文件路径、匹配的信号/预设、EXTEND.md 默认值都只作为推荐输入，均不授权跳过确认。只有当前请求明确表示跳过确认（如“直接生成”“不用確認”“跳過確認”“按默認出幻燈片”或等效措辞）时才跳过。若跳过确认，需在生成前的下一次面向用户的更新中说明所假设的风格 / 受众 / 幻灯片数量 / 语言 / 后端。

图片生成后端解析顺序：当前请求覆盖 → 已保存偏好（EXTEND.md 的 preferred_image_backend）→ 自动选择（Codex imagegen、Codex via codex exec、Cursor GenerateImage、其他运行时原生工具、唯一非原生后端、询问用户）→ 无可用时告知用户并询问如何处理。

提示词文件要求（硬性）：在调用任何后端之前，必须把每张图片的完整最终提示词写入 prompts/ 下的独立文件（命名：NN-slide-[slug].md）。

批量生成策略：默认批量生成幻灯片图片。优先使用所选后端的原生批量/多任务接口；若无但运行时支持并行工具调用，则一次最多派发 generation_batch_size 张（默认 4）；两者都无则顺序生成。所有选中的幻灯片提示词文件存在磁盘上之前，不得开始第一批。失败项重试一次，不重新生成成功项。仅在所有选中幻灯片图片生成完成后，才合并 PPTX/PDF。

语言：在提问、进度报告、错误消息和完成摘要中，使用用户的语言回应。技术标记（风格名、文件路径、代码）保留英文。

脚本目录：{baseDir} 为本 SKILL.md 所在目录。解析 ${BUN_X}：优先 bun；否则 npx -y bun；否则建议 brew install oven-sh/bun/bun。

文件布局：

slide-deck/{topic-slug}/
├── source-{slug}.{ext}
├── outline.md
├── prompts/NN-slide-{slug}.md
├── NN-slide-{slug}.png
├── {topic-slug}.pptx
└── {topic-slug}.pdf

Slug 为 2-4 个词，kebab-case，从主题提取。例如“Introduction to Machine Learning” → intro-machine-learning。

备份规则（跨步骤适用）：如果要写入的文件已存在，先将其重命名为 <name>-backup-YYYYMMDD-HHMMSS.<ext>，再写入新文件。

适用场景

将文章、教程、研究内容等转换为可阅读、可分享的幻灯片图片。
需要特定视觉风格（如蓝图、黑板、企业、极简、水彩、像素艺术、科学等）的幻灯片。
需要输出为 PPTX 或 PDF 的场景。
需要参考图片来统一风格、配色或布局的场景。

限制

禁止用 SVG、HTML、canvas 或其他基于代码的渲染替代光栅图片生成。
禁止通过程序化叠加（如 ImageMagick、Pillow、Canvas、SVG、HTML/CSS、OCR 脚本）覆盖、重写、擦除、描边或替换已生成幻灯片图片中的文字。若文字有误或不清晰，应从修正后的提示词重新生成、简化幻灯片上的文字，或询问用户保留哪个不完美的候选。
不得仅为了并行化图片渲染而使用子代理；子代理仅用于单独的提示词迭代或创意探索。
幻灯片数量推荐 8-25，最大 30。
关于收费、价格、平台支持等具体信息，资料中暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制