Baoyu Xhs Images

Image Card Series Generator

Break down complex content into eye-catching image card series with multiple style options.

User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., AskUserQuestion, request_user_input, clarify, ask_user, or any equivalent. 2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question. 3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes.

Image Generation Tools

When this skill needs to render an image, resolve the backend in this order:

1. Current-request override — if the user names a specific backend in the current message, use it. 2. Saved preference — if EXTEND.md sets preferred_image_backend to a backend available right now, use it. 3. Auto-select (when the preference is auto, unset, or the pinned backend isn't available):

• Codex (`imagegen`) — first, inspect your available-skills / tool inventory. If a skill named imagegen is listed, you are running inside Codex and MUST use it: invoke via the Skill tool with skill: "imagegen", passing the saved prompt file's content (plus output path and aspect ratio per Codex imagegen's own args). Codex imagegen is the official raster backend in that runtime and outranks any non-native skill (e.g., baoyu-image-gen) unless the user has explicitly pinned a different preferred_image_backend.
• Codex via `codex exec` (`codex-imagegen`) — if the current runtime exposes no native imagegen skill but the codex CLI is on PATH with an active codex login, route through baoyu-image-gen --provider codex-cli (preferred), or — if baoyu-image-gen is unavailable — invoke the bundled wrapper directly. Details, parameters, and the runtime-discovery procedure live in references/codex-imagegen.md — load that file only when this branch is selected.
• Other runtime-native tools — if the runtime exposes a different native image tool (e.g., Hermes image_generate), use it the same way.
• Otherwise, if exactly one non-native backend is installed (e.g., baoyu-image-gen), use it.
• Otherwise (multiple non-native backends with no runtime-native tool), ask the user once — batch with any other initial questions.

4. If none are available, tell the user and ask how to proceed.

⛔ Never substitute SVG, HTML, canvas, or other code-based rendering for raster image generation. Codex imagegen's own description says it should be used "when the output should be a bitmap asset rather than repo-native code or vector." If you cannot resolve a raster backend via step 3, fall through to step 4 and ask the user — do not silently emit SVG, write inline <svg> markup, or produce HTML/CSS art as a substitute. This applies even if the article/section seems "diagram-like": the consumer skill calling this rule has already decided that a raster image is what it needs.

⛔ Never repair rendered text by painting over a generated bitmap. Do not use ImageMagick, Pillow, Canvas, SVG, HTML/CSS, OCR scripts, or any other programmatic overlay to cover, rewrite, erase, stroke, or replace titles, body copy, tags, or any other text inside an already generated image card. If text is wrong or unclear, regenerate from a corrected prompt, switch to a layout with less on-card text, or ask the user which imperfect candidate to keep.

Setting preferred_image_backend: ask forces the step-3 prompt every run regardless of available backends. Users change the pinned backend via the ## Changing Preferences section below.

Prompt file requirement (hard): write each image's full, final prompt to a standalone file under prompts/ (naming: NN-{type}-[slug].md) BEFORE invoking any backend. The file is the reproducibility record and lets you switch backends without regenerating prompts.

Concrete tool names (imagegen, image_generate, baoyu-image-gen) above are examples — substitute the local equivalents under the same rule.

Batch Generation Policy

After every prompt file for the current generation group has been saved and verified, generate images in batches by default.

Priority order:

1. Use the chosen backend's native batch / multi-task interface if it exists. Each task must keep its own prompt file, output path, aspect ratio, session ID, and direct reference images. 2. If no native batch interface exists but the runtime can issue parallel tool calls, dispatch up to generation_batch_size images at a time. Default: 4. An explicit user request in the current message, such as --batch-size 4 or "并行 4 张一起生成", overrides EXTEND.md. 3. If neither native batch nor parallel tool calls are available, generate sequentially.

Rules:

• Honor the image-1 anchor chain: generate image 1 first, then batch images 2+ using image 1 as the reference.
• Never start a batch until every selected prompt file for that batch exists on disk.
• Retry failed items once without regenerating successful items.
• Do not use subagents merely to parallelize image rendering. Use subagents only for separate prompt iteration or creative exploration.

Confirmation Policy

Default behavior: confirm before generation.

• Treat explicit skill invocation, a file path, matched signals/presets, and EXTEND.md defaults as recommendation inputs only. None of them authorizes skipping confirmation.
• Do not start Step 3 until the user completes Step 2.
• Skip confirmation only when the current request explicitly says to do so, for example: --yes, "直接生成", "不用确认", "跳过确认", "按默认出图", or equivalent wording.
• If confirmation is skipped explicitly, state the assumed strategy / style / layout / palette / count / backend in the next user-facing update before generating.

Language

Respond in the user's language across questions, progress, errors, and completion summary. Keep technical tokens (style names, file paths, code) in English.

Options

Dimensions

Three independent knobs combine freely:

Example: --style notion --layout dense makes an intellectual knowledge card; add --palette macaron to soften the colors without changing notion's rendering rules. A --preset is a shorthand for style + layout (+ optional palette).

Palette behavior: no --palette → style's built-in colors; --palette <name> → overrides colors only, rendering rules unchanged. Some styles declare a default_palette (e.g., sketch-notes defaults to macaron).

Styles (12)

Per-style specifications: references/presets/<style>.md.

Layouts (8)

Layout specs: references/elements/canvas.md.

Palettes (optional override)

Replaces the style's colors while keeping rendering rules (line treatment, textures) intact.

Palette specs: references/palettes/<palette>.md.

Presets (style + layout shortcuts)

Quick-start combos, grouped by scenario. Use --preset <name> or recommend during Step 2.

Knowledge & Learning:

Lifestyle & Sharing:

Impact & Opinion:

Trend & Entertainment:

Poster & Editorial:

Full prompt-fragment definitions: references/style-presets.md.

Auto-Selection

Match content signals to the best combo. First row whose keywords appear wins; fall back to cute-share if nothing matches.

Style × Layout Matrix

Compatibility scores (✓✓ highly recommended, ✓ works well, ✗ avoid). Use when the user picks a non-default combo and you want to flag a poor match.

Outline Strategies

Three differentiated approaches — each produces a structurally different outline. The workflow recommends one; Path C generates all three and lets the user choose.

Reference Images

User-supplied refs are separate from the internal "image-1 as anchor" chain (Step 3) — they layer on top of it.

Intake: via --ref <files...> or paths pasted in conversation.

• File path → copy to refs/NN-ref-{slug}.{ext}
• Pasted with no path → ask for the path, or extract style traits as a text fallback

Usage modes (per reference):

Record refs in each affected card's prompt frontmatter:

references:
  - ref_id: 01
    filename: 01-ref-brand.png
    usage: direct

At generation time: verify files exist. Image 1 with usage: direct + backend that accepts refs → pass via the backend's ref parameter (becomes the chain anchor). Images 2+ keep using image-1 as --ref per Step 3 — do NOT re-stack user refs on top (avoids conflicting signals). For style/palette, embed extracted traits in every prompt.

File Layout

image-cards/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── outline-strategy-{a,b,c}.md    # Path C only
├── outline.md
├── prompts/NN-{type}-{slug}.md
├── NN-{type}-{slug}.png
└── refs/                          # only if --ref used

Slug: 2-4 words, kebab-case. "AI 工具推荐" → ai-tools-recommend. On collision, append -YYYYMMDD-HHMMSS.

Backup rule (applies throughout): before overwriting any file — source, outline, prompt, image — rename the existing one to <name>-backup-YYYYMMDD-HHMMSS.<ext>. This protects user edits.

Workflow

- [ ] Step 0: Load EXTEND.md ⛔ BLOCKING (interactive only)
- [ ] Step 1: Analyze content → analysis.md
- [ ] Step 2: Smart Confirm ⚠️ REQUIRED (Path A / B / C)
- [ ] Step 3: Generate images
- [ ] Step 4: Completion report

Step 0: Load EXTEND.md ⛔ BLOCKING

Check these paths in order; first hit wins:

• Found → read, parse, print a summary (style / layout / watermark / language), continue.
• Not found + interactive → run first-time setup (see references/config/first-time-setup.md) and save before anything else. Do NOT analyze content or ask style questions until preferences exist — this keeps first-run behavior predictable.
• Not found + `--yes` → skip setup, use built-in defaults (no watermark, style/layout auto-selected, language from content). Do not prompt, do not create EXTEND.md.

EXTEND.md keys: watermark, preferred style/layout, custom style definitions, language preference, preferred image backend, generation batch size. Schema: references/config/preferences-schema.md.

Step 1: Analyze Content → analysis.md

