mirror of
https://github.com/JimLiu/baoyu-skills.git
synced 2026-07-22 18:19:48 +08:00
Jim Liu 宝玉
2c800c670a
* docs: add runtime-neutral User Input Tools convention across skills Introduce docs/user-input-tools.md as the author-side canonical source and inline the tool-selection rule into every SKILL.md that prompts the user. Also add Skill Self-Containment and User Input Tools sections to CLAUDE.md and the copy-verbatim template to docs/creating-skills.md, so skills stay portable across Claude Code, Codex, Hermes, and other runtimes. * feat: runtime-neutral image generation convention across skills - Introduce inline `## Image Generation Tools` rule in every rendering SKILL.md so skills delegate backend choice instead of hard-coding one; author-side canonical copy lives in docs/image-generation-tools.md. - Add `## Reference Images` support (`--ref`, frontmatter `references:` with direct/style/palette usage) to all seven image-rendering skills. - Move build-batch.ts (with ref propagation into batch JSON) from baoyu-article-illustrator to baoyu-imagine so non-backend skills don't own backend-specific scripts; update baoyu-image-gen stub in sync and relax the CLAUDE.md deprecation note accordingly. * refactor: slim heavy SKILL.md files and move detail to references/ Trim the four largest active skills and move presets, option tables, and confirmation scripts into per-skill references/ so SKILL.md stays focused on the decision flow. - baoyu-slide-deck: 761→258, + styles-gallery.md, confirmation.md - baoyu-image-cards: 657→280, + gallery.md, confirmation.md - baoyu-post-to-wechat: 518→267, + multi-account.md, api-setup.md - baoyu-imagine: 500→230, + providers/, usage-examples.md Also un-deprecate baoyu-image-gen (drop stub warning) so it stays functional alongside baoyu-imagine, and update CLAUDE.md to reflect that both superseded skills are kept in sync rather than stubbed. * refactor: slim four medium SKILL.md files into references/ Continue the P2 pattern on the next tier of skills — move option catalogs, per-provider/adapter detail, and repeated EXTEND.md path boilerplate into their own references so SKILL.md stays focused on the decision flow. - baoyu-comic: 380→297 (art/tone/preset tables → auto-selection.md; Step 7 expanded detail → workflow.md) - baoyu-infographic: 312→207 (layouts/styles/combinations/keywords → gallery.md; ASCII box tables → markdown tables) - baoyu-format-markdown: 376→296 (title + summary generation → title-summary.md; ASCII box tables → markdown tables) - baoyu-url-to-markdown: 334→169 (quality gate + recovery → quality-gate.md; adapters + media download → adapters.md) * chore: sync deprecated skills with their replacements Per project policy, baoyu-xhs-images and baoyu-image-gen are kept functional alongside the active skills they were superseded by. Sync their SKILL.md bodies and references/ to the slimmed baoyu-image-cards and baoyu-imagine versions respectively, so cross-cutting fixes stay consistent. Only the frontmatter (name, description, version, homepage) differs — content is identical. - baoyu-xhs-images: 657→281 (synced with baoyu-image-cards + new confirmation.md, gallery.md) - baoyu-image-gen: 408→231 (synced with baoyu-imagine + new providers/, usage-examples.md) * refactor: collapse EXTEND.md boilerplate into priority tables Replace the dual bash/powershell existence-check blocks and ASCII box art with a single markdown priority table across nine SKILL.md files. The runtime-neutral phrasing removes shell-specific snippets without losing the priority semantics. * fix: address refactor-skills branch review findings - image-gen: restore EXTEND.md paths to baoyu-image-gen (were pointing at baoyu-imagine) and mark descriptions of both deprecated skills as [Deprecated]. - xhs-images: sync neon/warm palettes with image-cards to add the "do not render color names/hex as visible text" safety sentence. - infographic: restore Layout Gallery (21), Style Gallery (21), Recommended Combinations, and Keyword Shortcuts inline (previous refactor split them out but SKILL.md still depended on them), and add the missing references/config/first-time-setup.md + preferences-schema.md. - image-cards / xhs-images / slide-deck / format-markdown: restore the sections that got over-slimmed into references/ (galleries, presets, dimensions, auto-selection, style x layout matrix, title/summary flow) and drop the now-empty shell files. - docs/image-generation-tools.md: note that backend skills themselves (baoyu-imagine, baoyu-image-gen, baoyu-danger-gemini-web) are exempt from the ## Image Generation Tools section requirement. * feat(image-gen): sync Z.AI GLM-Image provider from baoyu-imagine Add Z.AI as a full provider in the deprecated baoyu-image-gen skill so it stays in sync with baoyu-imagine's provider list. - new scripts/providers/zai.ts + zai.test.ts (verbatim port; test factory trimmed to match image-gen's CliArgs shape). - types.ts: "zai" added to Provider union and default_model. - main.ts: rate-limit defaults, provider help text, env var help, --provider validation, loadProviderModule, detectProvider auto-detect chain, getModelForProvider, YAML parser allow-lists. - references/config: Q2e Z.AI model question + zai slot in the preferences schema and batch.provider_limits. Scope is intentionally limited to the Z.AI chain; unrelated drift between image-gen and imagine (OpenAI image-API dialect, aspectRatioSource, imageSizeSource) is left alone. * docs: align inline-convention wording and note backend-skill exemption - docs/user-input-tools.md: fix stale "links here" wording so it matches the inline convention already enforced everywhere else. - CLAUDE.md §Image Generation Tools: inline the backend-skill exemption so readers don't need to cross-reference docs/image-generation-tools.md.
358 lines
12 KiB
Markdown
358 lines
12 KiB
Markdown
---
|
|
name: first-time-setup
|
|
description: First-time setup and default model selection flow for baoyu-image-gen
|
|
---
|
|
|
|
# First-Time Setup
|
|
|
|
## Overview
|
|
|
|
Triggered when:
|
|
1. No EXTEND.md found → full setup (provider + model + preferences)
|
|
2. EXTEND.md found but `default_model.[provider]` is null → model selection only
|
|
|
|
## Setup Flow
|
|
|
|
```
|
|
No EXTEND.md found EXTEND.md found, model null
|
|
│ │
|
|
▼ ▼
|
|
┌─────────────────────┐ ┌──────────────────────┐
|
|
│ AskUserQuestion │ │ AskUserQuestion │
|
|
│ (full setup) │ │ (model only) │
|
|
└─────────────────────┘ └──────────────────────┘
|
|
│ │
|
|
▼ ▼
|
|
┌─────────────────────┐ ┌──────────────────────┐
|
|
│ Create EXTEND.md │ │ Update EXTEND.md │
|
|
└─────────────────────┘ └──────────────────────┘
|
|
│ │
|
|
▼ ▼
|
|
Continue Continue
|
|
```
|
|
|
|
## Flow 1: No EXTEND.md (Full Setup)
|
|
|
|
**Language**: Use user's input language or saved language preference.
|
|
|
|
Use AskUserQuestion with ALL questions in ONE call:
|
|
|
|
### Question 1: Default Provider
|
|
|
|
```yaml
|
|
header: "Provider"
|
|
question: "Default image generation provider?"
|
|
options:
|
|
- label: "Google (Recommended)"
|
|
description: "Gemini multimodal - high quality, reference images, flexible sizes"
|
|
- label: "OpenAI"
|
|
description: "GPT Image - consistent quality, reliable output"
|
|
- label: "Azure OpenAI"
|
|
description: "Azure-hosted GPT Image deployments with resource-specific routing"
|
|
- label: "OpenRouter"
|
|
description: "Router for Gemini/FLUX/OpenAI-compatible image models"
|
|
- label: "DashScope"
|
|
description: "Alibaba Cloud - Qwen-Image, strong Chinese/English text rendering"
|
|
- label: "MiniMax"
|
|
description: "MiniMax image generation with subject-reference character workflows"
|
|
- label: "Replicate"
|
|
description: "Community models - nano-banana-pro, flexible model selection"
|
|
- label: "Z.AI"
|
|
description: "GLM-Image - text-to-image with recommended aspect sizes"
|
|
```
|
|
|
|
### Question 2: Default Google Model
|
|
|
|
Only show if user selected Google or auto-detect (no explicit provider).
|
|
|
|
```yaml
|
|
header: "Google Model"
|
|
question: "Default Google image generation model?"
|
|
options:
|
|
- label: "gemini-3-pro-image-preview (Recommended)"
|
|
description: "Highest quality, best for production use"
|
|
- label: "gemini-3.1-flash-image-preview"
|
|
description: "Fast generation, good quality, lower cost"
|
|
- label: "gemini-3-flash-preview"
|
|
description: "Fast generation, balanced quality and speed"
|
|
```
|
|
|
|
### Question 2b: Default OpenRouter Model
|
|
|
|
Only show if user selected OpenRouter.
|
|
|
|
```yaml
|
|
header: "OpenRouter Model"
|
|
question: "Default OpenRouter image generation model?"
|
|
options:
|
|
- label: "google/gemini-3.1-flash-image-preview (Recommended)"
|
|
description: "Best general-purpose OpenRouter image model with reference-image workflows"
|
|
- label: "google/gemini-2.5-flash-image-preview"
|
|
description: "Fast Gemini preview model on OpenRouter"
|
|
- label: "black-forest-labs/flux.2-pro"
|
|
description: "Strong text-to-image quality through OpenRouter"
|
|
```
|
|
|
|
### Question 2c: Default Azure Deployment
|
|
|
|
Only show if user selected Azure OpenAI.
|
|
|
|
```yaml
|
|
header: "Azure Deploy"
|
|
question: "Default Azure image deployment name?"
|
|
options:
|
|
- label: "gpt-image-1.5 (Recommended)"
|
|
description: "Best default if your Azure deployment uses the same name"
|
|
- label: "gpt-image-1"
|
|
description: "Previous GPT Image deployment name"
|
|
```
|
|
|
|
### Question 2d: Default MiniMax Model
|
|
|
|
Only show if user selected MiniMax.
|
|
|
|
```yaml
|
|
header: "MiniMax Model"
|
|
question: "Default MiniMax image generation model?"
|
|
options:
|
|
- label: "image-01 (Recommended)"
|
|
description: "Best default, supports aspect ratios and custom width/height"
|
|
- label: "image-01-live"
|
|
description: "Faster variant, use aspect ratio instead of custom size"
|
|
```
|
|
|
|
### Question 2e: Default Z.AI Model
|
|
|
|
Only show if user selected Z.AI.
|
|
|
|
```yaml
|
|
header: "Z.AI Model"
|
|
question: "Default Z.AI image generation model?"
|
|
options:
|
|
- label: "glm-image (Recommended)"
|
|
description: "Latest GLM-Image, best aspect-ratio coverage and text rendering"
|
|
- label: "cogview-4-250304"
|
|
description: "Legacy CogView-4 model with 16-pixel size stepping"
|
|
- label: "cogview-4"
|
|
description: "Previous CogView-4 snapshot for compatibility"
|
|
```
|
|
|
|
### Question 3: Default Quality
|
|
|
|
```yaml
|
|
header: "Quality"
|
|
question: "Default image quality?"
|
|
options:
|
|
- label: "2k (Recommended)"
|
|
description: "2048px - covers, illustrations, infographics"
|
|
- label: "normal"
|
|
description: "1024px - quick previews, drafts"
|
|
```
|
|
|
|
### Question 4: Save Location
|
|
|
|
```yaml
|
|
header: "Save"
|
|
question: "Where to save preferences?"
|
|
options:
|
|
- label: "Project (Recommended)"
|
|
description: ".baoyu-skills/ (this project only)"
|
|
- label: "User"
|
|
description: "~/.baoyu-skills/ (all projects)"
|
|
```
|
|
|
|
### Save Locations
|
|
|
|
| Choice | Path | Scope |
|
|
|--------|------|-------|
|
|
| Project | `.baoyu-skills/baoyu-image-gen/EXTEND.md` | Current project |
|
|
| User | `$HOME/.baoyu-skills/baoyu-image-gen/EXTEND.md` | All projects |
|
|
|
|
### EXTEND.md Template
|
|
|
|
```yaml
|
|
---
|
|
version: 1
|
|
default_provider: [selected provider or null]
|
|
default_quality: [selected quality]
|
|
default_aspect_ratio: null
|
|
default_image_size: null
|
|
default_model:
|
|
google: [selected google model or null]
|
|
openai: null
|
|
azure: [selected azure deployment or null]
|
|
openrouter: [selected openrouter model or null]
|
|
dashscope: null
|
|
minimax: [selected minimax model or null]
|
|
replicate: null
|
|
zai: [selected zai model or null]
|
|
---
|
|
```
|
|
|
|
## Flow 2: EXTEND.md Exists, Model Null
|
|
|
|
When EXTEND.md exists but `default_model.[current_provider]` is null, ask ONLY the model question for the current provider.
|
|
|
|
### Google Model Selection
|
|
|
|
```yaml
|
|
header: "Google Model"
|
|
question: "Choose a default Google image generation model?"
|
|
options:
|
|
- label: "gemini-3-pro-image-preview (Recommended)"
|
|
description: "Highest quality, best for production use"
|
|
- label: "gemini-3.1-flash-image-preview"
|
|
description: "Fast generation, good quality, lower cost"
|
|
- label: "gemini-3-flash-preview"
|
|
description: "Fast generation, balanced quality and speed"
|
|
```
|
|
|
|
### OpenAI Model Selection
|
|
|
|
```yaml
|
|
header: "OpenAI Model"
|
|
question: "Choose a default OpenAI image generation model?"
|
|
options:
|
|
- label: "gpt-image-1.5 (Recommended)"
|
|
description: "Latest GPT Image model, high quality"
|
|
- label: "gpt-image-1"
|
|
description: "Previous generation GPT Image model"
|
|
```
|
|
|
|
### Azure Deployment Selection
|
|
|
|
```yaml
|
|
header: "Azure Deploy"
|
|
question: "Choose a default Azure image deployment name?"
|
|
options:
|
|
- label: "gpt-image-1.5 (Recommended)"
|
|
description: "Use when your Azure deployment name matches the GPT-image-1.5 model"
|
|
- label: "gpt-image-1"
|
|
description: "Use when your Azure deployment name matches GPT-image-1"
|
|
```
|
|
|
|
Notes for Azure setup:
|
|
|
|
- In `baoyu-image-gen`, Azure `--model` / `default_model.azure` should be the Azure deployment name, not just the underlying model family.
|
|
- If the deployment name is custom, save that exact deployment name in `default_model.azure`.
|
|
|
|
### OpenRouter Model Selection
|
|
|
|
```yaml
|
|
header: "OpenRouter Model"
|
|
question: "Choose a default OpenRouter image generation model?"
|
|
options:
|
|
- label: "google/gemini-3.1-flash-image-preview (Recommended)"
|
|
description: "Recommended for image output and reference-image edits"
|
|
- label: "google/gemini-2.5-flash-image-preview"
|
|
description: "Fast preview-oriented image generation"
|
|
- label: "black-forest-labs/flux.2-pro"
|
|
description: "High-quality text-to-image through OpenRouter"
|
|
```
|
|
|
|
### DashScope Model Selection
|
|
|
|
```yaml
|
|
header: "DashScope Model"
|
|
question: "Choose a default DashScope image generation model?"
|
|
options:
|
|
- label: "qwen-image-2.0-pro (Recommended)"
|
|
description: "Best DashScope model for text rendering and custom sizes"
|
|
- label: "qwen-image-2.0"
|
|
description: "Faster 2.0 variant with flexible output size"
|
|
- label: "qwen-image-max"
|
|
description: "Legacy Qwen model with five fixed output sizes"
|
|
- label: "qwen-image-plus"
|
|
description: "Legacy Qwen model, same current capability as qwen-image"
|
|
- label: "z-image-turbo"
|
|
description: "Legacy DashScope model for compatibility"
|
|
- label: "z-image-ultra"
|
|
description: "Legacy DashScope model, higher quality but slower"
|
|
```
|
|
|
|
Notes for DashScope setup:
|
|
|
|
- Prefer `qwen-image-2.0-pro` when the user needs custom `--size`, uncommon ratios like `21:9`, or strong Chinese/English text rendering.
|
|
- `qwen-image-max` / `qwen-image-plus` / `qwen-image` only support five fixed sizes: `1664*928`, `1472*1104`, `1328*1328`, `1104*1472`, `928*1664`.
|
|
- In `baoyu-image-gen`, `quality` is a compatibility preset. It is not a native DashScope parameter.
|
|
|
|
### Replicate Model Selection
|
|
|
|
```yaml
|
|
header: "Replicate Model"
|
|
question: "Choose a default Replicate image generation model?"
|
|
options:
|
|
- label: "google/nano-banana-pro (Recommended)"
|
|
description: "Google's fast image model on Replicate"
|
|
- label: "google/nano-banana"
|
|
description: "Google's base image model on Replicate"
|
|
```
|
|
|
|
### MiniMax Model Selection
|
|
|
|
```yaml
|
|
header: "MiniMax Model"
|
|
question: "Choose a default MiniMax image generation model?"
|
|
options:
|
|
- label: "image-01 (Recommended)"
|
|
description: "Best general-purpose MiniMax image model with custom width/height support"
|
|
- label: "image-01-live"
|
|
description: "Lower-latency MiniMax image model using aspect ratios"
|
|
```
|
|
|
|
Notes for MiniMax setup:
|
|
|
|
- `image-01` is the safest default. It supports official `aspect_ratio` values and documented custom `width` / `height` output sizes.
|
|
- `image-01-live` is useful when the user prefers faster generation and can work with aspect-ratio-based sizing.
|
|
- MiniMax subject reference currently uses `subject_reference[].type = character`; docs recommend front-facing portrait references in JPG/JPEG/PNG under 10MB.
|
|
|
|
### Z.AI Model Selection
|
|
|
|
```yaml
|
|
header: "Z.AI Model"
|
|
question: "Choose a default Z.AI image generation model?"
|
|
options:
|
|
- label: "glm-image (Recommended)"
|
|
description: "Latest GLM-Image; pixels round to multiples of 32 and cap at 2^22"
|
|
- label: "cogview-4-250304"
|
|
description: "Legacy CogView-4 snapshot with 16-pixel size stepping"
|
|
- label: "cogview-4"
|
|
description: "Earlier CogView-4 snapshot for compatibility"
|
|
```
|
|
|
|
Notes for Z.AI setup:
|
|
|
|
- Set `ZAI_API_KEY` (or legacy `BIGMODEL_API_KEY`) from https://docs.z.ai/.
|
|
- `glm-image` supports recommended aspect sizes (1280x1280, 1728x960, 1568x1056, …); uncommon ratios auto-fit to the 2^22 pixel budget on multiples of 32.
|
|
- Legacy CogView models use 16-pixel stepping and cap at 2^21 pixels per image.
|
|
- Z.AI does not accept reference images or `n > 1` in `baoyu-image-gen`; use Google/OpenAI providers for those workflows.
|
|
|
|
### Update EXTEND.md
|
|
|
|
After user selects a model:
|
|
|
|
1. Read existing EXTEND.md
|
|
2. If `default_model:` section exists → update the provider-specific key
|
|
3. If `default_model:` section missing → add the full section:
|
|
|
|
```yaml
|
|
default_model:
|
|
google: [value or null]
|
|
openai: [value or null]
|
|
azure: [value or null]
|
|
openrouter: [value or null]
|
|
dashscope: [value or null]
|
|
minimax: [value or null]
|
|
replicate: [value or null]
|
|
zai: [value or null]
|
|
```
|
|
|
|
Only set the selected provider's model; leave others as their current value or null.
|
|
|
|
## After Setup
|
|
|
|
1. Create directory if needed
|
|
2. Write/update EXTEND.md with frontmatter
|
|
3. Confirm: "Preferences saved to [path]"
|
|
4. Continue with image generation
|