baoyu-article-illustrator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Smart Article Illustration Skill

智能文章插图技能

Analyze article structure and content, identify positions requiring visual aids, and generate illustrations with flexible style options.

分析文章结构与内容，识别需要视觉辅助的位置，并支持灵活的风格选项来生成插图。

Usage

使用方法

bash

undefined

bash

undefined

Auto-select style based on content

根据内容自动选择风格

/baoyu-article-illustrator path/to/article.md

Specify a style

指定风格

/baoyu-article-illustrator path/to/article.md --style warm /baoyu-article-illustrator path/to/article.md --style minimal /baoyu-article-illustrator path/to/article.md --style watercolor

Combine with other options

结合其他选项

/baoyu-article-illustrator path/to/article.md --style playful

undefined

/baoyu-article-illustrator path/to/article.md --style playful

undefined

Options

选项说明

Option	Description
`--style <name>`	Specify illustration style (see Style Gallery below)

选项	描述
`--style <name>`	指定插图风格（见下方风格画廊）

Style Gallery

风格画廊

Style	Description	Best For
`notion` (Default)	Minimalist hand-drawn line art, intellectual	Knowledge sharing, SaaS, productivity
`elegant`	Refined, sophisticated, professional	Business, thought leadership
`warm`	Friendly, approachable, human-centered	Personal growth, lifestyle, education
`minimal`	Ultra-clean, zen-like, focused	Philosophy, minimalism, core concepts
`playful`	Fun, creative, whimsical	Tutorials, beginner guides, fun topics
`nature`	Organic, calm, earthy	Sustainability, wellness, outdoor
`sketch`	Raw, authentic, notebook-style	Ideas, brainstorming, drafts
`watercolor`	Soft artistic with natural warmth	Lifestyle, travel, creative
`vintage`	Nostalgic aged-paper aesthetic	Historical, biography, heritage
`scientific`	Academic precise diagrams	Biology, chemistry, technical
`chalkboard`	Classroom chalk drawing style	Education, tutorials, workshops
`editorial`	Magazine-style infographic	Tech explainers, journalism
`flat`	Modern flat vector illustration	Startups, digital, contemporary
`flat-doodle`	Bold outlines, pastel colors, cute	Productivity, SaaS, workflows
`retro`	80s/90s vibrant nostalgic	Pop culture, gaming, entertainment
`blueprint`	Technical schematics, engineering precision	Architecture, system design
`vector-illustration`	Flat vector with black outlines, retro colors	Educational, creative, brand content
`sketch-notes`	Soft hand-drawn, warm educational feel	Knowledge sharing, tutorials
`pixel-art`	Retro 8-bit gaming aesthetic	Gaming, tech, developer content
`intuition-machine`	Technical briefing with bilingual labels	Academic, technical, bilingual
`fantasy-animation`	Ghibli/Disney whimsical style	Storytelling, children's, creative

Full style specifications in

references/styles/<style>.md

