From f22374ab6241f24e4e386b2d138c125bcca07a94 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jim=20Liu=20=E5=AE=9D=E7=8E=89?= Date: Mon, 23 Mar 2026 22:38:27 -0500 Subject: [PATCH] fix(baoyu-cover-image): simplify reference image handling based on model capability --- skills/baoyu-cover-image/SKILL.md | 9 ++++----- .../references/workflow/reference-images.md | 15 +++++++++++---- 2 files changed, 15 insertions(+), 9 deletions(-) diff --git a/skills/baoyu-cover-image/SKILL.md b/skills/baoyu-cover-image/SKILL.md index 802b3cc..ed12062 100644 --- a/skills/baoyu-cover-image/SKILL.md +++ b/skills/baoyu-cover-image/SKILL.md @@ -162,15 +162,14 @@ if (Test-Path "$HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md") { "user" } 5. **Detect language**: Compare source, user input, EXTEND.md preference 6. **Determine output directory**: Per File Structure rules -**⚠️ People in Reference Images — MUST follow all 3 rules:** +**⚠️ People in Reference Images:** If reference images contain **people** who should appear in the cover: -1. **`usage: direct`** — MUST set in refs description file. NEVER use `style` or `palette` when people need to appear -2. **Per-character description** — MUST describe each person's distinctive features (hair, glasses, skin tone, clothing) in `refs/ref-NN-{slug}.md`. Vague descriptions like "a man" will fail -3. **`--ref` flag** — MUST pass reference image via `--ref` in Step 4 so the model sees actual faces +- **Model supports `--ref`** (default): Copy image to `refs/`, pass via `--ref` at generation. No description file needed — the model sees the face directly. +- **Model does NOT support `--ref`** (Jimeng, Seedream 3.0): Create `refs/ref-NN-{slug}.md` with per-character description (hair, glasses, skin tone, clothing). Embed as MUST/REQUIRED instructions in prompt text. -See [reference-images.md § Character Analysis](references/workflow/reference-images.md) for description format. +See [reference-images.md](references/workflow/reference-images.md) for full decision table. ### Step 2: Confirm Options ⚠️ diff --git a/skills/baoyu-cover-image/references/workflow/reference-images.md b/skills/baoyu-cover-image/references/workflow/reference-images.md index f7147a9..84c11d6 100644 --- a/skills/baoyu-cover-image/references/workflow/reference-images.md +++ b/skills/baoyu-cover-image/references/workflow/reference-images.md @@ -16,17 +16,24 @@ Guide for processing user-provided reference images in cover generation. **If user provides file path**: 1. Copy to `refs/ref-NN-{slug}.{ext}` (NN = 01, 02, ...) -2. Create description: `refs/ref-NN-{slug}.md` -3. Verify files exist before proceeding +2. **Only** create description file `refs/ref-NN-{slug}.md` when model does NOT support `--ref` (see below) +3. Verify image file exists before proceeding -**Description File Format**: +**When to create description file**: + +| Situation | Action | +|-----------|--------| +| Model supports `--ref` (Google, OpenAI, OpenRouter, Replicate, Seedream 4.0+) | Copy image only. **No description file needed.** Pass via `--ref` at generation. | +| Model does NOT support `--ref` (Jimeng, Seedream 3.0) | Copy image + create description file. Embed description in prompt text. | + +**Description File Format** (only when needed): ```yaml --- ref_id: NN filename: ref-NN-{slug}.{ext} usage: direct | style | palette --- -[User's description or auto-generated description] +[Character or style description to embed in prompt] ``` | Usage | When to Use |