baoyu-xhs-images

图文卡片系列生成器

将复杂内容拆解为吸睛的系列图片卡片，支持丰富样式自由组合。

用户交互工具

当本 Skill 向用户发起提问或确认时，请按以下优先级选择交互工具：

1. 优先使用当前 Agent 运行时提供的内置交互工具——例如 AskUserQuestion、request_user_input、clarify、ask_user 或任何同等工具。
2. 降级方案：若不存在此类工具，则输出带序号的纯文本消息，请用户回复每道问题对应的选项序号或答案。
3. 批量提问：若工具支持在单次调用中提出多个问题，请将所有适用问题整合至一次调用；若仅支持单问，则按优先级依次提问。

下文引用的 AskUserQuestion 均为示例——在其他运行时中请替换为对应的本地工具。

图片生成工具

当本 Skill 需要渲染图片时，按以下顺序确定生成后端：

1. 当前请求指定——若用户在当前消息中明确指明了具体后端，直接使用该后端。
2. 保存的偏好设置——若 EXTEND.md 中将 preferred_image_backend 设置为当前可用的后端，使用该后端。
3. 自动选择（当偏好设置为 auto、未设置，或预设的后端不可用时）：
   • Codex (imagegen)——首先检查可用的 Skill / 工具清单。若列出了名为 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-{type}-[slug].md）。该文件是可复现性的记录，便于在不重新生成 Prompt 的情况下切换不同后端。

上述的具体工具名称（imagegen、GenerateImage、image_generate、baoyu-image-gen）均为示例——在其他运行时中按同样规则替换为本地对应的工具。

批量生成策略

当前生成组的所有 Prompt 文件均已保存并校验完成后，默认采用批量生成模式。

优先级顺序：

1. 若所选后端支持原生批量/多任务接口，优先使用。每个任务必须维护各自独立的 Prompt 文件、输出路径、宽高比、Session ID 和直接参考图。
2. 若无原生批量接口但运行时支持并行工具调用，单次最多并发分发 generation_batch_size 张图片。默认值：4。若用户在当前消息中显式提出要求（如 --batch-size 4 或“并行 4 张一起生成”），优先级高于 EXTEND.md。
3. 若既无原生批量接口也不支持并行工具调用，则按顺序串行生成。

生成规则：

• 严格遵循“图 1 锚定链”：优先生成第 1 张图，后续第 2+ 张图以第 1 张图作为参考图进行批量生成。
• 在该批次的所有 Prompt 文件落盘之前，不得启动批量生成。
• 针对失败项仅重试一次，无需重新生成已成功项。
• 切勿仅为了并行渲染图片而使用 Subagent。Subagent 仅限用于独立的 Prompt 迭代或创意探索。

确认策略

默认行为：生成前必须确认。

• 显式 Skill 调用、文件路径、匹配到的信号/预设以及 EXTEND.md 中的默认值均仅作为推荐输入，均无权跳过确认步骤。
• 在用户完成步骤 2 之前，不得启动步骤 3。
• 仅当当前请求明确要求跳过时方可跳过确认，例如包含：--yes、“直接生成”、“不用确认”、“跳过确认”、“按默认出图”或类似表述。
• 若显式跳过了确认，需在生成前面向用户的最新进度更新中，说明所采用的策略 / 风格 / 布局 / 调色盘 / 张数 / 后端。

语言规范

在所有提问、进度提示、错误信息及完成总结中，均使用用户的语言进行回复。保持技术 Token（风格名称、文件路径、代码）为英文。

参数选项

选项	说明
--style <name>	视觉风格（见下文“视觉风格”）
--layout <name>	信息布局（见下文“信息布局”）
--palette <name>	覆盖调色盘：macaron / warm / neon
--preset <name>	风格 + 布局 + 可选调色盘的组合快捷方式（见下文“预设组合”；各预设 Prompt 片段见 references/style-presets.md）
--ref <files...>	参考图片，应用于第 1 张图作为全套卡片的风格锚点
--batch-size <n>	本次运行的临时生成批次大小。默认值：优先取 EXTEND.md 中的 generation_batch_size，否则为 4。限制范围 1-8。
--yes	非交互模式：跳过所有确认，直接使用 EXTEND.md 或内置默认值，自动确认推荐方案（Path A）

