Add baoyu-skills package

2026-09-13 07:37:15 +08:00
commit 832004bd6f
782 changed files with 251339 additions and 0 deletions
--- a/baoyu-skills/skills/baoyu-infographic/references/config/first-time-setup.md
+++ b/baoyu-skills/skills/baoyu-infographic/references/config/first-time-setup.md
@@ -0,0 +1,153 @@
+---
+name: first-time-setup
+description: 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
+
+1. Create the directory if needed
+2. Write EXTEND.md with frontmatter (see template below)
+3. Confirm: "Preferences saved to [path]"
+4. Continue to Step 1.2
+
+## EXTEND.md Template
+
+```yaml
+---
+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`.