用途：为视频生成前的剧本场景创建分镜图，可在视频生成前预览画面。使用 Gemini 3 Pro Image API。
主要能力：支持说书（narration）与剧集动画（drama）两种内容模式，自动检测并选择流程。说书模式直接生成单独场景图，9:16 竖屏，使用 character_sheet 和 clue_sheet 作参考保持人物一致，保存为 storyboards/scene_{segment_id}.png，不使用 storyboard_grid 字段。剧集动画模式为两步：先按每批 4-6 个场景生成多宫格预览（1-4 个场景用 2x2，5-6 个用 2x3，始终 16:9，保存为 grid_{batch_id:03d}.png），再以多宫格和人物设计图为参考生成单独场景图（16:9），保存为 scene_{scene_id}.png，两者均更新剧本对应字段。
用法：说书模式运行 python .claude/skills/generate-storyboard/scripts/generate_storyboard.py my_project script.json，可用 --segment-ids 指定片段。剧集动画模式先执行 --grids --all 生成多宫格，再执行 --scenes 生成单独场景图；narration 模式下 --grids/--scenes 会被忽略。画面比例通过 API 参数设置，不写入 prompt。
限制与说明：脚本内置滑动窗口限流器，速率限制可通过环境变量配置，超限自动等待，并有最多 5 次的指数退避重试。生成前需确认所有人物均有已批准的 character_sheet 图像、场景视觉描述完整、人物动作已指定。单场景失败不影响批次，结束汇总失败原因，支持增量跳过已存在图，可用 --scenes --scene-ids 重试。剧集动画模式有审核检查点，需用户批准或重新生成。具体价格与配额资料暂未提供。