mirror of https://github.com/JimLiu/baoyu-skills.git synced 2026-07-12 05:51:44 +08:00

Files

T

Jim Liu 宝玉 60d0b9c95b docs(baoyu-infographic): add Confirmation Policy as single source of truth

Consolidate the confirmation rule into one section so defaults, keywords,
and EXTEND.md preferences are treated as recommendation inputs only — never
as authorization to skip Step 4. Remove the repeated reminders that were
scattered across Step 5, Step 6, Default combination, Keyword Shortcuts,
and the preferences docs.

2026-04-21 16:58:58 -05:00

4.6 KiB

Raw Blame History

name, description

name	description
first-time-setup	First-time setup flow for baoyu-infographic preferences

First-Time Setup

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-imagine.

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.

4.6 KiB Raw Blame History