1. Save the source (backup rule applies if source.md exists). 2. Run the deep analysis in references/workflows/analysis-framework.md: content type, hook potential, audience, engagement signals, visual opportunity map, swipe flow. 3. Detect source language, pick recommended image count (2-10). 4. Auto-recommend strategy + style + layout + palette using the Auto-Selection table above. 5. Write everything to analysis.md.

Step 2: Smart Confirm ⚠️ REQUIRED

Hard gate: this step is mandatory per the Confirmation Policy — Step 3 cannot start until the user confirms here (or explicitly opts out with --yes / equivalent wording in the current request).

Goal: present the auto-recommended plan and let the user confirm or adjust. Skip this step entirely under --yes — proceed with Path A using the analysis and any CLI overrides.

Display summary before asking:

📋 内容分析
  主题：[topic] | 类型：[content_type]
  要点：[key points]
  受众：[audience]

🎨 推荐方案（自动匹配）
  策略：[A/B/C] [name]（[reason]）
  风格：[style] · 布局：[layout] · 配色：[palette or 默认] · 预设：[preset]
  图片：[N]张（封面+[N-2]内容+结尾）
  元素：[background] / [decorations] / [emphasis]

Then ask one question — three paths. Verbatim option copy: references/confirmation.md.

Path A — Quick confirm (trust auto-recommendation): generate a single outline using the recommended strategy + style → save to outline.md → Step 3.

Path B — Customize: ask five questions (strategy/style, layout, palette, count, optional notes) with the recommendation pre-filled — blanks keep the recommendation. Generate one outline with the user's choices → outline.md → Step 3. See references/confirmation.md.

Path C — Detailed mode: two sub-confirmations.

• Step 2a — Content understanding: ask selling points (multi-select), audience, style preference (authentic / professional / aesthetic / auto), optional context. Update analysis.md.
• Step 2b — Three outline variants: generate outline-strategy-a.md, outline-strategy-b.md, outline-strategy-c.md. Each MUST have a different structure AND a different recommended style — include style_reason in the frontmatter. Page-count heuristic: A ~4-6, B ~3-5, C ~3-4. Template: references/workflows/outline-template.md; frontmatter example in references/confirmation.md.
• Step 2c — Selection: ask three questions (outline A/B/C/Combined, style, visual elements). Save selected/merged outline to outline.md → Step 3.

Step 3: Generate Images

With confirmed outline + style + layout + palette:

Visual consistency — image-1 anchor chain: character / mascot / color rendering drifts between calls unless you anchor them. Generate image 1 (cover) first WITHOUT --ref, then pass image 1 as --ref to every subsequent image. This is the single most important consistency trick for this skill — don't skip it even if the backend also supports a session ID.

Generation flow:

1. Write the full prompt for every image to prompts/NN-{type}-{slug}.md in the user's preferred language (backup rule applies), then verify all selected prompt files exist. 2. Generate image 1 first without --ref; backup rule applies to the PNG file. This establishes the anchor. 3. Build a task list for images 2+ using image 1 as --ref <path-to-image-01.png>. 4. Dispatch images 2+ in batches per the ## Batch Generation Policy: backend native batch first, runtime parallel tool calls second, sequential only as fallback. 5. Report progress after each completed image. On failure, retry only the failed item once from the same saved prompt file.

Watermark (if enabled in EXTEND.md): append to the generation prompt:

Include a subtle watermark "[content]" positioned at [position].
The watermark should be legible but not distracting.

See references/config/watermark-guide.md.

Backend selection: per the Image Generation Tools rule at the top — use whatever is available, ask once if multiple, before any generation. Under --yes, use the EXTEND.md preference and fall back to the first available backend. Prompt files MUST exist before invoking any backend.

`codex-imagegen` invocation: when the rule resolves to codex-imagegen, see references/codex-imagegen.md for the invocation contract (preferred baoyu-image-gen --provider codex-cli path, runtime wrapper discovery, parameter notes, stdout schema, batch semantics — n=1 per call so card batches must dispatch one wrapper call per card; the wrapper does NOT accept --sessionId, so chain consistency must come from --ref per Step 3 above).

Session ID (if the backend supports --sessionId): use cards-{topic-slug}-{timestamp} for every image; combined with the ref chain this gives maximum consistency.

Step 4: Completion Report

Image Card Series Complete!

Topic: [topic]
Mode: [Quick / Custom / Detailed]
Strategy: [A/B/C/Combined]
Style: [name]
Palette: [name or "default"]
Layout: [name or "varies"]
Location: [directory]
Images: N total

✓ analysis.md
✓ outline.md
✓ outline-strategy-a/b/c.md (detailed mode only)

- 01-cover-[slug].png ✓ Cover (sparse)
- 02-content-[slug].png ✓ Content (balanced)
- ...
- NN-ending-[slug].png ✓ Ending (sparse)

Content Breakdown Principles

For the style × layout compatibility matrix, see the Style × Layout Matrix above.

Image Modification

Always update the prompt file before regenerating — it's the source of truth and makes changes reproducible.

Text correction policy:

• If a card's title, body copy, tags, or any other rendered text is misspelled, garbled, hard to read, or visually weak, do not patch the bitmap with code.
• For text-correction regenerations, write a new prompt file and a new output path so the flawed candidate is preserved for comparison.
• Post-processing is limited to crop, resize, compression, or format conversion that does not alter text or the main composition.

References

Notes

• Auto-retry once on generation failure before reporting an error.
• For sensitive public figures, use stylized cartoon alternatives.
• Smart Confirm (Step 2) is required; Detailed mode adds a second confirmation (2a + 2c).

Changing Preferences

EXTEND.md lives at the first matching path listed in Step 0. Three ways to change it:

• Edit directly — open EXTEND.md and change fields. Full schema: references/config/preferences-schema.md.
• Reconfigure interactively — delete EXTEND.md (or ask "reconfigure baoyu-xhs-images preferences" / "重新配置"). The next run re-triggers first-time setup.
• Common one-line edits:
• preferred_image_backend: auto — default; runtime-native tool wins, falls back to the only installed backend, asks only if multiple non-native are present.
• preferred_image_backend: codex-imagegen — pin to Codex's built-in.
• preferred_image_backend: baoyu-image-gen — pin to the baoyu-image-gen skill.
• preferred_image_backend: ask — confirm backend every run.
• generation_batch_size: 4 — default number of images to render concurrently when the backend/runtime supports batch or parallel generation.
• preferred_style: notion, preferred_layout: dense, preferred_palette: macaron, language: zh.
• watermark.enabled: true + watermark.content: "@handle" — add a watermark.

codex-imagegen Wrapper Invocation

Load this reference only when the Image Generation Tools rule has resolved to codex-imagegen — i.e., the current runtime exposes no native imagegen skill but codex CLI is on PATH with an active codex login.

Preferred path: route through baoyu-image-gen

If the baoyu-image-gen skill is available in this runtime, always invoke through it rather than calling the wrapper directly. It handles retry/cache/batch/EXTEND.md preferences uniformly with every other provider.

${BUN_X} <baoyu-image-gen-base>/scripts/main.ts \
  --provider codex-cli \
  --image <ABSOLUTE_output> \
  --promptfiles <ABSOLUTE_prompts/NN-{type}-[slug].md> \
  --ar <ratio> \
  [--ref <ABSOLUTE_file>]...

Resolve <baoyu-image-gen-base> the same way you resolve any sibling skill — through your runtime's skill registry (Skill tool, plugin marketplace, or $HOME/.baoyu-skills/baoyu-image-gen/).

Fallback: spawn the wrapper directly

Only when baoyu-image-gen is NOT installed in the current runtime. Discover the wrapper's location at runtime — do NOT hard-code ../../packages/... from this skill:

1. Honor explicit override: if $BAOYU_CODEX_IMAGEGEN_BIN is set and points to a real file, use that path. It may be .ts (spawn bun <path>) or .sh/binary (spawn directly). 2. Search the plugin root: walk up from this skill's directory looking for packages/baoyu-codex-imagegen/src/main.ts. If found, that is the wrapper. Spawn it with bun. 3. Last resort: tell the user that codex-imagegen is not available in this runtime and ask whether to install the baoyu-skills plugin (or set BAOYU_CODEX_IMAGEGEN_BIN) or pick another backend.

Once located, the invocation shape is:

bun <WRAPPER>/main.ts \
  --image <ABSOLUTE_output> \
  --prompt-file <ABSOLUTE_prompts/NN-{type}-[slug].md> \
  --aspect <ratio> \
  [--ref <ABSOLUTE_file>]... \
  [--timeout <ms>] \
  [--cache-dir ~/.cache/baoyu-codex-imagegen] \
  [--log-file <ABSOLUTE_jsonl_log_path>]

