baoyu-infographic

信息图生成器

两个维度：布局（信息结构）× 风格（视觉美感）。可自由组合任意布局与任意风格。

用户输入工具

当此技能向用户提问时，请遵循以下工具选择规则（按优先级排序）：

1. 优先使用当前 Agent 运行时提供的内置用户输入工具，例如 AskUserQuestion、request_user_input、clarify、ask_user 或任何等效工具。
2. 回退方案：如果没有这类工具，则发送带编号的纯文本消息，并请用户针对每个问题回复所选编号或答案。
3. 批量提问：如果工具支持每次调用提出多个问题，则将所有适用问题合并到一次调用中；如果只支持单个问题，则按优先级逐一提问。

下方对 AskUserQuestion 的具体引用仅为示例——在其他运行时中，请替换为本地等效工具。

图像生成工具

此技能需要渲染图像时，请按以下顺序确定后端：

1. 当前请求覆盖项——如果用户在当前消息中指定了特定后端，请使用该后端。
2. 已保存的偏好——如果 EXTEND.md 将 preferred_image_backend 设为当前可用的后端，请使用该后端。
3. 自动选择（偏好为 auto、未设置，或固定的后端不可用时）：
   • Codex（imagegen）——首先检查可用技能／工具清单。如果列出了名为 imagegen 的技能，说明你正在 Codex 中运行，必须使用该技能：通过 Skill 工具调用，设置 skill: "imagegen"，并传入已保存提示词文件的内容（以及 Codex imagegen 自身参数所要求的输出路径和宽高比）。Codex imagegen 是该运行时的官方栅格图像后端，其优先级高于任何非原生技能（例如 baoyu-image-gen），除非用户明确指定了其他 preferred_image_backend。
   • 通过 codex exec 使用 Codex（codex-imagegen）——如果当前运行时没有原生 imagegen 技能，但 codex CLI 位于 PATH 中且已登录 Codex，则通过 baoyu-image-gen --provider codex-cli 调用（优先），或在 baoyu-image-gen 不可用时直接调用捆绑的包装器。详情、参数和运行时发现流程见 references/codex-imagegen.md——仅在选择此分支时加载该文件。
   • Cursor（GenerateImage）——如果运行时提供原生 GenerateImage 工具，说明你正在 Cursor 中运行，其优先级高于任何非原生技能，与 Codex imagegen 相同。有两个重要限制：(a) 它没有宽高比参数——请在传入 description 的提示文本中明确说明目标宽高比／尺寸；(b) 它不接受输出目录——文件会保存到由工具管理的位置，因此生成后需将文件复制／移动到技能要求的输出路径（例如 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 艺术图作为替代。即使文章／章节看起来“像图表”，也同样适用：调用此规则的使用方技能已经确定需要栅格图像。 ⛔ 切勿通过在生成的位图上覆盖绘制来修复渲染后的文本。 请勿使用 ImageMagick、Pillow、Canvas、SVG、HTML/CSS、OCR 脚本或任何其他程序化叠加方式，遮盖、改写、擦除、描边或替换已生成的信息图中的标签、标题、标注、数据值或任何其他文本。如果文本有误或不清晰，请使用修正后的提示词重新生成，改用图中文字较少的布局，或询问用户希望保留哪个不完美的候选版本。

无论是否有可用后端，将 preferred_image_backend: ask 设为首选项都会强制每次运行时都显示步骤 3 的提示。用户可通过下方的 ## Changing Preferences 部分更改固定使用的后端。

提示词文件要求（硬性规定）：调用任何后端之前，先将每张图完整的最终提示词写入 prompts/ 下的独立文件（命名格式：NN-{type}-[slug].md）。后端接收提示词文件（或其内容）；该文件是可复现记录，也让你可以切换后端而无需重新生成提示词。

上文中的具体工具名称（imagegen、GenerateImage、image_generate、baoyu-image-gen）仅为示例——请按照相同规则替换为本地对应工具。

参考图像

用户可以提供参考图像，用于指导风格、配色、构图或主题。

接收方式：通过 --ref <files...> 接收，或在用户提供文件路径／在对话中粘贴图像时接收。

• 文件路径 → 将文件复制到与输出文件同级的 refs/NN-ref-{slug}.{ext}
• 粘贴的图像没有路径 → 请用户提供路径（遵循上述“用户输入工具”规则），或通过文字提取风格特征作为替代方案
• 没有参考图像 → 跳过本节

