generate-storyboard

# 生成分镜图 通过生成队列创建分镜图，画面比例根据 content_mode 自动设置。 > 内容模式规格详见 `.claude/references/content-modes.md`。 ## 命令行用法 ```bash # 提交所有缺失分镜图到生成队列（自动检测 content_mode） python .claude/skills/generate-storyboard/scripts/generate_storyboard.py script.json # 为单个场景重新生成 python .claude/skills/generate-storyboard/scripts/generate_storyboard.py script.json --scene E1S05 # 为多个场景重新生成 python .claude/skills/generate-storyboard/scripts/generate_storyboard.py script.json --scene-ids E1S01 E1S02 ``` > `--scene-ids` 和 `--segment-ids` 是同义别名（后者为 narration 模式的习惯称呼），效果相同。以下统一使用 `--scene-ids`。 > **选择规则**：`--scene` 重生成一个；`--scene-ids` 重生成多个；未提供则提交所有缺失项。 > **注意**：脚本要求 generation worker 在线，worker 负责实际图像生成与速率控制。 ## 工作流程 1. **加载项目和剧本** — 确认所有角色都有 `character_sheet` 图像 2. **生成分镜图** — 脚本自动检测 content_mode，按相邻关系串联依赖任务 3. **审核检查点** — 展示每张分镜图，用户可批准或要求重新生成 4. **更新剧本** — 更新 `storyboard_image` 路径和场景状态 ## 角色一致性机制 脚本自动处理以下参考图传入，无需手动指定： - **character_sheet**：场景中出场角色的设计图，保持外貌一致 - **clue_sheet**：场景中出现的线索设计图 - **上一张分镜图**：相邻片段默认引用，提升画面连续性 - 当片段标记 `segment_break=true` 时，跳过上一张分镜图参考 ## Prompt 模板 脚本从剧本 JSON 读取以下字段构建 prompt： ``` 场景 [scene_id/segment_id] 的分镜图： - 画面描述：[visual.description] - 镜头构图：[visual.shot_type] - 镜头运动起点：[visual.camera_movement] - 光线条件：[visual.lighting] - 画面氛围：[visual.mood] - 角色：[characters_in_scene] - 动作：[action] 风格要求：电影分镜图风格，根据项目 style 设定。 角色必须与提供的角色参考图完全一致。 ``` > 画面比例通过 API 参数设置，不写入 prompt。 ## 生成前检查 - [ ] 所有角色都有已批准的 character_sheet 图像 - [ ] 场景视觉描述完整 - [ ] 角色动作已指定 ## 错误处理 - 单场景失败不影响批次，记录失败场景后继续 - 生成结束...