If bun is missing, npx -y bun <WRAPPER>/main.ts ... works as a fallback.

Parameter notes

• All filesystem inputs are auto-resolved against process.cwd() when relative, but agents should pass absolute paths to be robust against cwd drift.
• `--timeout` defaults to 300000 (5 min) per codex exec attempt. Raise (e.g. --timeout 600000 for 10 min) on slow networks or large prompts.
• `--cache-dir` is off by default. Enable for repeatable runs to skip redundant generations of the same prompt+aspect+refs.
• Authentication: the wrapper uses the user's Codex subscription — no OPENAI_API_KEY is read or sent.

Stdout contract

Single JSON line:

• Success: {"status":"ok","path":"...","bytes":N,"elapsed_seconds":N,"thread_id":"...","attempts":N,"cached":bool,...}
• Failure: {"status":"error","path":"...","bytes":0,"error":"...","error_kind":"..."}

error_kind values: codex_not_installed, invalid_args, prompt_file_missing, spawn_failed, timeout, no_image_gen_tool_use, output_missing, invalid_png, agent_refused, lock_busy.

On retryable errors (timeout, spawn_failed, no_image_gen_tool_use, output_missing, invalid_png, agent_refused), ask the user whether to retry or fall back to another backend.

Batch semantics

• Codex image_gen returns one image per call (n=1 only). Multi-image jobs must dispatch one wrapper call per image.
• The wrapper does NOT accept a --sessionId flag. Chain/scene consistency must come from --ref reference images.
• --size and --quality are silently ignored — Codex picks pixel dimensions from --aspect.

First-Time Setup

Overview

When no EXTEND.md is found, guide user through preference setup.

⛔ BLOCKING OPERATION: This setup MUST complete before ANY other workflow steps. Do NOT:

• Ask about content/article
• Ask about style or layout
• Ask about target audience
• Proceed to content analysis

ONLY ask the questions in this setup flow, save EXTEND.md, then continue.

Setup Flow

No EXTEND.md found
        │
        ▼
┌─────────────────────┐
│ AskUserQuestion     │
│ (all questions)     │
└─────────────────────┘
        │
        ▼
┌─────────────────────┐
│ Create EXTEND.md    │
└─────────────────────┘
        │
        ▼
    Continue to Step 1

Questions

Language: Use user's input language or saved language preference.

Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):

Question 1: Watermark

header: "Watermark"
question: "Watermark text for generated images? Type your watermark content (e.g., name, @handle)"
options:
  - label: "No watermark (Recommended)"
    description: "No watermark, can enable later in EXTEND.md"

Position defaults to bottom-right.

Question 2: Preferred Style

header: "Style"
question: "Default visual style preference? Or type another style name or your custom style"
options:
  - label: "None (Recommended)"
    description: "Auto-select based on content analysis"
  - label: "cute"
    description: "Sweet, adorable - classic XHS aesthetic"
  - label: "notion"
    description: "Minimalist hand-drawn, intellectual"

Question 3: Save Location

header: "Save"
question: "Where to save preferences?"
options:
  - label: "Project"
    description: ".baoyu-skills/ (this project only)"
  - label: "User"
    description: "~/.baoyu-skills/ (all projects)"

Save Locations

After Setup

1. Create directory if needed 2. Write EXTEND.md with frontmatter 3. Confirm: "Preferences saved to [path]" 4. Continue to Step 1

EXTEND.md Template

---
version: 1
watermark:
  enabled: [true/false]
  content: "[user input or empty]"
  position: bottom-right
  opacity: 0.7
preferred_style:
  name: [selected style or null]
  description: ""
preferred_layout: null
language: null
preferred_image_backend: auto
generation_batch_size: 4
custom_styles: []
---

preferred_image_backend: auto is the baked-in default — first-time setup does not ask about it. The ## Image Generation Tools rule in SKILL.md then picks the runtime-native tool (Codex imagegen, Hermes image_generate, etc.) when available, and falls back to installed backends.

generation_batch_size: 4 is the baked-in default for batch rendering. The current user request may override it for one run.

Modifying Preferences Later

See the ## Changing Preferences section in SKILL.md for the canonical list of common edits (pin backend, change defaults, retrigger setup). Full schema: preferences-schema.md.

Preferences Schema

Full Schema

---
version: 1

watermark:
  enabled: false
  content: ""
  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right

preferred_style:
  name: null              # Built-in or custom style name
  description: ""         # Override/notes

preferred_layout: null    # sparse|balanced|dense|list|comparison|flow

language: null            # zh|en|ja|ko|auto

preferred_image_backend: auto  # auto|ask|<backend-id>

generation_batch_size: 4       # 1-8, used when backend/runtime supports batch or parallel generation

custom_styles:
  - name: my-style
    description: "Style description"
    color_palette:
      primary: ["#FED7E2", "#FEEBC8"]
      background: "#FFFAF0"
      accents: ["#FF69B4", "#FF6B6B"]
    visual_elements: "Hearts, stars, sparkles"
    typography: "Rounded, bubbly hand lettering"
    best_for: "Lifestyle, beauty"
---

Field Reference

Position Options

Custom Style Fields

Example: Minimal Preferences

---
version: 1
watermark:
  enabled: true
  content: "@myusername"
preferred_style:
  name: notion
---

Example: Full Preferences

---
version: 1
watermark:
  enabled: true
  content: "@myxhsaccount"
  position: bottom-right

preferred_style:
  name: notion
  description: "Clean knowledge cards for tech content"

preferred_layout: dense

language: zh

preferred_image_backend: codex-imagegen

generation_batch_size: 4

custom_styles:
  - name: corporate
    description: "Professional B2B style"
    color_palette:
      primary: ["#1E3A5F", "#4A90D9"]
      background: "#F5F7FA"
      accents: ["#00B4D8", "#48CAE4"]
    visual_elements: "Clean lines, subtle gradients, geometric shapes"
    typography: "Modern sans-serif, professional"
    best_for: "Business, SaaS, enterprise"
---

Watermark Guide

Position Diagram

┌─────────────────────────────┐
│                  [top-right]│
│                             │
│                             │
│         IMAGE CONTENT       │
│                             │
│                             │
│[bottom-left][bottom-center][bottom-right]│
└─────────────────────────────┘

Position Recommendations

Content Format

Best Practices

1. Consistency: Use same watermark across all images in series 2. Legibility: Ensure watermark readable on both light/dark areas 3. Size: Keep subtle - should not distract from content

Prompt Integration

When watermark is enabled, add to image generation prompt:

Include a subtle watermark "[content]" positioned at [position].
The watermark should be legible but not distracting from the main content.

Common Issues

Confirmation Questions

Concrete option copy for Step 2 Smart Confirm. SKILL.md states which question to ask and when — this file supplies the verbatim options used in Claude Code. Other runtimes should adapt the wording to their native user-input tool while preserving intent.

Step 2 — Smart Confirm Entry

Single-question confirmation presented right after the auto-recommended plan.

header: Mode
question: How to proceed with the recommended plan?
options:
  - label: 1. ✅ 确认，直接生成（推荐）
    description: Trust auto-recommendation and proceed immediately
  - label: 2. 🎛️ 自定义调整
    description: Modify strategy/style/layout/count in one step
  - label: 3. 📋 详细模式
    description: Generate 3 outline variants, then choose (two confirmations)

Path B — Customize (Option 2)

Batch these five questions. Leaving a field blank keeps the recommended value.

header: Style/Strategy
question: "Strategy + style. Current: {strategy} + {style}"
hint: |
  Strategies: A Story-Driven (warm) | B Information-Dense (notion) | C Visual-First (screen-print)
  Styles: cute / fresh / warm / bold / minimal / retro / pop / notion / chalkboard / study-notes / screen-print / sketch-notes
  Presets: knowledge-card / checklist / tutorial / poster / hand-drawn-edu / ...

header: Layout
question: "Layout. Current: {layout}"
options: [sparse, balanced, dense, list, comparison, flow, mindmap, quadrant]

header: Palette
question: "Palette. Current: {palette or 默认}"
options: [默认, macaron, warm, neon]

header: Count
question: "Image count. Current: {N}"
hint: Range 2-10

header: Notes
question: Optional notes (selling-point emphasis, audience adjustment, color preference)
optional: true

Path C — Detailed Mode

Step 2a: Content Understanding

Batch these questions.

