baoyu-slide-deck

baoyu-slide-deck

热门

根据输入内容生成专业级幻灯片(Slide Deck)图片。先创建带有风格指令的大纲,再逐张生成幻灯片图片。适用于用户提出“制作幻灯片”、“做 PPT”、“生成演示文稿”、“制作 Slide Deck”等需求时。

2.2万Star
2606Fork
更新于 2026/6/18
SKILL.md
只读
名称
baoyu-slide-deck
描述

根据输入内容生成专业级幻灯片(Slide Deck)图片。先创建带有风格指令的大纲,再逐张生成幻灯片图片。适用于用户提出“制作幻灯片”、“做 PPT”、“生成演示文稿”、“制作 Slide Deck”等需求时。

版本
1.117.4

幻灯片生成器 (Slide Deck Generator)

将输入内容转换为专业的幻灯片图片。这套幻灯片专为阅读与分享(信息自解释、滚动浏览顺畅、适合社交媒体传播)而设计,而非现场演讲展示——这一定位决定了后续所有的布局与信息密度设计。

用户输入工具 (User Input Tools)

当本 Skill 需要提示用户输入时,请按以下优先级顺序选择工具:

  1. 优先使用内置用户输入工具:使用当前 Agent 运行时暴露的内置工具,例如 AskUserQuestionrequest_user_inputclarifyask_user 或任何同等工具。
  2. 后备方案:若无此类工具,则输出带编号的纯文本消息,请用户回复对应问题的编号或答案。
  3. 批量提问:若工具支持单次调用抛出多个问题,请将所有适用问题整合在一次调用中;若仅支持单问,则按优先级顺序依次提问。

下文涉及 AskUserQuestion 的具体描述仅为示例,在其他运行时中请替换为对应的本地工具。

图像生成工具 (Image Generation Tools)

当本 Skill 需要渲染图片时,请按以下顺序解析后台渲染引擎:

  1. 当前请求指定覆盖:若用户在当前消息中明确指定了某个后台引擎,直接使用该引擎。
  2. 已保存的偏好设置:若 EXTEND.md 中将 preferred_image_backend 设置为了当前可用的后台引擎,直接使用该引擎。
  3. 自动选择(当偏好设置为 auto、未设置或绑定的后台引擎不可用时):
    • Codex (imagegen):首先检查可用技能/工具清单。若包含名为 imagegen 的 Skill,说明当前运行在 Codex 环境中,必须优先使用它:通过 Skill 工具调用 skill: "imagegen",传入已保存的 Prompt 文件内容(并按 Codex imagegen 自身的参数传递输出路径与宽高比)。Codex imagegen 是该运行时下的官方位图生成后台,优先级高于任何非原生 Skill(如 baoyu-image-gen),除非用户显式绑定了其他 preferred_image_backend
    • 通过 codex exec 调用 Codex (codex-imagegen):若当前运行时未暴露原生 imagegen Skill,但 PATH 中存在 codex CLI 且已完成 codex login 登录,则优先通过 baoyu-image-gen --provider codex-cli 路由;若 baoyu-image-gen 不可用,则直接调用内置包装器。详细信息、参数及运行时检测流程参见 references/codex-imagegen.md——仅当命中此分支时才加载该文件。
    • Cursor (GenerateImage):若运行时暴露了原生 GenerateImage 工具,说明当前运行在 Cursor 环境中,其优先级与 Codex imagegen 相同,高于任何非原生 Skill。注意两个硬性限制:(a) 无宽高比参数——须在作为 description 传入的 Prompt 文本中明确写明目标宽高比/尺寸;(b) 不接受输出目录——图片会保存到工具托管的位置,因此生成后需手动复制/移动文件到 Skill 预期的输出路径(如 outputs/.../NN-xxx.png)。参考图传入 reference_image_paths
    • 其他运行时原生工具:若运行时暴露了其他原生图像工具(如 Hermes 的 image_generate),按照相同规则使用。
    • 否则,若仅安装了一个非原生后台(如 baoyu-image-gen),直接使用该后台。
    • 否则(存在多个非原生后台且无运行时原生工具),询问用户一次——与初始的其他问题合并提问。
  4. 若均不可用:告知用户并询问如何继续。

