Skill-封面

统一管理多种封面风格。每种风格拥有独立的双比例基底和视觉合同；人物身份与动作作为共享资产复用。目前已注册 实战风格。

输入契约

必须取得主标题。接受以下可选参数：

• style：风格名称或别名；未指定时使用注册表的 default_style。
• subtitle：副标题；缺省时保留副标题区域留白，不擅自编造结论。
• tag：左上角标签，默认 AI 实测。
• highlight：需要强调的词组，可重复传入。
• gesture：动作预设，默认 zhengzuo（正坐）。
• reference_cover：任意参考封面；提供时进入“参考封面换人换字”模式。
• identity_image：项目数字人/真人身份帧；参考封面模式必填。
• avatar_video：原始数字人 master；需要现场截取身份帧时使用。
• output_dir：用户指定路径优先。

默认同时输出 3:4 和 4:3。只有用户明确只要一种比例时才减少输出。

风格与动作路由

1. 读取 references/style-registry.json。
2. 将用户说出的风格名称与 display_name、slug 和 aliases 匹配。
3. 用户未指定风格时使用 default_style。如果参考图明显要求另一种已注册风格，则优先尊重参考图。
4. 读取注册项的 reference_doc，只加载所选风格的详细视觉合同。
5. 读取 assets/shared/gestures/registry.json 和对应动作的 manifest.json；风格只用 default_gesture 与 allowed_gestures 引用动作，不重复保存动作定义。
6. 未注册的新风格或动作不得假装已存在；分别按“新增风格”和“新增动作”流程建立资产包。

制作工作流

1. 判断使用“注册风格”还是“参考封面换人换字”；选择标题、副标题、标签和强调词。

2. 使用内置 view_image 查看脚本返回的基底、身份图、动作图和风格参考图。

3. 运行 scripts/build_prompt.py 生成每个比例的提示词与绝对参考图路径。例如：

   python3 scripts/build_prompt.py \
     --style shizhan \
     --title '史上最强国产开源模型，Kimi K3完全实测！' \
     --subtitle '真实项目全流程挑战｜综合能力超过 Opus' \
     --highlight 'Kimi K3' \
     --highlight '完全实测'
   

4. 使用内置 imagegen 能力，每个比例单独调用一次 image_gen。禁止将一种比例机械裁剪成另一种比例。

5. 严格按脚本返回的顺序传入参考图：比例基底负责整体构图，共享身份图负责脸、发型和黑 T，共享动作图只负责姿态；动作 manifest 若提供比例构图参考，则下一张图负责人物位置、尺寸和露出范围；最后一张风格参考图负责视觉校准。动作 manifest 的精确构图规则优先于风格中的通用人物范围。

6. 输出后逐张检查。文字错误时只做一次“仅修正文字”的定向编辑，并重新声明身份、动作、构图、背景和色彩不变。

7. 用户指定目录时保存到该目录。属于现有视频项目时保存到项目的 封面/，工程中间产物不得进入 成片/。

8. 运行 scripts/validate_cover.py 检查双比例与基础清晰度，再完成人工视觉质检。

参考封面换人换字

当用户要求“截取我的数字人替换图中人物”“照这张封面改成当前项目”或同义动作时：

1. 优先从项目的原始 HeyGen/avatar master 截帧，不从带圆形遮罩、字幕或其他 UI 的最终成片截取。找不到原始 master 时才使用最终成片，并记录降级。

2. 运行候选帧脚本并用 view_image 查看 contact sheet：

   python3 scripts/extract_avatar_frames.py <avatar-master.mp4> \
     --out-dir <项目>/封面/avatar-reference