根据输入内容生成专业级幻灯片(Slide Deck)图片。先创建带有风格指令的大纲,再逐张生成幻灯片图片。适用于用户提出“制作幻灯片”、“做 PPT”、“生成演示文稿”、“制作 Slide Deck”等需求时。
幻灯片生成器 (Slide Deck Generator)
将输入内容转换为专业的幻灯片图片。这套幻灯片专为阅读与分享(信息自解释、滚动浏览顺畅、适合社交媒体传播)而设计,而非现场演讲展示——这一定位决定了后续所有的布局与信息密度设计。
用户输入工具 (User Input Tools)
当本 Skill 需要提示用户输入时,请按以下优先级顺序选择工具:
- 优先使用内置用户输入工具:使用当前 Agent 运行时暴露的内置工具,例如
AskUserQuestion、request_user_input、clarify、ask_user或任何同等工具。 - 后备方案:若无此类工具,则输出带编号的纯文本消息,请用户回复对应问题的编号或答案。
- 批量提问:若工具支持单次调用抛出多个问题,请将所有适用问题整合在一次调用中;若仅支持单问,则按优先级顺序依次提问。
下文涉及 AskUserQuestion 的具体描述仅为示例,在其他运行时中请替换为对应的本地工具。
图像生成工具 (Image Generation Tools)
当本 Skill 需要渲染图片时,请按以下顺序解析后台渲染引擎:
- 当前请求指定覆盖:若用户在当前消息中明确指定了某个后台引擎,直接使用该引擎。
- 已保存的偏好设置:若
EXTEND.md中将preferred_image_backend设置为了当前可用的后台引擎,直接使用该引擎。 - 自动选择(当偏好设置为
auto、未设置或绑定的后台引擎不可用时):- Codex (
imagegen):首先检查可用技能/工具清单。若包含名为imagegen的 Skill,说明当前运行在 Codex 环境中,必须优先使用它:通过Skill工具调用skill: "imagegen",传入已保存的 Prompt 文件内容(并按 Codeximagegen自身的参数传递输出路径与宽高比)。Codeximagegen是该运行时下的官方位图生成后台,优先级高于任何非原生 Skill(如baoyu-image-gen),除非用户显式绑定了其他preferred_image_backend。 - 通过
codex exec调用 Codex (codex-imagegen):若当前运行时未暴露原生imagegenSkill,但PATH中存在codexCLI 且已完成codex login登录,则优先通过baoyu-image-gen --provider codex-cli路由;若 baoyu-image-gen 不可用,则直接调用内置包装器。详细信息、参数及运行时检测流程参见 references/codex-imagegen.md——仅当命中此分支时才加载该文件。 - Cursor (
GenerateImage):若运行时暴露了原生GenerateImage工具,说明当前运行在 Cursor 环境中,其优先级与 Codeximagegen相同,高于任何非原生 Skill。注意两个硬性限制:(a) 无宽高比参数——须在作为description传入的 Prompt 文本中明确写明目标宽高比/尺寸;(b) 不接受输出目录——图片会保存到工具托管的位置,因此生成后需手动复制/移动文件到 Skill 预期的输出路径(如outputs/.../NN-xxx.png)。参考图传入reference_image_paths。 - 其他运行时原生工具:若运行时暴露了其他原生图像工具(如 Hermes 的
image_generate),按照相同规则使用。 - 否则,若仅安装了一个非原生后台(如
baoyu-image-gen),直接使用该后台。 - 否则(存在多个非原生后台且无运行时原生工具),询问用户一次——与初始的其他问题合并提问。
- Codex (
- 若均不可用:告知用户并询问如何继续。
⛔ 严禁使用 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 的情况下切换后台引擎。
上文列出的具体工具名称(imagegen、GenerateImage、image_generate、baoyu-image-gen)均为示例——在相同规则下请替换为对应环境中的等效工具。
批量生成策略 (Batch Generation Policy)
在当前生成组的所有 Prompt 文件保存并校验无误后,默认按批次生成幻灯片图片。
优先级顺序:
- 若选择的后台支持原生批量/多任务接口,优先使用原生接口。每个任务必须保留各自独立的 Prompt 文件、输出路径、宽高比、Session ID 和直接参考图。
- 若无原生批量接口但运行时支持并行工具调用,单次最多并发分发
generation_batch_size张幻灯片图片。默认值:4。若当前消息中包含显式参数请求(如--batch-size 4或“并行4张一起生成”),优先级高于 EXTEND.md。 - 若原生批量和并行工具调用均不支持,则按顺序串行生成。
规则:
- 在所有选定幻灯片 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> |
重新生成指定页码的幻灯片:如 3 或 2,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 |




