mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-27 04:09:47 +08:00
Jim Liu 宝玉
adb783ae6d
Replaces the stateless ask-once backend rule with a 4-step resolution (current-request override > saved preference > auto-select > ask) and adds a single `preferred_image_backend` field (auto | ask | <backend-id>) to every image-consuming skill's EXTEND.md schema. Runtime-native tools (Codex `imagegen`, Hermes `image_generate`, ...) win by default; absent field equals `auto` so existing user EXTEND.md files stay valid with no schema version bump. Each image-consuming skill also gains a top-level `## Changing Preferences` section as a first-class surface for pinning a backend and editing common one-line preferences. Applies across: - baoyu-infographic (reverts in-progress two-field image_backend_mode design) - baoyu-comic - baoyu-cover-image - baoyu-image-cards - baoyu-article-illustrator - baoyu-slide-deck - baoyu-xhs-images - docs/image-generation-tools.md (canonical author-side doc)
128 lines
3.5 KiB
Markdown
128 lines
3.5 KiB
Markdown
# EXTEND.md Schema
|
|
|
|
Structure for user preferences in `.baoyu-skills/baoyu-slide-deck/EXTEND.md`.
|
|
|
|
## Full Schema
|
|
|
|
```yaml
|
|
# Slide Deck Preferences
|
|
|
|
## Defaults
|
|
style: blueprint # Preset name OR "custom"
|
|
audience: general # beginners | intermediate | experts | executives | general
|
|
language: auto # auto | en | zh | ja | etc.
|
|
review: true # true = review outline before generation
|
|
preferred_image_backend: auto # auto | ask | <backend-id>
|
|
|
|
## Custom Dimensions (only when style: custom)
|
|
dimensions:
|
|
texture: clean # clean | grid | organic | pixel | paper
|
|
mood: professional # professional | warm | cool | vibrant | dark | neutral
|
|
typography: geometric # geometric | humanist | handwritten | editorial | technical
|
|
density: balanced # minimal | balanced | dense
|
|
|
|
## Custom Styles (optional)
|
|
custom_styles:
|
|
my-style:
|
|
texture: organic
|
|
mood: warm
|
|
typography: humanist
|
|
density: minimal
|
|
description: "My custom warm and friendly style"
|
|
```
|
|
|
|
## Field Descriptions
|
|
|
|
### Defaults
|
|
|
|
| Field | Type | Default | Description |
|
|
|-------|------|---------|-------------|
|
|
| `style` | string | `blueprint` | Preset name, `custom`, or custom style name |
|
|
| `audience` | string | `general` | Default target audience |
|
|
| `language` | string | `auto` | Output language (auto = detect from input) |
|
|
| `review` | boolean | `true` | Show outline review before generation |
|
|
| `preferred_image_backend` | string | `auto` | Image backend selection. `auto` = prefer runtime-native tool, fall back to the only installed backend, ask if multiple non-native are present. `ask` = always confirm on every run. `<backend-id>` (e.g., `codex-imagegen`, `baoyu-imagine`, `image_generate`) = pin this backend when available; fall back to `auto` when it isn't. Absent = `auto`. Resolution logic is documented in `SKILL.md`'s `## Image Generation Tools` section. |
|
|
|
|
### Custom Dimensions
|
|
|
|
Only used when `style: custom`. Defines dimension values directly.
|
|
|
|
| Field | Options | Default |
|
|
|-------|---------|---------|
|
|
| `texture` | clean, grid, organic, pixel, paper | clean |
|
|
| `mood` | professional, warm, cool, vibrant, dark, neutral | professional |
|
|
| `typography` | geometric, humanist, handwritten, editorial, technical | geometric |
|
|
| `density` | minimal, balanced, dense | balanced |
|
|
|
|
### Custom Styles
|
|
|
|
Define reusable custom dimension combinations.
|
|
|
|
```yaml
|
|
custom_styles:
|
|
style-name:
|
|
texture: <texture>
|
|
mood: <mood>
|
|
typography: <typography>
|
|
density: <density>
|
|
description: "Optional description"
|
|
```
|
|
|
|
Then use with: `/baoyu-slide-deck content.md --style style-name`
|
|
|
|
## Minimal Examples
|
|
|
|
### Just change default style
|
|
|
|
```yaml
|
|
style: sketch-notes
|
|
```
|
|
|
|
### Prefer no reviews
|
|
|
|
```yaml
|
|
review: false
|
|
```
|
|
|
|
### Custom default dimensions
|
|
|
|
```yaml
|
|
style: custom
|
|
dimensions:
|
|
texture: organic
|
|
mood: professional
|
|
typography: humanist
|
|
density: minimal
|
|
```
|
|
|
|
### Define reusable custom style
|
|
|
|
```yaml
|
|
custom_styles:
|
|
brand-style:
|
|
texture: clean
|
|
mood: vibrant
|
|
typography: editorial
|
|
density: balanced
|
|
description: "Company brand style"
|
|
```
|
|
|
|
## File Locations
|
|
|
|
Priority order (first found wins):
|
|
|
|
1. `.baoyu-skills/baoyu-slide-deck/EXTEND.md` (project)
|
|
2. `$HOME/.baoyu-skills/baoyu-slide-deck/EXTEND.md` (user)
|
|
|
|
## First-Time Setup
|
|
|
|
When no EXTEND.md exists, the skill prompts for initial preferences:
|
|
|
|
1. Preferred style (preset or custom)
|
|
2. Default audience
|
|
3. Language preference
|
|
4. Review preference
|
|
5. Save location (project or user)
|
|
|
|
Creates EXTEND.md at chosen location.
|