正文
获取原文件references/config/first-time-setup.md
Overview
When no EXTEND.md is found, guide the user through preference setup before generating any infographic. Saved preferences shift Step-3 recommendations and Step-4 defaults only — they never bypass Step 4 confirmation (see the ## Confirmation Policy section in SKILL.md).
⛔ BLOCKING OPERATION: This setup MUST complete before ANY other workflow steps. Do NOT:
- Ask about source content or topic
- Ask about layout, style, or aspect
- Begin Step 1.2 content analysis
ONLY ask the questions in this setup flow, save EXTEND.md, then continue to Step 1.2.
Setup Flow
No EXTEND.md found
│
▼
┌─────────────────────┐
│ AskUserQuestion │
│ (all questions) │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ Create EXTEND.md │
└─────────────────────┘
│
▼
Continue to Step 1.2
Questions
Language: Use the user's input language for question text. Do not always default to English.
Use a single AskUserQuestion with multiple questions (the runtime auto-adds an "Other" option):
Question 1: Preferred Layout
header: "Layout"
question: "Default layout preference?"
options:
- label: "Auto-select (Recommended)"
description: "Pick layout per content in Step 3"
- label: "bento-grid"
description: "Multiple topics, overview (general default)"
- label: "linear-progression"
description: "Timelines, processes, tutorials"
- label: "dense-modules"
description: "High-density modules, data-rich guides"
Question 2: Preferred Style
header: "Style"
question: "Default visual style preference?"
options:
- label: "Auto-select (Recommended)"
description: "Pick style per tone in Step 3"
- label: "craft-handmade"
description: "Hand-drawn, paper craft (general default)"
- label: "corporate-memphis"
description: "Flat vector, vibrant"
- label: "morandi-journal"
description: "Hand-drawn doodle, warm Morandi tones"
Question 3: Preferred Aspect
header: "Aspect"
question: "Default aspect ratio?"
options:
- label: "Auto-select (Recommended)"
description: "Pick per layout in Step 4"
- label: "landscape"
description: "16:9 (slides, blogs, web)"
- label: "portrait"
description: "9:16 (mobile, social, dense modules)"
- label: "square"
description: "1:1 (social, thumbnails)"
Question 4: Language
header: "Language"
question: "Output language for infographic text?"
options:
- label: "Auto-detect (Recommended)"
description: "Match source content language"
- label: "zh"
description: "Chinese (中文)"
- label: "en"
description: "English"
Question 5: 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
| Choice | Path | Scope |
|---|---|---|
| Project | .baoyu-skills/baoyu-infographic/EXTEND.md |
Current project |
| User | ~/.baoyu-skills/baoyu-infographic/EXTEND.md |
All projects |
XDG path (${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-infographic/EXTEND.md) is also recognized at read time but not offered as a save target during first-time setup.
After Setup
- Create the directory if needed
- Write EXTEND.md with frontmatter (see template below)
- Confirm: "Preferences saved to [path]"
- Continue to Step 1.2
EXTEND.md Template
---
version: 1
preferred_layout: [selected layout or null]
preferred_style: [selected style or null]
preferred_aspect: [landscape|portrait|square|null]
language: [selected language or null]
preferred_image_backend: auto
custom_styles: []
---
preferred_image_backend: auto is the baked-in default — first-time setup never asks about it. The ## Image Generation Tools rule in SKILL.md then picks the runtime-native tool (Codex imagegen, Hermes image_generate, etc.) when one is available, and falls back to installed backends like baoyu-image-gen.
Modifying Preferences Later
See the ## Changing Preferences section in SKILL.md for the canonical list of common edits (pin backend, change layout/style defaults, retrigger setup). Full schema: references/config/preferences-schema.md.