mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-23 10:39:47 +08:00
Jim Liu 宝玉
c3cbce9ce3
BREAKING CHANGE: removed `baoyu-imagine` and `baoyu-image-cards`. All functionality now lives under `baoyu-image-gen` and `baoyu-xhs-images` respectively. Cross-skill `## Image Generation Tools` examples updated across baoyu-article-illustrator, baoyu-comic, baoyu-cover-image, baoyu-infographic, and baoyu-slide-deck. Migration: existing `~/.baoyu-skills/baoyu-imagine/EXTEND.md` configs are auto-renamed to `…/baoyu-image-gen/EXTEND.md` on first run via the legacy-path resolver in `scripts/main.ts`.
154 lines
4.6 KiB
Markdown
154 lines
4.6 KiB
Markdown
---
|
|
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`.
|