header: SellingPoints
question: Core selling points (pick all that apply)
multiSelect: true

header: Audience
question: Target audience

header: Tone
question: Style preference
options:
  - label: Authentic sharing
  - label: Professional review
  - label: Aesthetic mood
  - label: Auto

header: Context
question: Additional context (optional)
optional: true

Step 2c: Outline & Style Selection

Batch these three questions.

header: Strategy
question: Which outline strategy?
options:
  - label: A — Story-Driven
  - label: B — Information-Dense
  - label: C — Visual-First
  - label: Combine (specify pages from each)

header: Style
question: Visual style?
options:
  - label: Use recommended
  - label: Select preset
  - label: Select style directly
  - label: Custom description

header: Elements
question: Visual elements?
options:
  - label: Use defaults (Recommended)
  - label: Adjust background
  - label: Adjust decorations
  - label: Custom

Outline Variant Frontmatter

Used by Path C when writing the three outline-strategy-{a,b,c}.md files. Each variant MUST have a different structure AND a different recommended style — include style_reason explaining why the style fits the strategy.

---
strategy: a  # a | b | c
name: Story-Driven
style: warm  # recommended style for this strategy
palette: ~   # optional: macaron | warm | neon | ~ (style default)
style_reason: "Warm tones enhance emotional storytelling and personal connection"
elements:
  background: solid-pastel
  decorations: [clouds, stars-sparkles]
  emphasis: star-burst
  typography: highlight
layout: balanced
image_count: 5
---

## P1 Cover
**Type**: cover
**Hook**: "入冬后脸不干了🥹终于找到对的面霜"
**Visual**: Product hero shot with cozy winter atmosphere
**Layout**: sparse

## P2 Problem
**Type**: pain-point
...

Page-count heuristic: strategy A typically 4-6 pages, B typically 3-5, C typically 3-4.

Canvas & Layout

Core canvas specifications and layout grids for Xiaohongshu infographics.

Aspect Ratios

Default: portrait-3-4 for maximum engagement.

Safe Zones

Avoid placing critical content in these areas:

┌─────────────────────────────┐
│                 [like/share]│  ← top-right: avoid
│                             │
│                             │
│      ✓ SAFE CONTENT AREA    │
│                             │
│                             │
│  [title bar overlay area]   │  ← bottom 10%: avoid key info
└─────────────────────────────┘

Grid Layouts

Density-Based Layouts

Structure-Based Layouts

Layout by Position

Grid Cells

For multi-element compositions:

Visual Balance

Sparse Layout

• Single focal point centered
• Breathing room on all sides
• Symmetrical composition

Balanced Layout

• Top-weighted title
• Evenly distributed content below
• Clear visual hierarchy

Dense Layout

• Organized grid structure
• Clear section boundaries
• Compact but readable spacing

List Layout

• Left-aligned items
• Clear number/bullet hierarchy
• Consistent item format

Comparison Layout

• Symmetrical left/right
• Clear visual contrast
• Divider between sections

Flow Layout

• Directional flow (top→bottom or left→right)
• Connected nodes with arrows
• Clear progression indicators

Mindmap Layout

• Central topic node
• Radial branches outward
• Hierarchical sub-branches
• Organic curved connections

Quadrant Layout

• 4-section grid (2×2)
• Clear axis labels
• Each quadrant with distinct content
• Optional circular variant for cycles

Decorative Assets

Visual embellishments and decorative elements for Xiaohongshu infographics.

Emphasis Marks (强调标记)

Elements to draw attention to specific content.

Backgrounds (背景)

Base layer treatments.

Doodles & Emoji (涂鸦)

Hand-drawn decorative elements.

Emoji Integration

Frames (边框)

Container and border treatments.

Dividers (分隔线)

Section separators.

Stickers (贴纸)

Pre-composed decorative elements.

Style-Specific Decorations

Cute Style

• Hearts, stars, sparkles
• Ribbon decorations, sticker-style
• Cute character elements

Notion Style

• Simple line doodles
• Geometric shapes, stick figures
• Maximum whitespace, minimal decoration

Warm Style

• Sun rays, coffee cups, cozy items
• Warm lighting effects
• Friendly, inviting decorations

Fresh Style

• Plant leaves, clouds, water drops
• Simple geometric shapes
• Open, breathing composition

Bold Style

• Exclamation marks, arrows
• Warning icons, strong shapes
• High contrast elements

Pop Style

• Bold shapes, speech bubbles
• Comic-style effects, starburst
• Dynamic, energetic decorations

Retro Style

• Halftone dots, vintage badges
• Classic icons, tape effects
• Aged texture overlays

Chalkboard Style

• Chalk dust effects
• Hand-drawn doodles
• Mathematical formulas, simple icons

Screen-Print Style

• Bold silhouettes, geometric shapes
• Halftone dot patterns, print grain
• No doodles — negative space does the work
• Stencil-cut edges, color block boundaries
• Vintage poster border treatments

Image Processing Layer

Visual effects applied to image elements in Xiaohongshu infographics.

AI Cutout (抠图)

Subject extraction styles for product/figure isolation.

Stroke Effects (描边)

Border treatments for cutout elements.

Stroke Width Guidelines:

• Thin: 2-4px - Subtle, elegant
• Medium: 5-8px - Standard visibility
• Thick: 10-15px - Bold emphasis

Filters (滤镜)

Color grading and mood presets popular on XHS.

Texture Overlays

Additional texture effects.

Blending Modes

For layered compositions.

Effect Combinations

Common effect stacks for different styles:

Cute Style

• Filter: clear-glow or cream-skin
• Stroke: white-solid (medium)
• Texture: none

Notion Style

• Filter: none or muted-tones
• Stroke: white-solid (thin) or none
• Texture: paper (subtle)

Retro Style

• Filter: film-grain
• Stroke: double or dashed
• Texture: halftone, scratch

Bold Style

• Filter: high-saturation
• Stroke: colored-solid (thick)
• Texture: none

Typography System

Text styling elements for Xiaohongshu infographics.

Decorated Text (花字)

Stylized text treatments for emphasis and visual appeal.

Tags & Labels (标签)

Structured text containers.

Text Hierarchy

Recommended text sizing for visual hierarchy.

Text Direction

Text Effects

Language Considerations

Chinese Text (中文)

• Punctuation: 「」（）、。！？
• Spacing: No spaces between characters
• Line height: 1.5-1.8x for readability

Mixed Text

• English in Chinese context: Maintain consistent baseline
• Numbers: Use consistent number style (lining vs old-style)

Style-Specific Typography

Cute Style

• Rounded, bubbly hand lettering
• Soft shadows, playful decorations
• Pink/pastel color accents

Notion Style

• Clean hand-drawn lettering
• Simple sans-serif labels
• Minimal decoration

Bold Style

• Impactful hand lettering with shadows
• High contrast colors
• Strong outlines

Chalkboard Style

• Chalk texture on all text
• Visible imperfections
• Multi-color chalk variety

Macaron Palette

Soft pastel color blocks on warm cream background. Gentle, approachable, educational feel.

Background