使用方式（每张参考图像）：

用途	效果
direct	将文件作为参考图像传给后端
style	提取风格特征（线条处理、纹理、氛围）并附加到提示词正文
palette	从图像中提取十六进制颜色值并附加到提示词正文

存在参考图像时，在 prompts/infographic.md 的 frontmatter 中记录：

references:
  - ref_id: 01
    filename: 01-ref-brand.png
    usage: direct

生成时：

• 确认每个引用的文件都存在于磁盘上
• 若 usage: direct 且所选后端接受参考图像（例如，通过 --ref 使用 baoyu-image-gen）→ 通过后端的参考参数传入文件
• 否则 → 将提取的 style／palette 特征嵌入提示词文本

确认策略

默认行为：生成前先确认。

• 将明确调用技能、文件路径、匹配的关键词快捷方式、EXTEND.md 默认值以及文档中规定的默认组合都视为建议输入。它们都不能授权跳过确认。
• 用户确认组合／宽高比／语言／后端选项之前，不要开始步骤 5 或步骤 6。
• 仅当当前请求明确要求跳过确认时才跳过，例如：--no-confirm、“直接生成”、“不用确认”、“跳过确认”、“按默认出图”或类似措辞。
• 如果用户明确要求跳过确认，请在生成前的下一条面向用户的更新中说明假定的组合／宽高比／语言／后端。

选项

选项	值
--layout	21 种选项（参见布局库），默认：bento-grid
--style	22 种选项（参见风格库），默认：craft-handmade
--aspect	命名选项：landscape（16:9）、portrait（9:16）、square（1:1）。自定义：任意 W:H 比例（例如 3:4、4:3、2.35:1）
--lang	en、zh、ja 等
--no-confirm	仅当用户明确要求不经确认直接生成时，跳过步骤 4
--ref <files...>	参考图像（文件路径），用于指导风格／配色／构图／主题

布局一览（21）

布局	最适用于
linear-progression	时间线、流程、教程
binary-comparison	A 与 B、前后对比、优缺点
comparison-matrix	多因素比较
hierarchical-layers	金字塔、优先级层级
tree-branching	类别、分类体系
hub-spoke	带有关联项的中心概念
structural-breakdown	爆炸图、剖面图
bento-grid	多个主题、概览（默认）
iceberg	表面与隐藏的方面
bridge	问题与解决方案
funnel	转化、筛选
isometric-map	空间关系
dashboard	指标、KPI
periodic-table	分类集合
comic-strip	叙事、序列
story-mountain	情节结构、张力曲线
jigsaw	相互关联的部分
venn-diagram	重叠概念
winding-roadmap	旅程、里程碑
circular-flow	循环、重复流程
dense-modules	高密度模块、数据丰富的指南

完整定义见 references/layouts/<layout>.md。

风格一览（22）

风格	描述
craft-handmade	手绘、纸艺（默认）
claymation	3D 黏土人物、定格动画
kawaii	日式可爱风、柔和色彩
storybook-watercolor	柔和的水彩画、奇幻风格
chalkboard	黑板粉笔画
cyberpunk-neon	霓虹光效、未来主义
bold-graphic	漫画风格、半色调
aged-academia	复古科学风、棕褐色调
corporate-memphis	扁平矢量、鲜艳色彩
technical-schematic	蓝图、工程风格
origami	折纸、几何风格
pixel-art	复古 8 位风格
ui-wireframe	灰度界面模型
subway-map	地铁线路图
ikea-manual	极简线稿
knolling	整齐排列的平铺俯拍
lego-brick	玩具积木搭建
pop-laboratory	蓝图网格、坐标标记、实验室般的精确感
morandi-journal	手绘涂鸦、温暖的莫兰迪色调
retro-pop-grid	20 世纪 70 年代复古波普艺术、瑞士网格、粗描边
hand-drawn-edu	马卡龙色调、手绘抖动线条、简笔人物
retro-popup-pop	复古弹窗拼贴、怀旧 UI、粗描边、平涂波普色彩

完整定义见 references/styles/<style>.md。

推荐组合

