mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-31 22:29:48 +08:00
Jim Liu 宝玉
60d0b9c95b
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.
127 lines
4.5 KiB
Markdown
127 lines
4.5 KiB
Markdown
---
|
|
name: preferences-schema
|
|
description: EXTEND.md YAML schema for baoyu-infographic user preferences
|
|
---
|
|
|
|
# Preferences Schema
|
|
|
|
## Full Schema
|
|
|
|
```yaml
|
|
---
|
|
version: 1
|
|
|
|
preferred_layout: null # any of the 21 layouts (see Layout Gallery in SKILL.md) or null
|
|
preferred_style: null # any of the 21 styles (see Style Gallery in SKILL.md) or null
|
|
preferred_aspect: null # landscape|portrait|square|null (custom W:H also accepted)
|
|
|
|
language: null # zh|en|ja|ko|null (null = auto-detect from source)
|
|
|
|
preferred_image_backend: auto # auto|ask|<backend-id>
|
|
|
|
custom_styles: # extra style definitions merged with the 21 built-ins
|
|
- name: my-brand
|
|
description: "Short description shown in Step 3 recommendations"
|
|
prompt_fragment: "Style traits to inject into Step 5 prompt"
|
|
---
|
|
```
|
|
|
|
## Field Reference
|
|
|
|
| Field | Type | Default | Description |
|
|
|-------|------|---------|-------------|
|
|
| `version` | int | 1 | Schema version |
|
|
| `preferred_layout` | string\|null | null | Pre-selected layout — surfaces as the top recommendation in Step 3 |
|
|
| `preferred_style` | string\|null | null | Pre-selected style — surfaces as the top recommendation in Step 3 |
|
|
| `preferred_aspect` | string\|null | null | Default aspect for Step 4 (named preset or W:H string) |
|
|
| `language` | string\|null | null | Output language (null = auto-detect from source content) |
|
|
| `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`. |
|
|
| `custom_styles` | array | [] | Additional styles available alongside the 21 built-ins |
|
|
|
|
Backend resolution logic is documented in the `## Image Generation Tools` section of `SKILL.md`. This doc only defines the field.
|
|
|
|
All fields in this schema are defaults only — they shape Step-3 recommendations and Step-4 defaults but never bypass Step 4 confirmation (see the `## Confirmation Policy` section in SKILL.md).
|
|
|
|
Example backend ids:
|
|
|
|
| Value | Meaning |
|
|
|-------|---------|
|
|
| `codex-imagegen` | Codex built-in `imagegen` tool |
|
|
| `baoyu-imagine` | `baoyu-imagine` skill / script backend |
|
|
| `image_generate` | Generic runtime image tool such as Hermes |
|
|
|
|
## Layout Options
|
|
|
|
See the **Layout Gallery (21)** table in `SKILL.md` for the canonical list. Common picks:
|
|
|
|
| Value | Best For |
|
|
|-------|----------|
|
|
| `bento-grid` | General default — overview, multiple topics |
|
|
| `linear-progression` | Timelines, processes, tutorials |
|
|
| `dense-modules` | High-density modules, data-rich guides |
|
|
| `hub-spoke` | Central concept with related items |
|
|
| `dashboard` | Metrics, KPIs |
|
|
|
|
## Style Options
|
|
|
|
See the **Style Gallery (21)** table in `SKILL.md` for the canonical list. Common picks:
|
|
|
|
| Value | Description |
|
|
|-------|-------------|
|
|
| `craft-handmade` | Hand-drawn, paper craft (default) |
|
|
| `corporate-memphis` | Flat vector, vibrant |
|
|
| `morandi-journal` | Hand-drawn doodle, warm Morandi tones |
|
|
| `pop-laboratory` | Blueprint grid, lab precision |
|
|
| `retro-pop-grid` | 1970s retro pop art, Swiss grid |
|
|
|
|
## Aspect Options
|
|
|
|
| Value | Ratio | Notes |
|
|
|-------|-------|-------|
|
|
| `landscape` | 16:9 | Slides, blog headers, web banners |
|
|
| `portrait` | 9:16 | Mobile, social, dense modules (default for `dense-modules`) |
|
|
| `square` | 1:1 | Social posts, thumbnails |
|
|
| Custom W:H | e.g. `3:4`, `4:3`, `2.35:1` | Pass through verbatim to the prompt |
|
|
|
|
## Custom Style Fields
|
|
|
|
| Field | Required | Description |
|
|
|-------|----------|-------------|
|
|
| `name` | Yes | Unique style identifier (kebab-case) |
|
|
| `description` | Yes | One-line description shown in Step 3 recommendations |
|
|
| `prompt_fragment` | Yes | Style traits appended into the Step 5 prompt body |
|
|
|
|
## Example: Minimal Preferences
|
|
|
|
```yaml
|
|
---
|
|
version: 1
|
|
preferred_layout: bento-grid
|
|
preferred_style: craft-handmade
|
|
language: zh
|
|
---
|
|
```
|
|
|
|
`preferred_image_backend` is omitted above; absence is treated as `auto`.
|
|
|
|
## Example: Full Preferences
|
|
|
|
```yaml
|
|
---
|
|
version: 1
|
|
|
|
preferred_layout: dense-modules
|
|
preferred_style: morandi-journal
|
|
preferred_aspect: portrait
|
|
|
|
language: zh
|
|
|
|
preferred_image_backend: codex-imagegen
|
|
|
|
custom_styles:
|
|
- name: my-brand
|
|
description: "Brand-aligned warm pastel infographic"
|
|
prompt_fragment: "Use brand pastel palette (#F2C7B6, #B6D7E8, #C8E0B4); rounded rectangles; warm hand-drawn outlines; ample whitespace."
|
|
---
|
|
```
|