风格	描述	适用场景
`notion` （默认）	极简手绘线条风格，知性严谨	知识分享、SaaS、生产力工具
`elegant`	精致、成熟、专业风格	商务场景、思想领导力内容
`warm`	友好、亲切、以人为本风格	个人成长、生活方式、教育内容
`minimal`	超简洁、禅意、聚焦核心风格	哲学、极简主义、核心概念讲解
`playful`	趣味、创意、奇思妙想风格	教程、入门指南、趣味主题内容
`nature`	有机、平和、自然质朴风格	可持续发展、健康养生、户外内容
`sketch`	原始、真实、笔记本手绘风格	创意想法、头脑风暴、草稿内容
`watercolor`	柔和艺术感，自带自然暖意风格	生活方式、旅行、创意内容
`vintage`	怀旧复古纸张质感风格	历史、传记、文化遗产内容
`scientific`	学术精准图表风格	生物学、化学、技术类内容
`chalkboard`	课堂粉笔手绘风格	教育、教程、工作坊内容
`editorial`	杂志风格信息图	技术讲解、新闻报道内容
`flat`	现代扁平化矢量插图风格	初创企业、数字化、当代主题内容
`flat-doodle`	粗线条、马卡龙色、可爱风格	生产力工具、SaaS、工作流内容
`retro`	80/90年代活力怀旧风格	流行文化、游戏、娱乐内容
`blueprint`	技术原理图，工程级精准风格	建筑、系统设计内容
`vector-illustration`	扁平化矢量，黑色轮廓+复古色调	教育、创意、品牌内容
`sketch-notes`	柔和手绘，温暖教育感风格	知识分享、教程内容
`pixel-art`	复古8位游戏美学风格	游戏、技术、开发者内容
`intuition-machine`	技术简报，双语标签风格	学术、技术、双语内容
`fantasy-animation`	吉卜力/迪士尼奇幻风格	故事讲述、儿童内容、创意内容

完整风格规范请查看

references/styles/<style>.md

Auto Style Selection

自动风格选择

When no

--style

is specified, analyze content to select the best style:

Content Signals	Selected Style
Personal story, emotion, growth, life, feeling, relationship	`warm`
Simple, zen, focus, essential, core, minimalist	`minimal`
Fun, easy, beginner, tutorial, guide, how-to, learn	`playful`
Nature, eco, wellness, health, organic, green, outdoor	`nature`
Idea, thought, concept, draft, brainstorm, sketch	`sketch`
Business, professional, strategy, analysis, corporate	`elegant`
Knowledge, concept, productivity, SaaS, notion, tool	`notion`
Lifestyle, travel, food, art, creative, artistic	`watercolor`
History, heritage, vintage, biography, classic, expedition	`vintage`
Biology, chemistry, medical, scientific, research, academic	`scientific`
Education, classroom, teaching, school, lecture, workshop	`chalkboard`
Explainer, journalism, magazine, in-depth, investigation	`editorial`
Modern, startup, app, product, digital marketing, saas	`flat`
Productivity, workflow, cute, tools, app tutorial	`flat-doodle`
80s, 90s, retro, pop culture, music, nostalgia	`retro`
Architecture, system, infrastructure, engineering, technical	`blueprint`
Brand, explainer, children, cute, toy, geometric	`vector-illustration`
Notes, doodle, friendly, warm tutorial, onboarding	`sketch-notes`
Gaming, 8-bit, pixel, developer, retro tech	`pixel-art`
Bilingual, briefing, academic, research, documentation	`intuition-machine`
Fantasy, story, magical, Ghibli, Disney, children	`fantasy-animation`
Default	`notion`

未指定

--style

参数时，系统会分析内容自动选择最合适的风格：

内容特征	匹配风格
个人故事、情感、成长、生活、感受、关系	`warm`
简洁、禅意、聚焦、本质、核心、极简	`minimal`
趣味、轻松、入门、教程、指南、操作方法、学习	`playful`
自然、生态、健康、有机、绿色、户外	`nature`
想法、思考、概念、草稿、头脑风暴、草图	`sketch`
商务、专业、战略、分析、企业	`elegant`
知识、概念、生产力、SaaS、notion、工具	`notion`
生活方式、旅行、美食、艺术、创意、艺术性	`watercolor`
历史、遗产、复古、传记、经典、探险	`vintage`
生物学、化学、医学、科学、研究、学术	`scientific`
教育、课堂、教学、学校、讲座、工作坊	`chalkboard`
讲解、新闻、杂志、深度报道、调查	`editorial`
现代、初创、应用、产品、数字营销、SaaS	`flat`
生产力、工作流、可爱、工具、应用教程	`flat-doodle`
80年代、90年代、复古、流行文化、音乐、怀旧	`retro`
建筑、系统、基础设施、工程、技术	`blueprint`
品牌、讲解、儿童、可爱、玩具、几何	`vector-illustration`
笔记、涂鸦、友好、温暖教程、新手指引	`sketch-notes`
游戏、8位、像素、开发者、复古技术	`pixel-art`
双语、简报、学术、研究、文档	`intuition-machine`
奇幻、故事、魔法、吉卜力、迪士尼、儿童	`fantasy-animation`
默认	`notion`

