跳到主要内容

Baoyu 文章配图师

文章配图:类型 × 风格 × 配色保持一致。

Skill 元数据​

SourceOptional — 使用 kopi skills install official/creative/baoyu-article-illustrator 安装
Pathoptional-skills/creative/baoyu-article-illustrator
Version1.57.0
Author宝玉 (JimLiu)
LicenseMIT
Platformslinux, macos, windows
Tagsarticle-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):

  1. 针对每个参考,调用 vision_analyze,传入路径/URL 并提出询问风格、色调、构图与主体的问题。通过 write_file 将返回的描述记录到 {output-dir}/references/NN-ref-{slug}.md 中。
  2. 不要尝试通过 write_file / read_file 复制二进制文件 —— 它们只处理文本。如需留存本地副本,请使用 terminal(cp "$src" "{output-dir}/references/NN-ref-{slug}.{ext}")。skill 本身从不需要读取二进制文件;它基于视觉描述来工作。
  3. 由于 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 文件是可复现性的记录。

针对每张插图:

  1. 按照 references/prompt-construction.md 创建 prompt 文件。
  2. 使用 write_file 将其保存到 {output-dir}/prompts/NN-{type}-{slug}.md,并带 YAML frontmatter。
  3. Prompt 必须采用针对类型的模板,包含结构化分区(ZONES / LABELS / COLORS / STYLE / ASPECT)。
  4. LABELS 必须包含与文章相关的数据:真实数字、术语、指标、引文。
  5. 根据 prompt frontmatter 处理参考(direct/style/palette)—— 对于 direct 用法,需在 prompt 中嵌入参考的文本描述(因为 image_generate 不接受参考图片输入)。

步骤 6:生成图片​

针对每个 prompt 文件:

  1. 调用 image_generate(prompt=..., aspect_ratio=...)。image_generate 返回一个包含图片 URL 的 JSON 结果;它不会写入磁盘,也不接受输出路径。
  2. 将 prompt 中的 ASPECT 映射到 image_generate 的枚举值:16:9 → landscape、9:16 → portrait、1:1 → square。自定义比例 → 映射到最接近的预设比例。
  3. 通过 terminal(例如 curl -sSL -o "{output-dir}/NN-{type}-{slug}.png" "{url}")将返回的 URL 下载到 {output-dir}/NN-{type}-{slug}.png。
  4. 生成失败时,自动重试一次。

注意:底层的图片生成后端由用户配置(默认:FAL FLUX 2 Klein 9B),且不能通过 image_generate 由 agent 选择。不要在 prompt 中写入模型名称并期望它据此路由。

步骤 7:收尾​

在相应段落之后插入 ![description](https://github.com/LINYIQ66/kopi-ai-agent/blob/main/optional-skills/creative/baoyu-article-illustrator/{relative-path}/NN-{type}-{slug}.png)。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.mdPrompt 模板

注意事项​

  1. 数据完整性至关重要 —— 绝不总结、转述或改动源统计数据。"73% 增长"就必须保持为"73% 增长"。
  2. 去除敏感信息 —— 在将源内容写入任何输出文件之前,先扫描其中的 API 密钥、token 或凭据。
  3. 不要将隐喻字面化作图 —— 要可视化其背后的抽象概念。
  4. Prompt 文件是必需的 —— 没有保存的 prompt 文件就不生成图片。该文件是日后重新生成或切换后端的依据。
  5. image_generate 宽高比 —— 工具支持 landscape、portrait 和 square。自定义比例映射到最接近的选项。
  6. image_generate 返回 URL 而非本地文件 —— 在文章中插入本地图片路径之前,务必先通过 terminal(curl)下载。
  7. agent 不能选择后端 —— image_generate 使用用户配置的模型(默认:FAL FLUX 2 Klein 9B)。不要在 prompt 中写入 "use <model> to generate this" 并期望它据此路由。