xhs-image-style-duo

name	xhs-image-style-duo
description	为已确定要生图的页面输出默认 `1` 个推荐风格和 `1` 条可直接贴到 ChatGPT / Gemini 等网页里的 final prompt。用户明确说要比较时，才输出 `2` 个风格候选。它负责风格延展，不负责整组图分工，也不负责默认首图结构。严禁默认走 API 生图。

XHS Image Style Duo

开工前必读（2026-04-26 视觉宪法 + 风格池）

在产出任何生图 prompt 前，必须做两件事：

1. 视觉宪法 + 风格选择：

   • 读 CLAUDE.md 顶部「账号视觉宪法」三条（漫画优先 / 真人脸漫画化 / photo 只取文字 anchors）
   • 读 references/cover-style-pool.md 风格池 + 双轴决策表选风格
   • 默认 canonical-breakout（账号金本，全题型适用），按题型 / 情绪在双轴表里切换
   • canonical 措辞：physically-rendered manga figure with photo-accurate likeness, rendered as comic illustration (not photo) —— 不要再写 photorealistic foreground transition
   • 禁词（绝不出现在 final prompt）：photorealistic / cinematic photoreal / studio photo / 8k photoreal / octane render / reference photo
   • canonical 内部禁加：watercolor / aura / speed lines / beams / gold leaf / Chinese ink / Pop Art / geometric / blueprint / minimal / dark / moody（44 轮实验败北）

2. 真人辨识度 Gate：读 references/person-confidence-rubric.md

   • 对 prompt 中每个真人自评信心度 0-100（输出 JSON）
   • 🟢 HIGH (75+)：直接用名字
   • 🟡 MED (40-74)：加文字 anchors_suggestion 进 prompt + 对话中提示
   • 🔴 LOW (0-39)：暂停，走下面的 photo pipeline

🔴 LOW-tier 的 4 步 photo pipeline（不允许跳步骤）

按视觉宪法第 3 条 — photo pipeline 只用来提取文字 anchors，不 embed 照片：

1. 抓照片

   # 运动号优先 ESPN：
   python scripts/fetch_player_photo.py "<Player Name>" \
     --espn-id <id> \
     --school <team> \
     --output references/players/<slug>
   
   # 批次：
   python scripts/fetch_player_photo.py --batch references/players/<manifest>.json
   

2. Read 图：Read references/players/<slug>/espn_headshot.png（+ espn_action.png / wikipedia.jpg）
3. 写 appearance.md（纯文字）：Write references/players/<slug>/appearance.md，按 references/players/README.md 的 schema（髮型 / 髮色 / 膚色 / 臉型 / 臉部特徵 / 體型 / 招牌標記 + 一段 Prompt 用描述），信心度标「已確認」
4. 在 prompt 引用文字：Read appearance.md，把「Prompt 用描述」文字段落嵌入 Final Prompt 的人物描述段
   • 绝对不要写 reference photo: <path> / based on photo / 照片中的人物 这类指令
   • 绝对不要贴 image URL 进 prompt
   • 只写文字外貌（broad jaw / monolid eyes / curly hair）

复用规则：appearance.md 已存在就直接 Read、不重跑脚本。照片被 .gitignore 掉不进版控，appearance.md 是金本一人一次就够。

手动 fallback：网络受限时用户手动把照片存到 references/players/<slug>/，AI 一样 Read → 写 appearance.md。Step 2-4 不变。

违反这两条铁律前请先 stop 并询问用户。

风格选择（双轴）

不再有「canonical / 脱离 canonical」的二元划分 — canonical-breakout 是全题型默认，按题型 / 情绪在 references/cover-style-pool.md 双轴表里切换。简化映射：

题目 / 用户信号	推荐首选	备选（出两版时用）
NBA / MLB 动作题（高张力）	⭐ canonical-breakout	slam-dunk-classic
球员故事 / 个人成长 / profile	watercolor-ink 🟡	canonical-breakout
群像 / 系列 / 多角色	slam-dunk-classic 🟢	100m-poster
商业题 / 薪资 / 转播（高张力）	100m-poster 🟡	canonical-breakout
致敬 / 退役 / 生涯回顾	slam-dunk-movie 🟡 / ink-wash-silhouette 🔬	watercolor-ink
系列统一视觉 / 设计感	risograph-duotone 🔬	100m-poster
轻知识 / 辅助图 / 可爱	mascot-q 🟢	—

何时出两版让用户选

以下情况，agent 应主动出两版（不是一版）：

• 用户说「这次换个调性试试」 / 「这人不适合 break-out」 / 「想看看备选」
• NBA 动作题但题目调性偏故事（canonical 是一版，watercolor 是另一版）
• 用户对当前风格结果不满意，但又没明确说要哪种方向
• 题目方向本身有争议（agent 判断不准卖人物还是卖结构）

