mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-30 13:49:48 +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`.
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-image-gen`, `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-image-gen` | `baoyu-image-gen` 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."
|
|
---
|
|
```
|