Article Illustrator

Analyze articles, identify illustration positions, generate images with Type × Style consistency.

Two Dimensions

Dimension	Controls	Examples
Type	Information structure	infographic, scene, flowchart, comparison, framework, timeline
Style

Visual aesthetics | notion, warm, minimal, blueprint, watercolor, elegant |

Combine freely: INLINECODE0

Or use presets: --preset tech-explainer → type + style in one flag. See Style Presets.

Types

Type	Best For
INLINECODE2	Data, metrics, technical
INLINECODE3

Styles

See references/styles.md for Core Styles, full gallery, and Type × Style compatibility.

Workflow

CODEBLOCK0

Step 1: Pre-check

1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING

CODEBLOCK1

CODEBLOCK2

Result	Action
Found	Read, parse, display summary
Not found

⛔ Run first-time-setup |

Full procedures: references/workflow.md

Step 2: Analyze

Analysis	Output
Content type	Technical / Tutorial / Methodology / Narrative
Purpose

CRITICAL: Metaphors → visualize underlying concept, NOT literal image.

Full procedures: references/workflow.md

Step 3: Confirm Settings ⚠️

ONE AskUserQuestion, max 4 Qs. Q1-Q2 REQUIRED. Q3 required unless preset chosen.

Q	Options
Q1: Preset or Type	[Recommended preset], [alt preset], or manual: infographic, scene, flowchart, comparison, framework, timeline, mixed
Q2: Density

minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+) |
| Q3: Style | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, poster, Other — skip if preset chosen |
| Q4: Language | When article language ≠ EXTEND.md setting |

Full procedures: references/workflow.md

Step 4: Generate Outline

Save outline.md with frontmatter (type, density, style, image_count) and entries:

CODEBLOCK3

Full template: references/workflow.md

Step 5: Generate Images

⛔ BLOCKING: Prompt files MUST be saved before ANY image generation.

Execution strategy: When multiple illustrations have saved prompt files and the task is now plain generation, prefer baoyu-image-gen batch mode (build-batch.ts → --batchfile) over spawning subagents. Use subagents only when each image still needs separate prompt iteration or creative exploration.

1. For each illustration, create a prompt file per references/prompt-construction.md
Save to prompts/NN-{type}-{slug}.md with YAML frontmatter
Prompts MUST use type-specific templates with structured sections (ZONES / LABELS / COLORS / STYLE / ASPECT)
LABELS MUST include article-specific data: actual numbers, terms, metrics, quotes
DO NOT pass ad-hoc inline prompts to --prompt without saving prompt files first
Select generation skill, process references (direct/style/palette)
Apply watermark if EXTEND.md enabled
Generate from saved prompt files; retry once on failure

Full procedures: references/workflow.md

Step 6: Finalize

Insert ![description](path/NN-{type}-{slug}.png) after paragraphs.

CODEBLOCK4

Output Directory

CODEBLOCK5

Slug: 2-4 words, kebab-case. Conflict: append -YYYYMMDD-HHMMSS.

Modification

Action	Steps
Edit	Update prompt → Regenerate → Update reference
Add

Position → Prompt → Generate → Update outline → Insert | | Delete | Delete files → Remove reference → Update outline |

References

File	Content
references/workflow.md	Detailed procedures
references/usage.md

文章插画师

分析文章，识别插图位置，以类型×风格一致的方式生成图像。

两个维度

维度	控制项	示例
类型	信息结构	信息图、场景、流程图、对比、框架、时间线
风格

视觉美学 | 笔记风、温暖、极简、蓝图、水彩、优雅 |

自由组合：--type infographic --style blueprint

或使用预设：--preset tech-explainer → 一个标志同时指定类型+风格。参见风格预设。

类型

类型	最佳用途
infographic	数据、指标、技术
scene

风格

参见references/styles.md了解核心风格、完整画廊以及类型×风格兼容性。

工作流程

- [ ] 步骤1：预检查（EXTEND.md、参考资料、配置）
[ ] 步骤2：分析内容
[ ] 步骤3：确认设置（AskUserQuestion）
[ ] 步骤4：生成大纲
[ ] 步骤5：生成图像
[ ] 步骤6：定稿

步骤1：预检查

1.5 加载偏好设置（EXTEND.md）⛔ 阻塞项

bash

macOS、Linux、WSL、Git Bash

test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo project
test -f ${XDGCONFIGHOME:-$HOME/.config}/baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo xdg
test -f $HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo user

powershell

PowerShell（Windows）

if (Test-Path .baoyu-skills/baoyu-article-illustrator/EXTEND.md) { project }
$xdg = if ($env:XDGCONFIGHOME) { $env:XDGCONFIGHOME } else { $HOME/.config }
if (Test-Path $xdg/baoyu-skills/baoyu-article-illustrator/EXTEND.md) { xdg }
if (Test-Path $HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md) { user }

结果	操作
找到	读取、解析、显示摘要
未找到

⛔ 运行首次设置 |

完整流程：references/workflow.md

步骤2：分析

分析项	输出
内容类型	技术类 / 教程类 / 方法论 / 叙事类
目的

关键：隐喻 → 可视化底层概念，而非字面图像。

完整流程：references/workflow.md

步骤3：确认设置 ⚠️

一个AskUserQuestion，最多4个问题。Q1-Q2为必填。除非选择了预设，否则Q3必填。

问题	选项
Q1：预设或类型	[推荐预设]、[备选预设]或手动选择：信息图、场景、流程图、对比、框架、时间线、混合
Q2：密度

完整流程：references/workflow.md

步骤4：生成大纲

保存outline.md，包含前置元数据（类型、密度、风格、图像数量）和条目：

yaml

插图1

位置：[章节/段落]
目的：[原因]
视觉内容：[内容]
文件名：01-infographic-concept-name.png

完整模板：references/workflow.md

步骤5：生成图像

⛔ 阻塞项：提示文件必须在任何图像生成之前保存。

执行策略：当多个插图已保存提示文件且任务仅为纯生成时，优先使用baoyu-image-gen批处理模式（build-batch.ts → --batchfile），而非生成子代理。仅当每个图像仍需单独迭代提示或创意探索时，才使用子代理。

1. 为每个插图创建提示文件，遵循references/prompt-construction.md
保存到prompts/NN-{type}-{slug}.md，包含YAML前置元数据
提示必须使用特定类型的模板，包含结构化部分（区域/标签/颜色/风格/比例）
标签必须包含文章特定数据：实际数字、术语、指标、引用
不要在未保存提示文件的情况下，将临时内联提示传递给--prompt
选择生成技能，处理参考资料（direct/style/palette）
如果EXTEND.md启用了水印，则应用水印
从已保存的提示文件生成；失败时重试一次

完整流程：references/workflow.md

步骤6：定稿

在段落之后插入 description 。

文章插图完成！
文章：[路径] | 类型：[类型] | 密度：[级别] | 风格：[风格]
图像：X/N 已生成

输出目录

illustrations/{主题-slug}/
├── source-{slug}.{ext}
├── references/ # 如果提供
├── outline.md
├── prompts/
└── NN-{type}-{slug}.png

Slug：2-4个单词，短横线命名。冲突：追加-YYYYMMDD-HHMMSS。

修改

操作	步骤
编辑	更新提示 → 重新生成 → 更新引用
添加

定位 → 提示 → 生成 → 更新大纲 → 插入 | | 删除 | 删除文件 → 移除引用 → 更新大纲 |

参考资料

文件	内容
references/workflow.md	详细流程
references/usage.md

baoyu-article-illustrator文章配图生成

baoyu-article-illustrator

Article Illustrator

Two Dimensions

Types

Styles