File Management

文件管理

Output Directory

输出目录

Each session creates an independent directory named by content slug:

illustrations/{topic-slug}/
├── source-{slug}.{ext}    # Source files (text, images, etc.)
├── outline.md
├── outline-{style}.md     # Style variant outlines
├── prompts/
│   ├── illustration-concept-a.md
│   ├── illustration-concept-b.md
│   └── ...
├── illustration-concept-a.png
├── illustration-concept-b.png
└── ...

Slug Generation:

Extract main topic from content (2-4 words, kebab-case)
Example: "The Future of AI" →
```
future-of-ai
```

每次会话会创建一个独立目录，目录名由内容slug生成：

illustrations/{topic-slug}/
├── source-{slug}.{ext}    # 源文件（文本、图片等）
├── outline.md
├── outline-{style}.md     # 风格变体大纲
├── prompts/
│   ├── illustration-concept-a.md
│   ├── illustration-concept-b.md
│   └── ...
├── illustration-concept-a.png
├── illustration-concept-b.png
└── ...

Slug生成规则:

从内容中提取主题（2-4个单词，短横线连接格式）
示例："The Future of AI" →
```
future-of-ai
```

Conflict Resolution

冲突解决

illustrations/{topic-slug}/

already exists:

Append timestamp:
```
{topic-slug}-YYYYMMDD-HHMMSS
```
Example:
```
ai-future
```
exists →
```
ai-future-20260118-143052
```

若

illustrations/{topic-slug}/

目录已存在：

追加时间戳：
```
{topic-slug}-YYYYMMDD-HHMMSS
```
示例：
```
ai-future
```
已存在 →
```
ai-future-20260118-143052
```

Source Files

源文件

Copy all sources with naming

source-{slug}.{ext}

```
source-article.md
```
(main text content)
```
source-photo.jpg
```
(image from conversation)
```
source-reference.pdf
```
(additional file)

Multiple sources supported: text, images, files from conversation.

所有源文件会被复制并重命名为

source-{slug}.{ext}

格式：

```
source-article.md
```
（主文本内容）
```
source-photo.jpg
```
（对话中的图片）
```
source-reference.pdf
```
（附加文件）

支持多源文件：文本、图片、对话中的任意文件。

Workflow

工作流程

Step 1: Analyze Content & Select Style

步骤1：分析内容 & 选择风格

Read article content
If
```
--style
```
specified, use that style
Otherwise, scan for style signals and auto-select
Language detection:
- Detect source language from article content
- Detect user language from conversation context
- Note if source_language ≠ user_language (will ask in Step 4)
Extract key information:
- Main topic and themes
- Core messages per section
- Abstract concepts needing visualization

读取文章内容
若指定
```
--style
```
参数，直接使用该风格
否则，扫描内容特征自动选择风格
语言检测:
- 从文章内容中检测源语言
- 从对话上下文检测用户语言
- 记录源语言与用户语言是否不同（步骤4中会询问）
提取关键信息:
- 主题与核心思想
- 各章节核心信息
- 需要可视化的抽象概念

Step 2: Identify Illustration Positions

步骤2：确定插图位置

Three Purposes of Illustrations:

Information Supplement: Help understand abstract concepts
Concept Visualization: Transform abstract ideas into concrete visuals
Imagination Guidance: Create atmosphere, enhance reading experience

Content Suitable for Illustrations:

Abstract concepts needing visualization
Processes/steps needing diagrams
Comparisons needing visual representation
Core arguments needing reinforcement
Scenarios needing imagination guidance