⛔ 严禁使用 SVG、HTML、Canvas 或其他基于代码的渲染替代位图图像生成。 Codex imagegen 自身的说明明确指出它应用于“输出应为位图资产而非代码或矢量图”的场景。若无法通过步骤 3 解析出位图后台,请退到步骤 4 询问用户——切勿静默生成 SVG、编写内联 <svg> 标签或制作 HTML/CSS 图形作为替代。即使文章/章节看起来像“图表”,调用本规则的上层 Skill 也已明确判定其需要的是位图。

⛔ 严禁通过在已生成的位图上二次覆盖绘制来修补文字。 禁止使用 ImageMagick、Pillow、Canvas、SVG、HTML/CSS、OCR 脚本或任何其他程序化覆盖手段,去掩盖、重写、擦除、加粗或替换已有幻灯片图片中的标题、要点或任何文字。若文字有误或不清晰,请使用修正后的 Prompt 重新生成、精简图片上的文字,或让用户决定保留哪张不完美的候选图。

preferred_image_backend 设置为 ask 会强制每次运行都在步骤 3 弹出询问,无论当前有哪些可用后台。用户可通过下文 ## 更改偏好设置 章节修改绑定的后台引擎。

Prompt 文件格式要求(硬性): 在调用任何后台之前,必须将每张图片的完整最终 Prompt 写入 prompts/ 目录下的独立文件中(命名规则:NN-slide-[slug].md)。该文件是可复现性记录,便于在不重新生成 Prompt 的情况下切换后台引擎。

上文列出的具体工具名称(imagegenGenerateImageimage_generatebaoyu-image-gen)均为示例——在相同规则下请替换为对应环境中的等效工具。

批量生成策略 (Batch Generation Policy)

在当前生成组的所有 Prompt 文件保存并校验无误后,默认按批次生成幻灯片图片。

优先级顺序:

  1. 若选择的后台支持原生批量/多任务接口,优先使用原生接口。每个任务必须保留各自独立的 Prompt 文件、输出路径、宽高比、Session ID 和直接参考图。
  2. 若无原生批量接口但运行时支持并行工具调用,单次最多并发分发 generation_batch_size 张幻灯片图片。默认值:4。若当前消息中包含显式参数请求(如 --batch-size 4 或“并行4张一起生成”),优先级高于 EXTEND.md
  3. 若原生批量和并行工具调用均不支持,则按顺序串行生成。

规则:

  • 在所有选定幻灯片 Prompt 文件均已写入磁盘前,切勿启动第一批次的生成。
  • 失败项重试一次,无需重新生成已成功的项。
  • 切勿仅为了图片渲染并行化而使用 Subagent。Subagent 仅用于独立的 Prompt 迭代或创意探索。
  • 仅在所有选定幻灯片图片全部生成完成后,再合并导出 PPTX/PDF。

确认策略 (Confirmation Policy)

默认行为:生成前确认

  • 显式 Skill 调用、文件路径、匹配到的信号/预设以及 EXTEND.md 默认值,均仅作为推荐输入。其中任何一项都不能作为跳过确认步骤的授权。
  • 在用户完成步骤 2 之前,切勿启动步骤 3 或后续步骤。
  • 仅当当前请求中明确要求跳过时才跳过确认,例如:“直接生成”、“不用确认”、“跳过确认”、“按默认出幻灯片”或类似表述。
  • 若显式跳过了确认,在开始生成前的下一次用户反馈中,须明确说明所采用的风格 / 受众 / 幻灯片页数 / 语言 / 后台引擎。

语言 (Language)

