baoyu-article-illustrator（宝玉文章插画）

Article Illustrator

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

Two Dimensions

Combine freely: --type infographic --style blueprint

Types

Styles

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

Workflow

- [ ] Step 1: Pre-check (source, output dir, references)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (AskUserQuestion)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate images
- [ ] Step 6: Finalize

Step 1: Pre-check

1. Confirm source article path or pasted content.
2. Create output directory under Assets/Article-Illustrations/{topic-slug}/.
3. Ensure prompts/ subdirectory exists before generation.
4. Load style/type references from references/.

Full procedures: references/workflow.md

Step 2: Analyze

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

Full procedures: references/workflow.md

Step 3: Confirm Settings ⚠️

ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.

Full procedures: references/workflow.md

Step 4: Generate Outline

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

## Illustration 1
**Position**: [section/paragraph]
**Purpose**: [why]
**Visual Content**: [what]
**Filename**: 01-infographic-concept-name.png

Full template: references/workflow.md

Step 5: Generate Images

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

1. For each illustration, create a prompt file per references/prompt-construction.md
2. Save to prompts/NN-{type}-{slug}.md with YAML frontmatter
3. Prompts MUST use type-specific templates with structured sections (ZONES / LABELS / COLORS / STYLE / ASPECT)
4. LABELS MUST include article-specific data: actual numbers, terms, metrics, quotes
5. DO NOT pass ad-hoc inline prompts to --prompt without saving prompt files first
6. Environment: ALWAYS rely on .agents/skills/.env for model/provider settings
7. For each prompt file, generate with unified command: bun.agents/skills/baoyu-image-gen/scripts/main.ts --promptfiles <output-dir>/prompts/NN-{type}-{slug}.md --image <output-dir>/NN-{type}-{slug}.png --ar 16:9
8. Retry once on failure

Full procedures: references/workflow.md

Step 6: Finalize

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

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated

Output Directory

Assets/Article-Illustrations/{topic-slug}/
├── source-{slug}.{ext}
├── references/           # if provided
├── outline.md
├── prompts/
└── NN-{type}-{slug}.png

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

Modification

References