组合维度

三个独立调节维度可自由组合：

维度	控制内容	可选项
风格 (Style)	视觉美学（线条、装饰、渲染质感）	12 种风格（见下文“视觉风格”）
布局 (Layout)	信息结构（密度、排布方式）	8 种布局（见下文“信息布局”）
调色盘 (Palette)（可选）	覆盖颜色，替换风格的默认配色	macaron / warm / neon（见下文“调色盘”）

示例：--style notion --layout dense 可打造干货满满的知识卡片；叠加 --palette macaron 可在不改变 notion 渲染规则的前提下让配色更柔和。--preset 是“风格 + 布局（+ 可选调色盘）”的组合快捷方式。

调色盘生效逻辑：未指定 --palette → 使用风格内置配色；指定 --palette <name> → 仅覆盖颜色，渲染规则保持不变。部分风格声明了 default_palette（例如 sketch-notes 默认使用 macaron）。

视觉风格 (12)

风格	说明
cute（默认）	甜美、可爱、少女感美学
fresh	清新、干净、自然
warm	温暖、亲切、易于接近
bold	高视觉冲击力、强引流吸睛
minimal	极简、高级感
retro	复古、怀旧、潮酷
pop	鲜艳、富有活力、夺目
notion	极简手绘线条、偏知性风格
chalkboard	黑板彩色粉笔画，适合教育科普
study-notes	写实手写拍照风，蓝笔 + 红笔批注 + 黄色高光笔
screen-print	撞色海报风、半音阶网点纹理、限量配色、视觉隐喻叙事
sketch-notes	手绘教育图解，米白底色 + 玛卡龙粉彩，带手绘抖动线条

各风格详细规范见：references/presets/<style>.md。

信息布局 (8)

布局	说明
sparse（默认）	1-2 个核心要点，突出视觉冲击
balanced	3-4 个要点，标准均衡排布
dense	5-8 个要点，干货知识卡风格
list	列表罗列 / 排行榜（4-7 项）
comparison	双栏左右对比
flow	步骤流程 / 时间轴（3-6 步）
mindmap	中心放射状思维导图（4-8 个分支）
quadrant	四象限 / 环形分块

布局规范见：references/elements/canvas.md。

调色盘（可选覆盖）

在保持渲染规则（线条处理、纹理质感）不变的前提下替换风格颜色。

调色盘	背景色	分区颜色	强调色	视觉氛围
macaron	暖米色 #F5F0E8	蓝色 #A8D8EA、薰衣草紫 #D5C6E0、薄荷绿 #B5E5CF、蜜桃粉 #F8D5C4	珊瑚红 #E8655A	柔和、适合教育科普
warm	柔和蜜桃色 #FFECD2	橙色 #ED8936、陶土红 #C05621、金色 #F6AD55、玫瑰粉 #D4A09A	赭石色 #A0522D	大地色系、温暖舒适
neon	深紫色 #1A1025	青色 #00F5FF、洋红 #FF00FF、荧光绿 #39FF14、粉红 #FF6EC7	亮黄 #FFFF00	高能量、未来科技感

调色盘规范见：references/palettes/<palette>.md。

预设组合（风格 + 布局快捷方式）

开箱即用的组合方案，按场景分类。可直接使用 --preset <name> 或在步骤 2 中进行推荐。

知识与学习：

预设组合	风格	布局	适用场景
knowledge-card	notion	dense	干货知识卡、概念科普
checklist	notion	list	清单、排行榜
concept-map	notion	mindmap	概念图、知识脉络
swot	notion	quadrant	SWOT 分析、四象限
tutorial	chalkboard	flow	教程步骤、操作流程
classroom	chalkboard	balanced	课堂笔记、知识讲解
study-guide	study-notes	dense	学习笔记、考试重点
hand-drawn-edu	sketch-notes	flow	手绘教程、流程图解
sketch-card	sketch-notes	dense	手绘知识卡
sketch-summary	sketch-notes	balanced	手绘总结、图文笔记

生活与分享：

预设组合	风格	布局	适用场景
cute-share	cute	balanced	少女风分享、日常种草
`

<!-- truncated for translation batch; full body continues in source -->