内容类型	布局 + 风格
时间线／历史	linear-progression + craft-handmade
分步指南	linear-progression + ikea-manual
A 与 B 对比	binary-comparison + corporate-memphis
层级结构	hierarchical-layers + craft-handmade
重叠关系	venn-diagram + craft-handmade
转化	funnel + corporate-memphis
循环	circular-flow + craft-handmade
技术内容	structural-breakdown + technical-schematic
指标	dashboard + corporate-memphis
教育内容	bento-grid + chalkboard
旅程	winding-roadmap + storybook-watercolor
分类	periodic-table + bold-graphic
产品指南	dense-modules + morandi-journal
技术指南	dense-modules + pop-laboratory
潮流指南	dense-modules + retro-pop-grid
复古波普指南	dense-modules + retro-popup-pop
教育图示	hub-spoke + hand-drawn-edu
流程教程	linear-progression + hand-drawn-edu

默认组合：bento-grid + craft-handmade（仅作为后备建议——根据确认政策，默认值绝不会绕过步骤 4）。

关键词快捷方式

当用户输入中包含以下关键词时，将映射的布局作为步骤 3 的首选推荐，并将列出的风格置于步骤 3 列表的顶部。对于匹配的关键词，跳过基于内容的布局推断。将任何 Prompt Notes 附加到步骤 5 的提示词中。

用户关键词	布局	推荐风格	默认宽高比	提示词备注
高密度信息大图 / high-density-info	dense-modules	morandi-journal、pop-laboratory、retro-pop-grid、retro-popup-pop	portrait	—
信息图 / infographic	bento-grid	craft-handmade	landscape	极简风格：画布干净、留白充足，不使用复杂的背景纹理。仅使用简单的卡通元素和图标。

输出结构

infographic/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── structured-content.md
├── prompts/infographic.md
└── infographic.png

Slug：根据主题生成 2-4 个词，以 kebab-case 格式书写。冲突时：追加 -YYYYMMDD-HHMMSS。

核心原则

• 忠实保留源数据——不得概括或改写（但在输出中包含任何凭据、API 密钥、令牌或机密之前，必须将其删除）
• 在构建内容结构前明确学习目标
• 围绕视觉传达构建结构（标题、标签、视觉元素）

工作流

步骤 1：设置与分析

1.1 加载偏好设置（EXTEND.md）

按优先级顺序检查 EXTEND.md——以首先找到的文件为准：