不需要出两版的情况：标准 NBA 动作题、用户明确指定风格、节奏紧张只要出一版。

多角色封面硬规则（2 人以上同框）

踩过的坑：同模板 {player} 变量 × 4 人 → AI 把四人都画成同一个正面跳投。详见 四大天王 post-mortem 的第 5 条。

两个工具必须一起用，缺一不可：

1. 每人写死一个独特动作类型，不要让 AI 自己分配

   - {player A}: {unique action A}
   - {player B}: {unique action B}
   - {player C}: {unique action C}
   

2. 用排除句否定最熟的默认动作（AI 最容易 fall back 到这些）

   NO ball in frame. NO arms raised in shooting motion.
   Do not draw any of them in a frontal-shooting pose.
   Do not show any of them holding a ball above their head.
   

如果是 4 人封面，再额外加 pose differentiation enforcement 段在 prompt 尾部：

POSE DIFFERENTIATION ENFORCEMENT: the four players must NOT share the same
action type. Two attacking + two defending, four different camera angles,
four different emotions.

这层 redundancy 看起来多余，实战证明是必要的。生成 prompt 时，任何「多个球员 + 同模板」场景都先检查这两条有没有放进去。

动作选择规则：动作要服务叙事。回标题找核心矛盾（进攻 / 防守 / 归来 / 王座），再分配动作。不要谁最帅画谁。

---

交付闭环（硬规则，不允许偷步骤）

每产出一个 prompt，必须走完这三步。只走一两步不算交付。

步骤 1 — 落盘到 demo_posts/<slug>/prompts/

• 位置：demo_posts/<date>-<slug>/prompts/（workspace 不存在就先用 scripts/scaffold_post_folder.py 建）
• 命名：cover_prompt.md、page2_prompt.md、page3_prompt.md …（多版本用 cover_prompt_v2.md 继续往上叠）
• 文件结构：推荐风格 / 5 项判断 / ## Final Prompt 内含 ```text ``` 代码块 / 如果要继续改

步骤 2 — 跑 stage_prompt.py 一次做完 commit + push + 印 URL

python scripts/stage_prompt.py demo_posts/<slug>/prompts/<name>_prompt.md
# 多个一起也 OK：
python scripts/stage_prompt.py path1.md path2.md -m "prompts: <自定 message>"

脚本会 git add → commit → push，并按当前 branch 印出 GitHub blob URL。URL 必须直接从脚本输出复制进聊天，不要手拼。

步骤 3 — 聊天回复只给摘要 + URL，绝不贴全文

格式（照着 CLAUDE.md 的示例）：

**<标题/图名> v<版本>**

构图：<layout、分区比例、几个模块>
动作：<镜头、姿态、关键动作瞬间>
风格：<canonical break-out / A-E 风格包的名字；非预设要写为什么>
改动：<和上一版的 diff 要点；首次生成就写 v1 锚点>

Prompt: <从 stage_prompt.py 复制的 GitHub blob URL>

禁区

• 不要把 Final Prompt 的文本贴进聊天（哪怕只有几行）。一律让用户点 URL 进去复制 ```text ``` 代码块。
• 不要在没 push 的情况下给 URL。脚本没跑完 = 不允许说「Prompt 链接：」。
• 不要只在聊天给 prompt。聊天讨论出一版 prompt，下一步必然是 Write 到 demo_posts/<slug>/prompts/<name>_prompt.md 再走步骤 2-3。讨论稿不是交付稿。

---

这个 skill 只做一件事：

把一个已经锁住任务的页面，变成 可直接在网页聊天界面里使用的生图 prompt。

默认交付不是“两套风格实验包”，而是：

• 1 个推荐风格
• 1 条 final prompt

只有用户明确说：

• “给我两个风格比较”
• “同一张图换两种方向看看”
• “我现在要探索，不急着定稿”

才进入 duo 模式，输出 2 条 final prompt。

默认交付原则

默认交付必须满足这 5 条：

• prompt 可以直接贴进 ChatGPT / Gemini 等网页
• prompt 本身不依赖 API 参数
• prompt 不混入流程说明、参考案例解释、上传图片说明
• 默认不调用图片 API，机器只负责产 prompt，不负责替用户发起生图
• 所有小红书封面和图组 prompt 必须指定竖版 3:4 比例（小红书标准首图比例）

这个 skill 不负责决定整篇帖子该用真人图、官方截图还是生图。那一步交给 xhs-visual-asset-mix。
如果是图 1 首图，但封面结构还没锁住，先回到 xhs-cover-template 或按 README 的主流程先锁首图结构。

什么时候用

遇到这些任务直接使用：

• 用户要生图 prompt
• 用户说“封面画风怎么定”
• 用户说“背景太乱”“动作没张力”“不像封面图”
• 用户说“同一张图换两种风格看看”
• 用户要更像动漫名场面 / 游戏动画 / 杂志拼贴 / 极简海报 / Q 版
• 用户想要一条可直接贴用的 final prompt