Illustration Count:

Consider at least 1 image per major section
Prioritize core arguments and abstract concepts
Principle: More is better than fewer

插图的三大作用:

信息补充：帮助理解抽象概念
概念可视化：将抽象想法转化为具象视觉
引导想象：营造氛围，提升阅读体验

适合添加插图的内容:

需要可视化的抽象概念
需要示意图的流程/步骤
需要直观对比的内容
需要强化的核心论点
需要引导想象的场景

插图数量:

每个主要章节至少1张插图
优先覆盖核心论点与抽象概念
原则：宁多勿少

Step 3: Generate Illustration Plan

步骤3：生成插图方案

markdown

undefined

markdown

undefined

Illustration Plan

插图方案

Article: [article path] Style: [selected style] Illustration Count: N images

文章: [文章路径] 风格: [选中的风格] 插图数量: N张

Illustration 1

插图1

Insert Position: [section name] / [paragraph description] Purpose: [why illustration needed here] Visual Content: [what the image should show] Filename: illustration-[slug].png

插入位置: [章节名称] / [段落描述] 目的: 此处需要插图的原因 视觉内容: 图片应呈现的内容 文件名: illustration-[slug].png

Illustration 2

插图2

...

undefined

...

undefined

Step 4: Review & Confirm

步骤4：审核与确认

Purpose: Let user confirm all options in a single step before image generation.

IMPORTANT: Present ALL options in a single confirmation step using AskUserQuestion. Do NOT interrupt workflow with multiple separate confirmations.

Generate 3 style variants:
- Analyze content to select 3 most suitable styles
- Generate complete illustration plan for each style variant
- Save as
```
outline-{style}.md
```
  (e.g.,
```
outline-notion.md
```
  ,
```
outline-tech.md
```
  ,
```
outline-warm.md
```
  )
Determine which questions to ask:
Question When to Ask
Style variant Always (required)
Language Only if
source_language ≠ user_language
Present options (use AskUserQuestion with all applicable questions):

Question 1 (Style) - always:
- Style A (recommended): [style name] - [brief description]
- Style B: [style name] - [brief description]
- Style C: [style name] - [brief description]
- Custom: Provide custom style reference
Question 2 (Language) - only if source ≠ user language:
- [Source language] (matches article language)
- [User language] (your preference)
Language handling:
- If source language = user language: Just inform user (e.g., "Prompts will be in Chinese")
- If different: Ask which language to use for prompts
Apply selection:
- Copy selected
```
outline-{style}.md
```
  to
```
outline.md
```
- If custom style provided, generate new plan with that style
- If different language selected, regenerate outline in that language
- User may edit
```
outline.md
```
  directly for fine-tuning
- If modified, reload plan before proceeding
Proceed only after explicit user confirmation

Question	When to Ask
Style variant	Always (required)
Language	Only if `source_language ≠ user_language`

目的: 在生成图片前，让用户一次性确认所有选项。

重要提示: 使用AskUserQuestion在一个步骤中展示所有选项，不要分多次打断工作流进行确认。

生成3种风格变体:
- 分析内容选择3种最匹配的风格
- 为每种风格变体生成完整插图方案
- 保存为
```
outline-{style}.md
```
  （例如：
```
outline-notion.md
```
  ,
```
outline-tech.md
```
  ,
```
outline-warm.md
```
  ）
确定需要询问的问题:
问题触发条件
风格变体选择始终需要（必填）
语言选择仅当
源语言≠用户语言
时
展示选项（使用AskUserQuestion展示所有适用问题）:

问题1（风格） - 必选:
- 风格A（推荐）: [风格名称] - [简要描述]
- 风格B: [风格名称] - [简要描述]
- 风格C: [风格名称] - [简要描述]
- 自定义: 提供自定义风格参考
问题2（语言） - 仅当源语言≠用户语言时:
- [源语言]（与文章语言一致）
- [用户语言]（用户偏好语言）
语言处理规则:
- 若源语言=用户语言：直接告知用户（例如：“提示词将使用中文”）
- 若不同：询问用户使用哪种语言生成提示词
应用用户选择:
- 将选中的
```
outline-{style}.md
```
  复制为
