Baoyu 文章配图师
文章配图:类型 × 风格 × 配色保持一致。
Skill 元数据
| Source | Optional — 使用 kopi skills install official/creative/baoyu-article-illustrator 安装 |
| Path | optional-skills/creative/baoyu-article-illustrator |
| Version | 1.57.0 |
| Author | 宝玉 (JimLiu) |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | article-illustration, creative, image-generation |
参考:完整 SKILL.md
以下是该 skill 被触发时,Kopi Agent 加载的完整 skill 定义。skill 激活时,agent 看到的指令就是这些内容。
文章配图师
改编自 baoyu-article-illustrator,以适配 KOPI AI AGENT 的工具生态。
分析文章、识别插图位置,并生成保持类型 × 风格 × 配色一致的图片。
何时使用
当用户要求为文章配图、为文章添加图片、为内容生成插图,或使用"为文章配图"、"illustrate article"、"add images"等说法时,触发此 skill。用户需提供一篇文章(文件路径或粘贴的内容),并可选择指定类型、风格、配色或密度。
三个维度
| 维度 | 控制内容 | 示例 |
|---|---|---|
| Type | 信息结构 | infographic、scene、flowchart、comparison、framework、timeline |
| Style | 渲染方式 | notion、warm、minimal、blueprint、watercolor、elegant |
| Palette | 配色方案(可选) | macaron、warm、neon — 覆盖风格的默认配色 |
自由组合:type=infographic, style=vector-illustration, palette=macaron。
或使用预设:edu-visual → 一次性指定 type + style + palette。参见 style-presets.md。
Types
| Type | 最适用场景 |
|---|---|
infographic | 数据、指标、技术 |
scene | 叙事、情感 |
flowchart | 流程、工作流 |
comparison | 并列对比、方案选择 |
framework | 模型、架构 |
timeline | 历史、演变 |
Styles
有关核心风格、完整图库以及 Type × Style 兼容性,请参见 references/styles.md。
输出结构
{output-dir}/
├── source-{slug}.{ext} # Only for pasted content
├── outline.md
├── prompts/
│ └── NN-{type}-{slug}.md
└── NN-{type}-{slug}.png
默认输出目录:
| 输入 | 输出目录 | Markdown 插入路径 |
|---|---|---|
| 文章文件路径 | {article-dir}/imgs/ | imgs/NN-{type}-{slug}.png |
| 粘贴的内容 | illustrations/{topic-slug}/(cwd) | illustrations/{topic-slug}/NN-{type}-{slug}.png |
如果用户要求不同的布局(例如图片与文章并列,或放入 illustrations/ 子目录),请按用户要求执行。
Slug:2-4 个单词,kebab-case 格式。冲突时:追加 -YYYYMMDD-HHMMSS。
核心原则
- 将概念可视化,而非隐喻 — 如果文章使用了隐喻(例如"电锯切西瓜"),请呈现其背后的含义,而非字面画面。
- 标签使用文章中的数据 — 采用文章中真实的数字、术语和引文,而不是通用占位符。
- Prompt 文件是可复现性记录 — 在生成任何图片之前,每张插图都必须先在
prompts/下保存对应的 prompt 文件。 - 清除敏感信息 — 在将任何内容写入磁盘之前,先扫描源内容中的 API keys、tokens 或凭据。
工作流程
- [ ] Step 1: Detect reference images (if provided)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (clarify tool, one question at a time)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate prompts
- [ ] Step 6: Generate images (image_generate)
- [ ] Step 7: Finalize
步骤 1:检测参考图片
如果用户提供了参考图片(内联粘贴的路径、附件或 URL):
- 针对每个参考,调用
vision_analyze,传入路径/URL 并提出询问风格、色调、构图与主体的问题。通过write_file将返回的描述记录到{output-dir}/references/NN-ref-{slug}.md中。 - 不要尝试通过
write_file/read_file复制二进制文件 —— 它们只处理文本。如需留存本地副本,请使用terminal(cp "$src" "{output-dir}/references/NN-ref-{slug}.{ext}")。skill 本身从不需要读取二进制文件;它基于视觉描述来工作。 - 由于
image_generate不接受图片输入,视觉描述就是步骤 5 中嵌入 prompt 的内容。
完整流程:references/workflow.md。
步骤 2:分析
| 分析项 | 输出 |
|---|---|
| 内容类型 | 技术 / 教程 / 方法论 / 叙事 |
| 目的 | 信息传递 / 可视化 / 想象激发 |
| 核心论点 | 2-5 个要点 |
| 位置 | 在哪些位置添加插图能提升价值 |
读取源内容(文件路径 → read_file,或粘贴的文本),并使用 write_file 将分析写入 {output-dir}/analysis.md。
完整流程:references/workflow.md。
步骤 3:确认设置
使用 clarify 工具。由于 clarify 一次只能提出一个问题,请优先询问最重要的问题。如果用户的请求中已包含某个问题的答案,则跳过该问题。
| 顺序 | 问题 | 选项 |
|---|---|---|
| Q1 | 预设或类型 | [推荐预设]、[备选预设],或手动指定:infographic、scene、flowchart、comparison、framework、timeline、mixed |
| Q2 | 密度 | minimal(1-2)、balanced(3-5)、per-section(推荐)、rich(6+) |
| Q3 | 风格 (若 Q1 已选预设则跳过) | [推荐]、minimal-flat、sci-fi、hand-drawn、editorial、scene、poster |
| Q4 | 色调 (可选) | Default(按风格配色)、macaron、warm、neon |
| Q5 | 语言 (仅当文章语言不明确时) | 文章语言 / 用户语言 |
连续提问不要超过 2-3 个 clarify 问题。如果用户在请求中已明确指定这些信息,请完全跳过。
完整流程:references/workflow.md。
步骤 4:生成大纲 → outline.md
使用 write_file 将 {output-dir}/outline.md 保存为带 frontmatter(type、density、style、palette、image_count)的文件,并为每张插图添加一个条目:
## Illustration 1
**Position**: [section/paragraph]
**Purpose**: [why]
**Visual Content**: [what to show]
**Filename**: 01-infographic-concept-name.png
完整模板:references/workflow.md。
步骤 5:生成 Prompt
阻断规则:每张插图在生成任何图片之前,都必须已保存对应的 prompt 文件 —— prompt 文件是可复现性的记录。
针对每张插图:
- 按照 references/prompt-construction.md 创建 prompt 文件。
- 使用
write_file将其保存到{output-dir}/prompts/NN-{type}-{slug}.md,并带 YAML frontmatter。 - Prompt 必须采用针对类型的模板,包含结构化分区(ZONES / LABELS / COLORS / STYLE / ASPECT)。
- LABELS 必须包含与文章相关的数据:真实数字、术语、指标、引文。
- 根据 prompt frontmatter 处理参考(
direct/style/palette)—— 对于direct用法,需在 prompt 中嵌入参考的文本描述(因为image_generate不接受参考图片输入)。
步骤 6:生成图片
针对每个 prompt 文件:
- 调用
image_generate(prompt=..., aspect_ratio=...)。image_generate返回一个包含图片 URL 的 JSON 结果;它不会写入磁盘,也不接受输出路径。 - 将 prompt 中的
ASPECT映射到image_generate的枚举值:16:9→landscape、9:16→portrait、1:1→square。自定义比例 → 映射到最接近的预设比例。 - 通过
terminal(例如curl -sSL -o "{output-dir}/NN-{type}-{slug}.png" "{url}")将返回的 URL 下载到{output-dir}/NN-{type}-{slug}.png。 - 生成失败时,自动重试一次。
注意:底层的图片生成后端由用户配置(默认:FAL FLUX 2 Klein 9B),且不能通过 image_generate 由 agent 选择。不要在 prompt 中写入模型名称并期望它据此路由。
步骤 7:收尾
在相应段落之后插入 。Alt 文本:用文章语言撰写简明描述。
汇报:
Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style] | Palette: [palette or default]
Images: X/N generated
修改
| 操作 | 步骤 |
|---|---|
| 编辑 | 更新 prompt → 重新生成 → 更新参考 |
| 添加 | 定位 → 编写 prompt → 生成 → 更新大纲 → 插入 |
| 删除 | 删除文件 → 移除参考 → 更新大纲 |
参考文件
| 文件 | 内容 |
|---|---|
| references/workflow.md | 详细流程 |
| references/usage.md | 调用示例 |
| references/styles.md | 风格库 + 调色板库 |
| references/style-presets.md | 预设快捷方式(类型 + 风格 + 调色板) |
| references/prompt-construction.md | Prompt 模板 |
注意事项
- 数据完整性至关重要 —— 绝不总结、转述或改动源统计数据。"73% 增长"就必须保持为"73% 增长"。
- 去除敏感信息 —— 在将源内容写入任何输出文件之前,先扫描其中的 API 密钥、token 或凭据。
- 不要将隐喻字面化作图 —— 要可视化其背后的抽象概念。
- Prompt 文件是必需的 —— 没有保存的 prompt 文件就不生成图片。该文件是日后重新生成或切换后端的依据。
image_generate宽高比 —— 工具支持landscape、portrait和square。自定义比例映射到最接近的选项。image_generate返回 URL 而非本地文件 —— 在文章中插入本地图片路径之前,务必先通过terminal(curl)下载。- agent 不能选择后端 ——
image_generate使用用户配置的模型(默认:FAL FLUX 2 Klein 9B)。不要在 prompt 中写入"use <model> to generate this"并期望它据此路由。