在提问、进度汇报、错误提示及最终完成总结中,统一使用用户的语言回答。保留技术 Token(风格名称、文件路径、代码)为英文。

脚本目录 (Script Directory)

{baseDir} = 本 SKILL.md 所在的目录。解析 ${BUN_X}:优先使用 bun;其次使用 npx -y bun;否则建议运行 brew install oven-sh/bun/bun 安装。

脚本 用途
scripts/merge-to-pptx.ts 将幻灯片图片合并导出为 PowerPoint (PPTX)
scripts/merge-to-pdf.ts 将幻灯片图片合并导出为 PDF

可选参数 (Options)

参数 说明
--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 生成 Prompt 后即停止(跳过图片生成)
--images-only 直接跳到步骤 7;要求已存在 prompts/ 目录
--regenerate <N> 重新生成指定页码的幻灯片:如 32,5,8

风格体系 (Style System)

包含 17 种预设风格,覆盖技术、教育、生活方式及出版物等场景。每种预设都是四个维度(质感 / 氛围 / 排版 / 密度)的组合。若用户在第 1 轮确认中选择了“自定义维度”(Custom dimensions),第 2 轮确认将针对每个维度提问一个问题——选项与逐字文案参见 references/confirmation.md

预设风格列表 (17)

预设风格 四维组合 (Texture / Mood / Typography / Density) 最佳适用场景
blueprint(默认) grid + cool + technical + balanced 架构图、系统设计
chalkboard organic + warm + handwritten + balanced 教育、教程
corporate clean + professional + geometric + balanced 投资者演示文稿、商务提案
minimal clean + neutral + geometric + minimal 高管简报
sketch-notes organic + warm + handwritten + balanced 教育、教程笔记
hand-drawn-edu organic + macaron + handwritten + balanced 教育图解、流程讲解
watercolor organic + warm + humanist + minimal 生活方式、健康养生
dark-atmospheric clean + dark + editorial + balanced 娱乐、游戏
notion clean + neutral + geometric + dense 产品 Demo、SaaS 产品介绍
bold-editorial clean + vibrant + editorial + balanced 产品发布会、主旨演讲 (Keynote)
editorial-infographic clean + cool + editorial + dense 技术讲解、研究报告
fantasy-animation organic + vibrant + handwritten + minimal 教育故事化表达
intuition-machine clean + cool + technical + dense 技术文档、学术报告
pixel-art pixel + vibrant + technical + balanced 游戏、开发者演讲
scientific clean + cool + technical + dense 生物、化学、医疗领域
vector-illustration clean + vibrant + humanist + balanced 创意内容、儿童内容
vintage paper + warm + editorial + balanced 历史人文、复古传承

各预设的具体规范参见 references/styles/<preset>.md。预设到维度的映射关系参见 references/dimensions/presets.md

维度划分(当选择“自定义维度”时)

维度 选项 作用
质感 (Texture) clean, grid, organic, pixel, paper 背景材质处理
氛围 (Mood) professional, warm, cool, vibrant, dark, neutral, macaron 色温与色彩基调
排版 (Typography) geometric, humanist, handwritten, editorial, technical 标题与正文字体风格
密度 (Density) minimal, balanced, dense 每张幻灯片的信息量

各维度的完整规范参见 references/dimensions/*.md

自动匹配 (Auto-Selection)

根据内容关键词自动匹配预设风格。命中源文本中最先匹配到的关键词行即选择对应预设;若均未命中,则回退默认的 blueprint

源文本匹配关键词 对应预设
tutorial, learn, education, guide, beginner sketch-notes
hand-drawn, infographic, diagram, process, onboarding hand-drawn-edu
classroom, teaching, school, chalkboard chalkboard
architecture, system, data, analysis, technical blueprint
creative, children, kids, cute vector-illustration
briefing, academic, research, bilingual intuition-machine
executive, minimal, clean, simple minimal
saas, product, dashboard, metrics notion
investor, quarter corporate