```
outline.md
```
- 若提供自定义风格，生成对应的新方案
- 若选择不同语言，重新生成对应语言的方案大纲
- 用户可直接编辑
```
outline.md
```
  进行微调
- 若有修改，重新加载方案后再继续

问题	触发条件
风格变体选择	始终需要（必填）
语言选择	仅当 `源语言≠用户语言` 时

Step 5: Create Prompt Files

步骤5：创建提示词文件

Save prompts to

prompts/

directory with style-specific details.

All prompts are written in the user's confirmed language preference.

Prompt Format:

markdown

Illustration theme: [concept in 2-3 words]
Style: [style name]

Visual composition:
- Main visual: [description matching style]
- Layout: [element positioning]
- Decorative elements: [style-appropriate decorations]

Color scheme:
- Primary: [style primary color]
- Background: [style background color]
- Accent: [style accent color]

Text content (if any):
- [Any labels or captions in content language]

Style notes: [specific style characteristics]

将提示词保存至

prompts/

目录，包含风格专属细节。

所有提示词均使用用户确认的偏好语言编写。

提示词格式:

markdown

插图主题: [2-3个单词的概念]
风格: [风格名称]

视觉构图:
- 主视觉: 符合风格的内容描述
- 布局: 元素位置安排
- 装饰元素: 符合风格的装饰细节

配色方案:
- 主色调: [风格主色]
- 背景色: [风格背景色]
- 强调色: [风格强调色]

文字内容（如有）:
- [内容语言的标签或说明文字]

风格注意事项: [特定风格的特征]

Step 6: Generate Images

步骤6：生成图片

Image Generation Skill Selection:

Check available image generation skills
If multiple skills available, ask user to choose

Generation Flow:

Call selected image generation skill with prompt file and output path
Generate images sequentially
After each image, output progress: "Generated X/N"
On failure, auto-retry once
If retry fails, log reason, continue to next

图像生成技能选择:

检查可用的图像生成技能
若存在多个技能，询问用户选择哪一个

生成流程:

调用选中的图像生成技能，传入提示词文件与输出路径
按顺序生成图片
每生成一张图片，输出进度：“已生成 X/N”
生成失败时自动重试1次
若重试失败，记录原因，继续生成下一张

Step 7: Update Article

步骤7：更新文章

Insert generated images at corresponding positions:

markdown

![illustration description]([article-name]/illustrations/illustration-[slug].png)

Insertion Rules:

Insert image after corresponding paragraph
Leave one blank line before and after image
Alt text uses concise description in article's language

在对应位置插入生成的图片：

markdown

![插图描述]([article-name]/illustrations/illustration-[slug].png)

插入规则:

在对应段落之后插入图片
图片前后各留一行空白
替代文本使用文章语言的简洁描述

Step 8: Output Summary

步骤8：输出总结

Article Illustration Complete!

Article: [article path]
Style: [style name]
Generated: X/N images successful

Illustration Positions:
- illustration-xxx.png → After section "Section Name"
- illustration-yyy.png → After section "Another Section"
...

[If any failures]
Failed:
- illustration-zzz.png: [failure reason]

文章插图完成！

文章: [文章路径]
风格: [风格名称]
生成结果: X/N张图片成功生成

插图位置:
- illustration-xxx.png → 插入至“章节名称”之后
- illustration-yyy.png → 插入至“另一章节”之后
...

[若有生成失败]
失败项:
- illustration-zzz.png: [失败原因]

Illustration Modification

插图修改

Support for modifying individual illustrations after initial generation.

支持在初始生成后修改单个插图。