什么时候不要用

• 还没决定这张图是不是首图，先回到 xhs-visual-asset-mix
• 首图结构还没锁，先回到 xhs-cover-template 或 xhs-note-assembly
• 用户只是想长期探索视觉系统，还没落到某一页，优先放进 explorations/visuals/

先做 5 个判断

1. 这张图是不是首图

• 如果是首图，先确认封面结构已经锁住

2. 主角是谁

• 必须只有一个绝对主角

3. 这一张图最该卖什么 默认从下面选一个：

• 脸
• 动作
• 冲突
• 情绪
• 信息结构

4. 背景是不是稳定的

• 如果用户明显还在探索背景，先不要把背景写死

5. 这张图更适合哪种风格包

• 热血运动动画封面
• 欧美游戏动画电影感
• 体育商业杂志拼贴
• 极简数据海报
• Q 版吉祥物

如果读者不懂赛事或规则，画面里也要有足够明确的主角、冲突和信息锚点。
图上可见文字是否真的需要，也要先判断；真正给用户看的角标和封面词，优先短中文。

内部生成顺序

内部可以按这个顺序想，但默认不要把全部中间层都交给用户：

1. 抽故事骨架
2. 锁主体锚点
3. 补背景层
4. 合成 final prompt

默认只把 final prompt 交付给用户。
只有在调图阶段明确需要排查问题时，才额外展示：

• story atoms
• subject anchor prompt
• background prompt

风格包

A. 热血运动动画封面

• 适合人物主角、情绪冲突、热血动作
• 更像运动番关键分镜，不是泛二次元

B. 欧美游戏动画电影感

• 适合巨星、联盟变化、商业新闻人物题
• 更立体、更高级、更像高预算游戏动画 key art

C. 体育商业杂志拼贴

• 适合转播、薪资、扩军、平台战争
• 用人物、数字、场馆、屏幕、剪报做高密度商业新闻海报

D. 极简数据海报

• 适合规则、钱、结构变化
• 人物可以弱化，数字和信息结构更重要

E. Q 版吉祥物

• 适合更轻一点、更可收藏、更偏角色化的题
• 不是普通 chibi，而是带运动语义的角色转译

默认优先级：

• 人物大新闻 -> 欧美游戏动画电影感 / 热血运动动画封面
• 商业新闻 -> 体育商业杂志拼贴 / 极简数据海报
• 轻松角色化 -> Q 版吉祥物

脚本使用规则

优先用脚本：

• scripts/generate_style_duo.py

但这个脚本现在的职责是：

• 生成网页可直接使用的 prompt 文件
• 默认只输出 1 个推荐 prompt
• 用户明确要求比较时，才输出 2 个 prompt
• 不再默认走 API 生图

默认产物应该是：

• final_prompt.txt
• web_prompts.md

如果是比较模式，再额外输出：

• style_1_final_prompt.txt
• style_2_final_prompt.txt

存档约定

prompt 落盘路径和命名见顶部「交付闭环」步骤 1，不再重复。

额外约定（不走 stage_prompt.py，手动处理）：

• 用户手动跑出来的成图，建议放在 demo_posts/<date>-<slug>/images/，用 cover.png / page2.png / cover_v2.png 这种和 prompt 文件名能对得上的命名
• 同一篇贴文的图片实验不要散落到多个无关目录

输出格式

默认模式

## 推荐风格
- 风格：
- 为什么选它：
- 这张图最该卖什么：

## Final Prompt
```text
...

如果要继续改

• 背景优先改什么：
• 不要动什么：

### 比较模式

```markdown
## Style 1
- 风格：
- 为什么选它：

## Final Prompt 1
```text
...

Style 2

• 风格：
• 为什么选它：

Final Prompt 2

...

推荐

• 当前更推荐的是：
• 为什么：

## 快速参考

- [references/style-profiles.md](./references/style-profiles.md)
  何时读：要从风格包里挑主风格和备选风格时。

- [references/style-selection-rules.md](./references/style-selection-rules.md)
  何时读：不确定该优先选哪一个风格，或比较模式下该选哪两个时。

- [references/prompt-polish-rules.md](./references/prompt-polish-rules.md)
  何时读：用户说背景太乱、动作不够、脸不够像、Q 版不够可爱时。

- [references/output-evaluation.md](./references/output-evaluation.md)
  何时读：已经有两个 prompt，但不知道该继续哪一个时。

## 不要这样做

- 不要默认输出两种风格
- 不要默认把 `story atoms / subject anchor / background prompt` 全交给用户
- 不要把流程说明、参考案例、上传图片解释写进 final prompt
- 不要让 final prompt 依赖 API 参数才能使用
- 不要默认尝试 API 生图
- 不要先决定画风，再决定这张图要卖什么
- 不要先把背景写得比主角还重要
- 不要把可见文案默认写成英文大字