• Color: Warm cream (#F5F0E8)
• Texture: Subtle paper grain, warm tone

Colors

Semantic Constraint

Soft pastel macaron color palette. Use block colors as rounded card backgrounds for distinct information sections. Accent coral red sparingly for emphasis on key terms only. All colors should feel gentle and approachable — no saturated or neon tones. Do NOT render color names or role labels as visible text in the image.

Best Paired With

• sketch-notes — natural pairing for hand-drawn educational content
• notion — macaron accents soften the monochrome aesthetic
• chalkboard — pastel chalk tones replace standard chalk colors
• warm — reinforces the cozy, friendly feel
• fresh — complements the clean, natural aesthetic

Neon Palette

Vibrant neon colors on dark background. High-energy, futuristic, eye-catching.

Background

• Color: Dark Purple (#1A1025)
• Texture: Smooth, deep

Colors

Semantic Constraint

Vibrant neon color palette on dark background. Colors should glow against the dark base. High contrast, futuristic feel. Use neon sparingly — too many glowing elements become chaotic. Let dark background breathe. Do NOT render color names, hex codes, or role labels as visible text in the image.

Best Paired With

• bold — amplifies high-impact energy
• pop — neon takes the vibrancy further
• minimal — neon accents on dark create striking contrast
• notion — futuristic knowledge card aesthetic

Warm Palette

Warm earth tones on soft peach background. Cozy, inviting, no cool colors.

Background

• Color: Soft Peach (#FFECD2)
• Texture: Warm, slightly textured

Colors

Semantic Constraint

Warm-only color palette, no cool colors (no blue, green, purple). Earth tones throughout. Evokes comfort, warmth, and trust. All colors should feel like autumn sunlight. Do NOT render color names, hex codes, or role labels as visible text in the image.

Best Paired With

• warm — natural pairing, amplifies cozy feel
• cute — warm pastels enhance the sweet aesthetic
• retro — earth tones complement vintage style
• sketch-notes — warm educational feel

Bold Style

High impact, attention-grabbing aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual

image_effects:
  cutout: clean
  stroke: colored-solid | double
  filter: high-saturation

typography:
  decorated: shadow-3d | stroke-text
  tags: black-white | ribbon
  direction: horizontal | diagonal

decorations:
  emphasis: exclamation | star-burst | red-arrow
  background: solid-saturated | gradient-linear
  doodles: arrows-curvy | squiggles
  frames: none

Color Palette

Visual Elements

• Exclamation marks, arrows, warning icons
• Strong shapes, high contrast elements
• Dramatic compositions
• Bold geometric forms

Typography

• Bold, impactful hand lettering with shadows
• High contrast text treatments
• Large, commanding headlines

Best Layout Pairings

Best For

• Important tips and warnings
• Must-know content
• Critical announcements
• Rankings and comparisons
• Attention-grabbing hooks

Chalkboard Style

Black chalkboard background with colorful chalk drawing aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual | triptych

image_effects:
  cutout: stylized
  stroke: none
  filter: none

typography:
  decorated: handwritten
  tags: none
  direction: horizontal | vertical

decorations:
  emphasis: underline | circle-mark | arrows-curvy
  background: chalkboard
  doodles: hand-drawn-lines | stars-sparkles
  frames: none

Color Palette

Visual Elements

• Hand-drawn chalk illustrations with sketchy, imperfect lines
• Chalk dust effects around text and key elements
• Doodles: stars, arrows, underlines, circles, checkmarks
• Mathematical formulas and simple diagrams
• Eraser smudges and chalk residue textures
• Stick figures and simple icons
• Connection lines with hand-drawn feel

Typography

• Hand-drawn chalk lettering style
• Visible chalk texture on all text
• Imperfect baseline adds authenticity
• White or bright colored chalk for emphasis

Style Rules

Do

• Maintain authentic chalk texture on all elements
• Use imperfect, hand-drawn quality throughout
• Add subtle chalk dust and smudge effects
• Create visual hierarchy with color variety
• Include playful doodles and annotations

Don't

• Use perfect geometric shapes
• Create clean digital-looking lines
• Add photorealistic elements
• Use gradients or glossy effects

Best Layout Pairings

Best For

• Educational content
• Tutorials and how-to's
• Classroom themes
• Teaching materials
• Workshops
• Informal learning sessions
• Knowledge sharing

Cute Style

Sweet, adorable, girly - classic Xiaohongshu aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual | quad

image_effects:
  cutout: soft
  stroke: white-solid | colored-solid
  filter: clear-glow | cream-skin

typography:
  decorated: bubble | highlight
  tags: pill | bubble
  direction: horizontal

decorations:
  emphasis: star-burst | hearts
  background: solid-pastel | gradient-linear
  doodles: hearts | stars-sparkles | flowers
  frames: polaroid | tape-corners

Color Palette

Visual Elements

• Hearts, stars, sparkles, cute faces
• Ribbon decorations, sticker-style
• Cute stickers, emoji icons
• Soft, rounded shapes

Typography

• Rounded, bubbly hand lettering
• Soft shadows, playful decorations
• Pink/pastel color accents on text

Best Layout Pairings

Best For

• Lifestyle content
• Beauty and skincare
• Fashion and style
• Daily tips and hacks
• Personal shares

Fresh Style

Clean, refreshing, natural aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | triptych

image_effects:
  cutout: soft
  stroke: white-solid | none
  filter: clear-glow | cool-tone

typography:
  decorated: none | highlight
  tags: pill | white-black
  direction: horizontal

decorations:
  emphasis: checkmark | circle-mark
  background: solid-white | solid-pastel
  doodles: leaves | clouds | bubbles
  frames: rounded-rect | none

Color Palette

Visual Elements

• Plant leaves, clouds, water drops
• Simple geometric shapes
• Breathing room, open composition
• Natural, organic elements

Typography

• Clean, light hand lettering with breathing room
• Airy spacing
• Fresh color accents

Best Layout Pairings

Best For

• Health and wellness
• Minimalist lifestyle
• Self-care content
• Nature-related topics
• Clean living tips

Minimal Style

Ultra-clean, sophisticated aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single

image_effects:
  cutout: clean
  stroke: none | white-solid
  filter: none | muted-tones

typography:
  decorated: none
  tags: white-black | pill
  direction: horizontal

decorations:
  emphasis: underline | circle-mark
  background: solid-white | solid-pastel
  doodles: hand-drawn-lines
  frames: none | rounded-rect

Color Palette

Visual Elements

• Single focal point, thin lines
• Maximum whitespace
• Simple, clean decorations
• Restrained visual elements

Typography

• Clean, simple hand lettering
• Minimal weight variations
• Elegant spacing

Best Layout Pairings

Best For

• Professional content
• Serious topics
• Elegant presentations
• High-end products
• Business content

Notion Style

Minimalist hand-drawn line art, intellectual aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual

image_effects:
  cutout: clean
  stroke: none | white-solid
  filter: none | muted-tones

typography:
  decorated: none | handwritten
  tags: black-white | pill
  direction: horizontal

decorations:
  emphasis: circle-mark | underline
  background: solid-white | paper-texture
  doodles: hand-drawn-lines | arrows-curvy
  frames: none | rounded-rect

Color Palette

Visual Elements

• Simple line doodles, hand-drawn wobble effect
• Geometric shapes, stick figures
• Maximum whitespace, single-weight ink lines
• Clean, uncluttered compositions

Typography

• Clean hand-drawn lettering
• Simple sans-serif labels
• Minimal decoration on text

Best Layout Pairings

Best For

• Knowledge sharing
• Concept explanations
• SaaS content
• Productivity tips
• Tech tutorials
• Professional content

Pop Style

Vibrant, energetic, eye-catching aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | quad

image_effects:
  cutout: stylized
  stroke: colored-solid | double
  filter: high-saturation

typography:
  decorated: stroke-text | shadow-3d
  tags: bubble | ribbon
  direction: horizontal | curved

decorations:
  emphasis: star-burst | exclamation
  background: solid-saturated | dots
  doodles: stars-sparkles | confetti | squiggles
  frames: none

Color Palette

Visual Elements

• Bold shapes, speech bubbles
• Comic-style effects, starburst
• Dynamic, energetic compositions
• High-energy decorations

Typography

• Dynamic, energetic hand lettering with outlines
• Bold color combinations
• Playful, expressive forms

Best Layout Pairings

Best For

• Exciting announcements
• Fun facts
• Engaging tutorials
• Entertainment content
• Youth-oriented content

Retro Style

Vintage, nostalgic, trendy aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual

image_effects:
  cutout: stylized
  stroke: dashed | double
  filter: film-grain | muted-tones

typography:
  decorated: brush | handwritten
  tags: stamp | ribbon
  direction: horizontal

decorations:
  emphasis: star-burst | numbering
  background: paper-texture | dots
  doodles: stars-sparkles | squiggles
  frames: polaroid | film-strip | stamp-border

Color Palette

Visual Elements

• Halftone dots, vintage badges
• Classic icons, tape effects
• Aged texture overlays
• Nostalgic decorative elements

Typography

• Vintage-style hand lettering
• Classic feel with imperfections
• Aged texture on text

Best Layout Pairings

Best For

• Throwback content
• Classic tips
• Timeless advice
• Vintage aesthetics
• Nostalgic shares

Screen-Print Style

Bold poster art with halftone textures, limited colors, and symbolic storytelling.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual

image_effects:
  cutout: silhouette
  stroke: none
  filter: halftone | print-grain

typography:
  decorated: stroke-text | shadow-3d
  tags: none
  direction: horizontal

decorations:
  emphasis: star-burst | numbering
  background: solid-saturated | paper-texture
  doodles: none
  frames: none

Color Palette

Duotone Pairs (choose ONE based on content mood):

Rule: Use 2-5 colors maximum. Fewer colors = stronger impact.

Visual Elements

• Bold silhouettes and symbolic shapes
• Halftone dot patterns within color fills
• Slight color layer misregistration (print offset effect)
• Geometric framing (circles, arches, triangles)
• Figure-ground inversion (negative space tells secondary story)
• Stencil-cut edges, no outlines — shapes defined by color boundaries
• Typography integrated as design element, not overlay
• Vintage poster border treatments

Typography

• Bold condensed sans-serif or hand-drawn lettering
• Art Deco influences, vintage poster typography
• Typography as integral part of composition (not separate layer)
• High contrast with background for readability

Best Layout Pairings

Best For

• Opinion pieces, cultural commentary
• Movie/music/book recommendations
• Dramatic announcements
• Before/after transformations
• Bold editorial content
• Event promotions

Sketch Notes Style

Hand-drawn educational infographic with slight line wobble, like a high-quality presentation visual summary.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual

image_effects:
  cutout: stylized
  stroke: none
  filter: none

typography:
  decorated: handwritten
  tags: rounded-badge
  direction: horizontal

decorations:
  emphasis: underline | circle-mark | arrows-curvy | star-burst
  background: paper-texture
  doodles: hand-drawn-lines | stars-sparkles | arrows-curvy | squiggles
  frames: rounded-rect

Color Palette

Default: macaron palette (see palettes/macaron.md)

When no --palette is specified, uses macaron colors: warm cream background (#F5F0E8), macaron blue/lavender/mint/peach zone blocks, coral red accent.

Visual Elements

• Hand-drawn wobble on all lines and shapes
• Simple stick-figure characters at desks, working, thinking
• Rounded cards with pastel color blocks as information sections
• Color fills do NOT completely fill outlines (hand-painted feel)
• Doodle decorations: small stars, underlines, checkmarks, lock icons, clipboard icons
• Wavy hand-drawn arrows connecting zones with small text labels
• Thought bubbles and speech bubbles with sketchy outlines
• Simple conceptual icons (documents, lightbulbs, gears, arrows)
• Generous whitespace between zones for clean composition

Typography

• Bold hand-drawn lettering for titles (large, prominent)
• Bold keywords within content zones
• Smaller annotations in secondary text color
• Hand-drawn quality on ALL text, no computer-generated fonts
• Clear information hierarchy: title > zone labels > body text > annotations

Style Rules

Do

• Maintain slight wobble on every line, shape, and border
• Use palette block colors as distinct section backgrounds
• Leave color fills intentionally incomplete at edges
• Include simple doodle icons relevant to content
• Keep generous whitespace between zones
• Use accent color sparingly for emphasis on key terms
• Draw connecting arrows with hand-drawn wavy feel

Don't

• Use perfect geometric shapes or straight lines
• Create photorealistic elements
• Fill colors completely to edges (maintain hand-painted gap)
• Use dark or saturated backgrounds
• Overcrowd with too many decorative elements
• Use gradient fills or glossy effects

Best Layout Pairings

Best For

• Educational content, tutorials, how-to guides
• Process and workflow explanations
• Knowledge summaries, concept diagrams
• Technical explanations made approachable
• Visual summaries of articles or talks
• Onboarding materials, friendly guides

Study Notes Style

Realistic handwritten photo aesthetic - student notes style, dense and messy but readable.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single

image_effects:
  cutout: none
  stroke: none
  filter: natural-photo

typography:
  decorated: none
  tags: none
  direction: horizontal

decorations:
  emphasis: circle-mark | underline | checkmark | cross | star-simple
  background: lined-paper-white
  doodles: arrows-simple | margin-notes | corrections | explanatory-diagrams
  frames: none

Color Palette (Three-Color Annotation System)

Visual Elements

• Realistic photo perspective: top-down view of study desk
• Hand holding blue ballpoint pen, actively underlining
• Extremely dense handwritten content, filling entire page
• Red pen annotations: circles, underlines, stars, boxes
• Yellow highlighter marking key terms
• Correction marks, cramped notes squeezed into margins
• Simple hand-drawn symbols: → * ✓ ✗ !
• Varying pen pressure creating lighter and darker strokes

Typography

• Authentic student handwriting
• Messy but readable, clear structure maintained
• Varying font sizes (large titles, small body, tiny margin notes)
• CJK optimized

Content Structure

Three-section layout:

Top Section

• Core topic (circled multiple times in red)
• First section title + 3-4 key points
• Arrow connections, red underlines

Middle Section

• Second section title (red pen box)
• Numbered steps ①②③
• Specific methods and supplementary notes

Bottom Section

• Third section title (red star)
• Time points / key metrics
• Key quotes / core tips (tiny corner notes)

Best Layout Pairings

Best For

• Study guides, exam notes
• Knowledge organization, framework summaries
• Tutorial summaries, quick notes
• "Top student notes" style content
• Knowledge sharing requiring authentic feel

Style Rules

DO ✓

• Keep content extremely dense
• Use simple symbols (→ * ✓ ✗ !)
• Annotate key points with red pen
• Include correction marks
• Squeeze tiny notes into margins

DON'T ✗

• Use complex emojis
• Leave too much whitespace
• Make neat, tidy layouts
• Add colorful decorations
• Include cartoon elements

Warm Style

Cozy, friendly, approachable aesthetic.

Element Combination

canvas:
  ratio: portrait-3-4
  grid: single | dual

image_effects:
  cutout: soft
  stroke: white-solid | glow
  filter: warm-tone | cream-skin

typography:
  decorated: highlight | handwritten
  tags: ribbon | bubble
  direction: horizontal

decorations:
  emphasis: star-burst | hearts
  background: solid-pastel | gradient-radial
  doodles: clouds | stars-sparkles
  frames: polaroid | tape-corners

Color Palette

Visual Elements

• Sun rays, coffee cups, cozy items
• Warm lighting effects
• Friendly, inviting decorations
• Soft, comfortable shapes

Typography

• Friendly, rounded hand lettering
• Warm color accents
• Comfortable, approachable feel

Best Layout Pairings

Best For

• Personal stories
• Life lessons
• Emotional content
• Comfort and lifestyle
• Heartfelt shares

Style Presets

--preset X expands to a style + layout + optional palette combination. Users can override any dimension.

Empty Palette = use style's built-in colors (or style's default_palette if defined in frontmatter).

Override Examples

• --preset knowledge-card --style chalkboard = chalkboard style with dense layout
• --preset poster --layout quadrant = screen-print style with quadrant layout
• --preset hand-drawn-edu --palette warm = sketch-notes style with flow layout, warm palette instead of macaron
• --style notion --palette macaron = notion rendering rules with macaron colors

Explicit --style/--layout/--palette flags always override preset values.

Xiaohongshu Content Analysis Framework

Deep analysis framework tailored for Xiaohongshu's unique engagement patterns.

Purpose

Before creating infographics, thoroughly analyze the source material to:

• Maximize hook power and swipe motivation
• Identify save-worthy and share-worthy elements
• Plan the visual narrative arc
• Match content to optimal style/layout

Platform Characteristics

Unlike other platforms, Xiaohongshu content must prioritize:

• Hook Power: First image decides 90% of engagement
• Swipe Motivation: Each image must compel users to continue
• Save Value: Content worth bookmarking for later
• Share Triggers: Emotional resonance that drives sharing

Analysis Dimensions

1. Content Type Classification

2. Hook Analysis (爆款标题潜力)

Evaluate title/hook potential using these patterns:

Hook Types:

• 数字钩子: "5个方法", "3分钟学会", "99%的人不知道"
• 痛点钩子: "踩过的坑", "后悔没早知道", "别再..."
• 好奇钩子: "原来...", "竟然...", "没想到..."
• 利益钩子: "省钱", "变美", "效率翻倍"
• 身份钩子: "打工人必看", "学生党", "新手妈妈"

Rating Scale:

• ⭐⭐⭐⭐⭐ (5/5): Multiple strong hooks combined
• ⭐⭐⭐⭐ (4/5): Clear hook with room for enhancement
• ⭐⭐⭐ (3/5): Basic hook, needs strengthening
• ⭐⭐ (2/5): Weak hook, requires significant improvement
• ⭐ (1/5): No clear hook

3. Target Audience (用户画像)

4. Engagement Potential

Save Value (收藏价值):

• Is it reference material? ✓ High save potential
• Is it a checklist or list? ✓ High save potential
• Is it a tutorial? ✓ High save potential
• Is it time-sensitive news? ✗ Low save potential

Share Triggers (分享冲动):

• "我朋友也需要看这个" → High share potential
• "这说的就是我" → Identity resonance
• "太有用了必须分享" → Utility sharing
• "笑死，给朋友看看" → Entertainment sharing

Comment Inducement (评论诱导):

• Open-ended questions: "你是哪种类型？"
• Experience sharing: "评论区说说你的经历"
• Debate triggers: "你觉得呢？"
• Help requests: "有更好的推荐吗？"

Interaction Design (互动设计):

• Polls: "A还是B？"
• Challenges: "你能做到几个？"
• Tags: "@你那个需要的朋友"

5. Visual Opportunity Map

6. Swipe Flow Design

Plan the narrative arc across images:

Swipe Motivation Between Images:

• End each image with a hook for the next
• Use "下一页更精彩" type transitions
• Create information gaps that require swiping
• Build anticipation through numbering ("第3个最重要")

Output Format

Analysis results should be saved to analysis.md with:

---
title: "5个让你效率翻倍的AI工具"
topic: 干货分享
content_type: 工具推荐
source_language: zh
user_language: zh
recommended_image_count: 6
---

## Target Audience

- **Primary**: 打工人、自由职业者 - 追求效率提升
- **Secondary**: 学生党 - 写论文、做作业需要
- **Tertiary**: 内容创作者 - 需要AI辅助

## Hook Analysis

**标题钩子评分**: ⭐⭐⭐⭐ (4/5)
- ✓ 数字钩子: "5个"
- ✓ 利益钩子: "效率翻倍"
- △ 可增强: 加入身份标签 "打工人必看"

**建议优化**:
- 原标题: "5个让你效率翻倍的AI工具"
- 优化: "打工人必看！5个让我效率翻倍的AI神器"

## Value Proposition

**为什么用户要看？**
1. **实用价值**: 直接可用的工具推荐
2. **省时省力**: 不用自己筛选，直接抄作业
3. **FOMO**: 别人都在用，我不能落后

**收藏理由**: 工具清单，需要时可以回来查

## Engagement Design

- **互动点**: 结尾问"你最常用哪个？"
- **评论诱导**: "还有什么好用的工具评论区分享"
- **分享触发**: 打工人会转发给同事

## Content Signals

- "AI工具" → notion + dense
- "效率" → notion + list
- "干货" → minimal + dense

## Swipe Flow

| Image | Position | Purpose | Hook |
|-------|----------|---------|------|
| 1 | Cover | 吸引停留 | 标题+视觉冲击 |
| 2 | Setup | 建立共鸣 | 为什么需要AI工具 |
| 3-5 | Core | 核心价值 | 每页1-2个工具详解 |
| 6 | Ending | 行动引导 | 总结+互动引导 |

## Recommended Approaches

1. **Notion + Dense** - 知识卡片风格，适合干货分享 (recommended)
2. **Notion + List** - 清爽知识卡片风格
3. **Minimal + Balanced** - 简约高端，适合职场人群

Analysis Checklist

Before proceeding to outline generation:

• [ ] Can I identify the content type?
• [ ] Is the hook strong enough? (≥3 stars)
• [ ] Do I know the primary audience?
• [ ] Have I identified save/share triggers?
• [ ] Are there clear visual opportunities?
• [ ] Is the swipe flow planned?
• [ ] Have I identified the best style+layout recommendation?

Xiaohongshu Outline Template

Template for generating infographic series outlines with layout specifications.

File Naming

Outline files use strategy identifier in the name:

• outline-strategy-a.md - Story-driven variant
• outline-strategy-b.md - Information-dense variant
• outline-strategy-c.md - Visual-first variant
• outline.md - Final selected (copied from chosen variant)

Image File Naming

Images use meaningful slugs for readability:

NN-{type}-[slug].png
NN-{type}-[slug].md (in prompts/)

Examples:

• 01-cover-ai-tools.png
• 02-content-why-ai.png
• 03-content-chatgpt.png
• 04-content-midjourney.png
• 05-content-notion-ai.png
• 06-ending-summary.png

Slug rules:

• Derived from image content (kebab-case)
• Must be unique within the series
• Keep short but descriptive (2-4 words)

Layout Selection Guide

Density-Based Layouts

Structure-Based Layouts

Position-Based Recommendations

Outline Format

# Xiaohongshu Infographic Series Outline

---
strategy: a  # a, b, or c
name: Story-Driven
style: notion
default_layout: dense
image_count: 6
generated: YYYY-MM-DD HH:mm
---

## Image 1 of 6

**Position**: Cover
**Layout**: sparse
**Hook**: 打工人必看！
**Slug**: ai-tools
**Filename**: 01-cover-ai-tools.png

**Text Content**:
- Title: 「5个AI神器让你效率翻倍」
- Subtitle: 亲测好用，建议收藏

**Visual Concept**:
科技感背景，多个AI工具图标环绕，中心大标题，
霓虹蓝+深色背景，未来感十足

**Swipe Hook**: 第一个就很强大👇

---

## Image 2 of 6

**Position**: Content
**Layout**: balanced
**Core Message**: 为什么你需要AI工具
**Slug**: why-ai
**Filename**: 02-content-why-ai.png

**Text Content**:
- Title: 「为什么要用AI？」
- Points:
  - 重复工作自动化
  - 创意辅助不卡壳
  - 效率提升10倍

**Visual Concept**:
对比图：左边疲惫打工人，右边轻松使用AI的人
科技线条装饰，简洁有力

**Swipe Hook**: 接下来是具体工具推荐👇

---

## Image 3 of 6

**Position**: Content
**Layout**: dense
**Core Message**: ChatGPT使用技巧
**Slug**: chatgpt
**Filename**: 03-content-chatgpt.png

**Text Content**:
- Title: 「ChatGPT」
- Subtitle: 最强AI助手
- Points:
  - 写文案：给出框架，秒出初稿
  - 改文章：润色、翻译、总结
  - 编程：写代码、找bug
  - 学习：解释概念、出题练习

**Visual Concept**:
ChatGPT logo居中，四周放射状展示功能点
深色科技背景，霓虹绿点缀

**Swipe Hook**: 下一个更适合创意工作者👇

---

## Image 4 of 6

**Position**: Content
**Layout**: dense
**Core Message**: Midjourney绘图
**Slug**: midjourney
**Filename**: 04-content-midjourney.png

**Text Content**:
- Title: 「Midjourney」
- Subtitle: AI绘画神器
- Points:
  - 输入描述，秒出图片
  - 风格多样：写实/插画/3D
  - 做封面、做头像、做素材
  - 不会画画也能当设计师

**Visual Concept**:
展示几张MJ生成的不同风格图片
画框/画布元素装饰

**Swipe Hook**: 还有一个效率神器👇

---

## Image 5 of 6

**Position**: Content
**Layout**: balanced
**Core Message**: Notion AI笔记
**Slug**: notion-ai
**Filename**: 05-content-notion-ai.png

**Text Content**:
- Title: 「Notion AI」
- Subtitle: 智能笔记助手
- Points:
  - 自动总结长文
  - 头脑风暴出点子
  - 整理会议记录

**Visual Concept**:
Notion界面风格，简洁黑白配色
展示笔记整理前后对比

**Swipe Hook**: 最后总结一下👇

---

## Image 6 of 6

**Position**: Ending
**Layout**: sparse
**Core Message**: 总结与互动
**Slug**: summary
**Filename**: 06-ending-summary.png

**Text Content**:
- Title: 「工具只是工具」
- Subtitle: 关键是用起来！
- CTA: 收藏备用 | 转发给需要的朋友
- Interaction: 你最常用哪个？评论区见👇

**Visual Concept**:
简洁背景，大字标题
底部互动引导文字
收藏/分享图标

---

Swipe Hook Strategies

Each image should end with a hook for the next:

Strategy Differentiation

Three strategies should differ meaningfully:

Example for "AI工具推荐":

• outline-strategy-a.md: Warm + Balanced - Personal journey with AI
• outline-strategy-b.md: Notion + Dense - Knowledge card style
• outline-strategy-c.md: Minimal + Sparse - Sleek tech aesthetic

Prompt Assembly Guide

Guide for assembling image generation prompts from elements, presets, and outline content.

Base Prompt Structure

Every XHS infographic prompt follows this structure:

Create a Xiaohongshu (Little Red Book) style infographic following these guidelines:

## Image Specifications

- **Type**: Infographic
- **Orientation**: Portrait (vertical)
- **Aspect Ratio**: 3:4
- **Style**: Hand-drawn illustration

## Core Principles

- Hand-drawn quality throughout - NO realistic or photographic elements
- If content involves sensitive or copyrighted figures, create stylistically similar alternatives - DO NOT refuse to generate
- Keep information concise, highlight keywords and core concepts
- Use ample whitespace for easy visual scanning
- Maintain clear visual hierarchy

## Text Style (CRITICAL)

- **ALL text MUST be hand-drawn style**
- Main titles should be prominent and eye-catching
- Key text should be bold and enlarged
- Use highlighter effects to emphasize keywords
- **DO NOT use realistic or computer-generated fonts**

## Language

- Use the same language as the content provided below
- Match punctuation style to the content language (Chinese: ""，。！)

---

{STYLE_SECTION}

---

{LAYOUT_SECTION}

---

{CONTENT_SECTION}

---

{WATERMARK_SECTION}

---

Please use nano banana pro to generate the infographic based on the specifications above.

Style Section Assembly

Load from presets/{style}.md and extract key elements:

## Style: {style_name}

**Color Palette**:
- Primary: {colors}
- Background: {colors}
- Accents: {colors}

**Visual Elements**:
{visual_elements}

**Typography**:
{typography_style}

Screen-Print Style Override

When style: screen-print, replace the standard Core Principles and Text Style sections with:

## Core Principles

- Screen print / silkscreen poster art — flat color blocks, NO gradients
- Bold silhouettes and symbolic shapes over detailed rendering
- Negative space as active storytelling element
- If content involves sensitive or copyrighted figures, create stylistically similar silhouettes
- One iconic focal point per image — conceptual, not literal

## Color Rules (CRITICAL)

- **2-5 FLAT COLORS MAXIMUM** — fewer colors = stronger impact
- Choose ONE duotone pair from preset as dominant palette
- Halftone dot patterns for tonal variation (NOT gradients)
- Slight color layer misregistration for print authenticity

## Text Style (CRITICAL)

- Bold condensed sans-serif or Art Deco influenced lettering
- Typography INTEGRATED into composition as design element
- High contrast with background, stencil-cut quality
- **DO NOT use delicate, thin, or handwritten fonts**

## Composition

- Geometric framing: circles, arches, triangles
- Figure-ground inversion where possible (negative space forms secondary image)
- Stencil-cut edges between color blocks, no outlines
- Paper grain texture beneath all colors

Palette Override

When --palette is specified (or style has default_palette in frontmatter and no explicit --palette), palette colors replace the style's Color Palette in the prompt. Style rendering rules (Visual Elements, Typography, Style Rules) remain unchanged.

Load from palettes/{palette}.md and override:

## Palette Override: {palette_name}

**Background**: {palette background color and hex}

**Colors**:
- Text: {text color and hex}
- Secondary: {secondary text color and hex}
- Zone 1: {zone color and hex}
- Zone 2: {zone color and hex}
- Zone 3: {zone color and hex}
- Zone 4: {zone color and hex}
- Accent: {accent color and hex}

**Constraint**: {semantic constraint from palette}

Override rules: 1. Palette Background replaces style's background color (keep style's texture description) 2. Palette Colors replace style's Color Palette section entirely 3. Palette Semantic Constraint is appended to the style section 4. If no --palette and style has default_palette → load that palette 5. If no --palette and no default_palette → use style's built-in colors (no override) 6. Explicit --palette always overrides style's default_palette

Layout Section Assembly

Load from elements/canvas.md and extract relevant layout:

## Layout: {layout_name}

**Information Density**: {density}
**Whitespace**: {percentage}

**Structure**:
{structure_description}

**Visual Balance**:
{balance_description}

Content Section Assembly

From outline entry:

## Content

**Position**: {Cover/Content/Ending}
**Core Message**: {message}

**Text Content**:
{text_list}

**Visual Concept**:
{visual_description}

Watermark Section (if enabled)

## Watermark

Include a subtle watermark "{content}" positioned at {position}. The watermark should
be legible but not distracting from the main content.

Assembly Process

Step 0: Resolve Style Preset (if --preset used)

If user specified --preset, resolve to style + layout + palette from references/style-presets.md:

# e.g., --preset hand-drawn-edu → style=sketch-notes, layout=flow, palette=macaron
style, layout, palette = resolve_preset(preset_name)

Explicit --style/--layout/--palette flags override preset values.

Step 1: Load Style Definition

preset = load_preset(style_name)  # e.g., "sketch-notes"

Extract:

• Color palette (may be overridden by palette)
• Visual elements
• Typography style
• Best practices (do/don't)
• default_palette from frontmatter (if present)

Step 1.5: Apply Palette Override (if applicable)

# Priority: explicit --palette > preset palette > style default_palette > none
palette = resolve_palette(cli_palette, preset_palette, style_default_palette)
if palette:
    palette_def = load_palette(palette)  # e.g., "macaron"
    # Replace style colors with palette colors
    # Keep style rendering rules (visual elements, typography, style rules)

Step 2: Load Layout

layout = get_layout_from_canvas(layout_name)  # e.g., "dense"

Extract:

• Information density guidelines
• Whitespace percentage
• Structure description
• Visual balance rules

Step 3: Format Content

From outline entry, format:

• Position context (Cover/Content/Ending)
• Text content with hierarchy
• Visual concept description
• Swipe hook (for context, not in prompt)

Step 4: Add Watermark (if applicable)

If preferences include watermark:

• Add watermark section with content, position, opacity

Step 5: Visual Consistency — Reference Image Chain

When generating multiple images in a series:

1. Image 1 (cover): Generate without --ref — this establishes the visual anchor 2. Images 2+: Always pass image 1 as --ref to the installed image generation skill. Read that skill's SKILL.md and use its documented interface rather than calling its scripts directly. For each later image, use the assembled prompt file as input, set the output image path, keep aspect ratio 3:4, use quality 2k, and pass image 1 as the reference. This ensures the AI maintains the same character design, illustration style, and color rendering across the series.

Step 6: Combine

Assemble all sections into final prompt following base structure.

Example: Assembled Prompt

Create a Xiaohongshu (Little Red Book) style infographic following these guidelines:

## Image Specifications

- **Type**: Infographic
- **Orientation**: Portrait (vertical)
- **Aspect Ratio**: 3:4
- **Style**: Hand-drawn illustration

## Core Principles

- Hand-drawn quality throughout - NO realistic or photographic elements
- If content involves sensitive or copyrighted figures, create stylistically similar alternatives
- Keep information concise, highlight keywords and core concepts
- Use ample whitespace for easy visual scanning
- Maintain clear visual hierarchy

## Text Style (CRITICAL)

- **ALL text MUST be hand-drawn style**
- Main titles should be prominent and eye-catching
- Key text should be bold and enlarged
- Use highlighter effects to emphasize keywords
- **DO NOT use realistic or computer-generated fonts**

## Language

- Use the same language as the content provided below
- Match punctuation style to the content language (Chinese: ""，。！)

---

## Style: Notion

**Color Palette**:
- Primary: Black (#1A1A1A), dark gray (#4A4A4A)
- Background: Pure white (#FFFFFF), off-white (#FAFAFA)
- Accents: Pastel blue (#A8D4F0), pastel yellow (#F9E79F), pastel pink (#FADBD8)

**Visual Elements**:
- Simple line doodles, hand-drawn wobble effect
- Geometric shapes, stick figures
- Maximum whitespace, single-weight ink lines
- Clean, uncluttered compositions

**Typography**:
- Clean hand-drawn lettering
- Simple sans-serif labels
- Minimal decoration on text

---

## Layout: Dense

**Information Density**: High (5-8 key points)
**Whitespace**: 20-30% of canvas

**Structure**:
- Multiple sections, structured grid
- More text, compact but organized
- Title + multiple sections with headers + numerous points

**Visual Balance**:
- Organized grid structure
- Clear section boundaries
- Compact but readable spacing

---

## Content

**Position**: Content (Page 3 of 6)
**Core Message**: ChatGPT 使用技巧

**Text Content**:
- Title: 「ChatGPT」
- Subtitle: 最强 AI 助手
- Points:
  - 写文案：给出框架，秒出初稿
  - 改文章：润色、翻译、总结
  - 编程：写代码、找 bug
  - 学习：解释概念、出题练习

**Visual Concept**:
ChatGPT logo 居中，四周放射状展示功能点
深色科技背景，霓虹绿点缀

---

## Watermark

Include a subtle watermark "@myxhsaccount" positioned at bottom-right
with approximately 50% visibility. The watermark should
be legible but not distracting from the main content.

---

Please use nano banana pro to generate the infographic based on the specifications above.

Prompt Checklist

Before generating, verify:

• [ ] Style section loaded from correct preset
• [ ] Palette override applied (if --palette specified or style has default_palette)
• [ ] Layout section matches outline specification
• [ ] Content accurately reflects outline entry
• [ ] Language matches source content
• [ ] Watermark included (if enabled in preferences)
• [ ] No conflicting instructions