优先级	路径	范围
1	.baoyu-skills/baoyu-infographic/EXTEND.md	项目
2	${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-infographic/EXTEND.md	XDG
3	$HOME/.baoyu-skills/baoyu-infographic/EXTEND.md	用户主目录

结果	操作
找到	阅读、解析并显示一行摘要
未找到	使用 AskUserQuestion 询问用户（参见 references/config/first-time-setup.md）

EXTEND.md 支持：首选布局/风格、默认宽高比、语言偏好、首选图像后端、自定义风格定义。

Schema：references/config/preferences-schema.md

1.2 分析内容 → analysis.md

1. 保存源内容（文件路径或粘贴内容 → source.md）
   • 备份规则：如果 source.md 已存在，将其重命名为 source-backup-YYYYMMDD-HHMMSS.md
2. 分析：主题、数据类型、复杂度、语气、受众
3. 检测源语言和用户语言
4. 从用户输入中提取设计指令
5. 保存分析结果
   • 备份规则：如果 analysis.md 已存在，将其重命名为 analysis-backup-YYYYMMDD-HHMMSS.md

详细格式参见 references/analysis-framework.md。

步骤 2：生成结构化内容 → structured-content.md

将内容转换为信息图结构：

1. 标题和学习目标
2. 各个部分包含：核心概念、内容（逐字照录）、视觉元素、文本标签
3. 数据点（所有统计数据/引文均须原样复制）
4. 用户提供的设计指令

规则：仅使用 Markdown。不得添加新信息。忠实保留数据。从输出中删除任何凭据或机密。

详细格式参见 references/structured-content-template.md。

步骤 3：推荐组合

3.1 首先检查关键词快捷方式：如果用户输入匹配关键词快捷方式表中的关键词，则使用对应布局作为首选推荐，并将对应风格优先列为推荐选项。跳过基于内容的布局推断。

3.2 否则，根据以下因素推荐 3-5 种布局×风格组合：

• 数据结构 → 匹配的布局
• 内容语气 → 匹配的风格
• 受众预期
• 用户的设计指令

步骤 4：确认选项

强制关卡：根据确认政策，此步骤为必需步骤——用户在此确认（或在当前请求中明确使用 --no-confirm / 等效方式选择跳过）之前，不得开始步骤 5–6。

按照本文件顶部的用户输入工具规则，请用户确认以下问题（如果运行时支持同时提出多个问题，则合并为一次调用；否则按优先级逐一询问）。

优先级	问题	适用时机	选项
1	组合	始终	提供 3 种或更多布局×风格组合，并说明理由
2	宽高比	始终	命名预设（横向／纵向／正方形）或自定义 W:H 比例（例如 3:4、4:3、2.35:1）
3	语言	仅当源内容语言 ≠ 用户语言时	文本内容所用语言
4	图像后端	仅当 ## Image Generation Tools 规则的步骤 3 需要询问时（没有运行时原生工具且存在多个非原生后端，或 preferred_image_backend: ask）	可用后端

步骤 5：生成提示词 → prompts/infographic.md

备份规则：如果 prompts/infographic.md 已存在，将其重命名为 prompts/infographic-backup-YYYYMMDD-HHMMSS.md

组合以下内容：

1. references/layouts/<layout>.md 中的布局定义
2. references/styles/<style>.md 中的风格定义
3. references/base-prompt.md 中的基础模板
4. 步骤 2 中的结构化内容
5. 所有内容均使用已确认的语言

{{ASPECT_RATIO}} 的宽高比解析规则：

• 命名预设 → 比例字符串：横向→16:9，纵向→9:16，正方形→1:1
• 自定义 W:H 比例 → 按原样使用（例如 3:4、4:3、2.35:1）

步骤 6：生成图像

1. 按照本文件顶部的 ## Image Generation Tools 规则解析后端。
2. 调用后端之前，确保完整的最终提示词已保存至 prompts/infographic.md（已在步骤 5 中写入）——该文件是可复现性记录。
3. 检查是否存在已有文件：生成前，检查 infographic.png 是否存在
   • 如果存在：将其重命名为 infographic-backup-YYYYMMDD-HHMMSS.png
4. 使用提示词文件和输出路径调用所选后端。
   • codex-imagegen 调用：如果规则解析为 codex-imagegen，请参阅 references/codex-imagegen.md 了解调用约定（首选 baoyu-image-gen --provider codex-cli 路径、运行时封装器发现、参数说明、标准输出结构、批处理语义）。
5. 如果失败，自动重试一次

文本更正政策：

• 如果标签、标题、注释、数据值或任何其他渲染文本有拼写错误、乱码、难以辨认或视觉效果欠佳，请勿使用代码修补位图。
• 对于文本更正后的重新生成，请编写新的提示词文件并使用新的输出路径，以保留有问题的候选版本供对比。
• 后期处理仅限于裁剪、调整大小、压缩或格式转换，且不得更改文本或主要构图。

步骤 7：输出摘要

报告：主题、布局、风格、宽高比、语言、图像后端、输出路径、创建的文件。

参考资料

• references/analysis-framework.md - 分析方法
• references/structured-content-template.md - 内容格式
• references/base-prompt.md - 提示词模板
• references/layouts/<layout>.md - 21 种布局定义
• references/styles/<style>.md - 21 种风格定义

修改偏好设置

EXTEND.md 位于步骤 1.1 中第一个匹配的路径。有三种修改方式：

• 直接编辑 — 打开 EXTEND.md 并修改字段。完整的架构定义见：references/config/preferences-schema.md。
• 交互式重新配置 — 删除 EXTEND.md（或询问“reconfigure baoyu-infographic preferences”／“重新配置”）。下次运行时会重新触发首次设置。
• 常见的单行修改：
  • preferred_image_backend: auto — 默认值；优先使用运行时原生工具，若只有一个已安装的后端则回退使用该后端，只有存在多个非原生后端时才会询问。
  • preferred_image_backend: codex-imagegen — 固定使用 Codex 内置工具。
  • preferred_image_backend: baoyu-image-gen — 固定使用 baoyu-image-gen 技能。
  • preferred_image_backend: ask — 每次运行时确认后端。
  • preferred_layout: dense-modules、preferred_style: morandi-journal、preferred_aspect: portrait、language: zh — 调整步骤 3 的建议和步骤 4 的默认值（根据确认策略，这些设置都不会跳过步骤 4）。