Edit Single Illustration

编辑单张插图

Regenerate a specific illustration with modified prompt:

Identify illustration to edit (e.g.,
```
illustration-concept-overview.png
```
)

Update prompt in

prompts/illustration-concept-overview.md

if needed

If content changes significantly, update slug in filename
Regenerate image
Update article if image reference changed

修改提示词后重新生成指定插图：

确定需要编辑的插图（例如：
```
illustration-concept-overview.png
```
）

若需要，更新

prompts/illustration-concept-overview.md

中的提示词

若内容变化较大，更新文件名中的slug
重新生成图片
若图片引用路径变化，同步更新文章

Add New Illustration

添加新插图

Add a new illustration to the article:

Identify insertion position in article
Create new prompt with appropriate slug (e.g.,
```
illustration-new-concept.md
```
)
Generate new illustration image
Update
```
outline.md
```
with new illustration entry
Insert image reference in article at the specified position

为文章新增一张插图：

确定文章中的插入位置
创建新提示词文件，使用合适的slug（例如：
```
illustration-new-concept.md
```
）
生成新插图
在
```
outline.md
```
中添加新插图条目
在文章指定位置插入图片引用

Delete Illustration

删除插图

Remove an illustration from the article:

Identify illustration to delete (e.g.,
```
illustration-concept-overview.png
```
)
Remove image file and prompt file
Remove image reference from article
Update
```
outline.md
```
to remove illustration entry

从文章中移除一张插图：

确定需要删除的插图（例如：
```
illustration-concept-overview.png
```
）
删除图片文件与提示词文件
从文章中移除图片引用
在
```
outline.md
```
中删除对应插图条目

File Naming Convention

文件命名规范

Files use meaningful slugs for better readability:

illustration-[slug].png
illustration-[slug].md (in prompts/)

Examples:

```
illustration-concept-overview.png
```
```
illustration-workflow-diagram.png
```
```
illustration-key-benefits.png
```

Slug rules:

Derived from illustration purpose/content (kebab-case)
Must be unique within the article
When content changes significantly, update slug accordingly

文件使用有意义的slug提升可读性：

illustration-[slug].png
illustration-[slug].md (位于prompts/目录下)

示例:

```
illustration-concept-overview.png
```
```
illustration-workflow-diagram.png
```
```
illustration-key-benefits.png
```

Slug规则:

从插图目的/内容衍生（短横线连接格式）
在单篇文章中必须唯一
内容变化较大时，同步更新slug

References

参考资料

File	Content
`references/styles/<style>.md`	Full style specifications with colors, elements, rules

文件	内容
`references/styles/<style>.md`	完整风格规范，包含配色、元素、规则

Notes

注意事项

Illustrations serve the content: supplement information, visualize concepts
Maintain selected style consistency across all illustrations in one article
Image generation typically takes 10-30 seconds per image
Sensitive figures should use cartoon alternatives
Prompts written in user's confirmed language preference
Illustration text (labels, captions) should match article language

插图为内容服务：补充信息、可视化概念
单篇文章的所有插图需保持风格一致
每张图片生成通常需要10-30秒
敏感人物需使用卡通替代
提示词使用用户确认的偏好语言
插图文字（标签、说明）需与文章语言一致

Extension Support

扩展支持

Custom styles and configurations via EXTEND.md.

Check paths (priority order):

.baoyu-skills/baoyu-article-illustrator/EXTEND.md

(project)

~/.baoyu-skills/baoyu-article-illustrator/EXTEND.md

(user)

If found, load before Step 1. Extension content overrides defaults.

通过EXTEND.md实现自定义风格与配置。

路径优先级:

.baoyu-skills/baoyu-article-illustrator/EXTEND.md

（项目级）

~/.baoyu-skills/baoyu-article-illustrator/EXTEND.md

（用户级）

若找到扩展文件，将在步骤1前加载。扩展内容会覆盖默认配置。