// 为剧本场景生成视频片段。当用户说"生成视频"、"把分镜图变成视频"、想重新生成某个场景的视频、或视频生成中断需要续传时使用。支持整集批量、单场景、断点续传等模式。
把已生成的视频片段按剧本顺序拼接为单集成片，可选混入 BGM 与场景间转场。当用户说"拼成片"、"合成本集视频"或"加背景音乐"时使用。
项目管理工具集。使用场景：(1) 分集切分——探测切分点并执行切分，(2) 新增/修改角色/场景/道具到 project.json（经 patch_project 工具，按 table+name upsert 或写顶层 settings 字段）。提供 peek（预览）+ split（执行）的渐进式切分工作流，以及角色/场景/道具与项目级 settings 写入。
无人值守驱动 CodeRabbit、Gemini Code Assist、OpenAI Codex 的 review → 修复 → push → 再 review 循环,直到全部通过或触发收敛退出。主动调用:用户刚 push PR 或跑完 /commit-push-pr;提到 review / coderabbit / gemini / codex / 审查 / AI review / 等 bot 回复;CodeRabbit paused 需 resume;reviewer 有 actionable comments。即使用户只说"PR 怎么样了""review 回了吗"也应触发。
调用项目配置的文本模型生成 JSON 剧本（同时产出每个分镜的 image_prompt 与 video_prompt）。由 create-episode-script subagent 调用。读取 step1 中间文件和 project.json，输出符合 Pydantic schema 的剧本。
为剧本场景生成分镜图。当用户说"生成分镜"、"预览场景画面"、想重新生成某些分镜图、或剧本中有场景缺少分镜图时使用。自动保持角色和画面连续性。
"统一资产生成 skill：接受 `--type=character|scene|prop`，或不传自动扫所有 pending（缺 sheet）资源并按类型分发。当用户说"生成角色图"/"生成场景图"/"生成道具图"、想为新资产创建参考图、或有资产缺少 *_sheet 时使用。"
| name | generate-video |
| description | 为剧本场景生成视频片段。当用户说"生成视频"、"把分镜图变成视频"、想重新生成某个场景的视频、或视频生成中断需要续传时使用。支持整集批量、单场景、断点续传等模式。 |
MCP 工具在读取剧本后检测顶层结构，自动路由到对应 executor：
| 剧本特征 | 路由 | 输出目录 |
|---|---|---|
generation_mode == "reference_video" 或存在 video_units[] | task_type="reference_video" → execute_reference_video_task | reference_videos/{unit_id}.mp4 |
segments[]（narration） | task_type="video" → execute_video_task | videos/scene_{segment_id}.mp4 |
scenes[]（drama） | 同上 | videos/scene_{scene_id}.mp4 |
参考模式跳过分镜图要求，直接把 {script_file} 丢给 executor；executor 自行读取 unit.references → 从 characters/scenes/props 三 bucket 解析 sheet 图 → 内存压缩 → 渲染 prompt → 调 VideoBackend。
为每个场景/片段/unit 创建视频。storyboard/grid 模式用分镜图作为起始帧；reference_video 模式用角色/场景/道具参考图作为 reference_images，跳过分镜环节。
画面比例、时长等规格由项目配置和视频模型能力决定，MCP 工具自动处理。
重要：生成视频必须调用下列 MCP 工具入队。此 skill 不提供任何 Python/Shell 脚本，不得用 BASH 调 python .../scripts/*.py。
通过 MCP 工具入队：
| 操作 | 工具 |
|---|---|
| 整集生成（默认） | mcp__arcreel__generate_video_episode({"script": "episode_1.json"}) |
| 断点续传 | mcp__arcreel__generate_video_episode({"script": "episode_1.json", "resume": true}) |
| 单场景 | mcp__arcreel__generate_video_scene({"script": "episode_1.json", "scene_id": "E1S01"}) |
| 批量自选 | mcp__arcreel__generate_video_selected({"script": "episode_1.json", "scene_ids": ["E1S01", "E1S05", "E1S10"]}) |
| 自选 + 续传 | mcp__arcreel__generate_video_selected({"script": "episode_1.json", "scene_ids": [...], "resume": true}) |
| 全部待处理（独立模式） | mcp__arcreel__generate_video_all({"script": "episode_1.json"}) |
所有任务一次性提交到生成队列，由 Worker 按 per-provider 并发配置自动调度。 集号从 script 顶层
episode或文件名推导，无需手动传。reference_video模式下scene_id/scene_ids会被忽略，转整集生成。
storyboard_imagevideo_clip 路径和场景状态Prompt 由 MCP 工具内部自动构建，根据 content_mode 选择不同策略。从剧本 JSON 读取以下字段：
image_prompt（用于分镜图参考）：scene、composition（shot_type、lighting、ambiance）
video_prompt（用于视频生成）：action、camera_motion、ambiance_audio、dialogue、narration（仅 drama）
novel_text 不参与视频生成（后期人工配音），dialogue 仅包含原文中的角色对话*_sheet 文件存在max_reference_images参考生视频模式下，输出命名为
{unit_id}.mp4，位于reference_videos/目录。