iwanalq 短剧视频全流程
定位
本 skill 是短剧 / 剧情视频生成的主规划入口，负责按固定流程路由任务：
planner -> scriptwriter -> storyboard -> assets -> frame -> prompt
planner 就是当前主 SKILL.md。其它阶段按需读取 refs：
| 阶段 | 读取文件 |
|---|---|
| scriptwriter | references/scriptwriter.md |
| storyboard | references/storyboard.md |
| assets | references/assets.md |
| frame | references/frame.md |
| prompt | references/prompt.md |
不得跳阶段。只要发现上游依赖缺失，就停在最早缺失阶段继续处理。
核心规则
- 当用户要求生成视频时，不要立即开始生成，也不要立即调用视频生成工具，必须先澄清并确认以下基础参数：
- 时长：视频长度，例如 5s、10s、15秒。
- 当用户调用image_video且task_type=r2v，比例支持：'16:9','4:3','1:1','3:4','9:16','21:9'
- 当用户调用image_video且task_type=f2v，比例仅支持保持原比例，如果用户要求调整，必须跟用户说明。
- 生成详细内容：画面主体、动作、场景、风格、镜头运动、情绪氛围、文字、声音或其他限制。
- 一次最多生成2个视频，超出必须对用户进行澄清：一次仅能生成两个视频。
- 即时输出原则：在资产设定（如角色设定图、场景图等）和视频生成阶段，每生成完一张图或一个视频，必须立即将其展示并返回给用户。绝对禁止等待所有图片或所有视频全部生成完毕后再统一打包返回。
- 图片质量审查原则：在完成任何一个阶段的图片生成之后，都应检查图片是否存在问题：
- 人设图审查：重点审查左侧面部特写是否是正脸，三视图是否与左侧面部特征保持一致，三视角是否是同一个人物。
- 关键帧审查：重点审查画面是否和对应剧情对的上，人物、场景、道具是否和资产设定图中的对应特征对的上。
- 角色形象变化资产更新原则：随着剧情进展，如果人物形象发生较大变化（如换装、发型变化、受伤/毁容、年龄阶段变化、身份伪装、盔甲/制服/礼服等关键造型变化），必须先重新生成对应阶段的角色资产设定图，并经用户确认后，才能继续生成后续关键帧或视频。禁止沿用旧资产图硬套新造型。
- 只有在用户明确确认参数后，才可以继续生成。无论用户是否已经一次性提供完整参数，都必须先输出一次参数摘要并等待确认；不能因为信息看似完整就直接进入生成。明确确认可以是 确认、可以生成、开始生成、没问题、yes、looks good、ok等表达。
澄清门禁
在剧情设计、剧本设定和视频生成开始前，必须澄清会显著影响结果的关键参数。每轮只问 1-3 个问题。用户说“你来定”“随便”“直接做”等表达时，可以内部选择合理默认值并继续推进非生成阶段。
真正生成视频前，必须确认以下基础参数：
- 时长：例如 5s、10s、15s，或每个片段的目标时长。
- 比例：例如
16:9、4:3、1:1、3:4、9:16、21:9。 - 生成模式：文生视频、图生视频、参考视频生成、首帧驱动视频，或工具侧的
r2v/f2v等模式。 - 画面详细内容：主体、动作、场景、风格、镜头运动、情绪氛围、可见文字、台词、声音和限制。
- 生成数量：单批最多 2 个视频，超出必须对用户进行澄清，一次仅能生成两个视频。
- 确认表达：只有用户明确回复“确认”“可以生成”“开始生成”“没问题”“yes”“looks good”等，才可以继续生成。
分阶段澄清
| 阶段 | 需要澄清 |
|---|---|
| planner | 目标、产物形式、受众、全流程范围、已有素材、希望从哪个阶段开始。 |
| scriptwriter | 故事主题、题材、目标时长或集数、主角、核心冲突、结局方向、情绪基调、禁用内容。剧情设计和剧本设定缺关键参数时必须先澄清。 |
| storyboard | 要处理的集数、单集时长、片段结构、镜头密度、台词/字幕/声音要求。 |
| assets | 角色、场景、道具、视觉风格、参考图用途、一致性锚点、音色或台词锚点。 |
| frame | 哪一集/哪些片段、首尾关键帧要求、场景引用、角色引用、构图、光影、角色物理状态连续性。 |
| prompt | 工具模式、时长、比例、首帧、参考资产、时间戳动作规划、台词/声音、负向约束、批次数量。 |
如果某个缺失值只影响最终生成、不影响规划，可以继续规划，并把它标为生成前确认点。
阶段判断
按顺序检查，并停在第一个缺失依赖：
- 只有 idea、标题、简短梗概、不完整故事或松散角色概念时，开始剧本创作。
- 有完整故事但没有按集/片段/镜头切分时，开始分镜切分。
- 有分镜但没有可用角色、场景、道具资产引用或详细视觉基准时，开始资产设定。
- 有资产和分镜但没有片段关键帧图时，开始关键帧生成。
- 有关键帧但没有最终视频提示词执行包时，开始视频提示词生成并生成对应视频。
规划输出
启动或接续项目时，先输出简短规划报告，再读取下一阶段 ref：
## 短剧生产规划报告
### 项目信息
- 项目名称：
- 类型：
- 风格：
- 默认比例：
- 默认时长：
### 当前完成度检查
| 阶段 | 要求 | 是否完成 | 缺失内容 |
|---|---|---|---|
| 1. 剧本创作 | 完整故事梗概、角色、人设、关键场景 | 是/否 | |
| 2. 分镜切分 | 每集/片段/镜头规划 | 是/否 | |
| 3. 资产设定 | 角色、场景、道具资产与参考图 | 是/否 | |
| 4. 关键帧 | 片段首尾关键帧图 | 是/否 | |
| 5. 视频提示词 | 可执行视频 prompt 与生成参数 | 是/否 | |
### 执行规划
当前阶段：
后续流程：
需要确认：
路由
- 当前阶段是剧本创作时，读取
references/scriptwriter.md。 - 当前阶段是分镜切分时，读取
references/storyboard.md。 - 当前阶段是资产设定时，读取
references/assets.md。 - 当前阶段是关键帧生成时，读取
references/frame.md。 - 当前阶段是最终视频生成时，读取
references/prompt.md。
每阶段完成后都必须用户确认： 在剧本、分镜、资产、关键帧的任何一个阶段完成输出后，必须停下来，并明确询问用户是否满意、是否需要修改。绝对禁止在没有获得用户明确的“确认/没问题/继续/yes/ok”等许可下，擅自读取下一个 Reference 文件并自动推进到下一阶段。
工具门禁
以宿主环境实际可用工具为准。旧版工具名按下表理解：
| 旧工具名 | 当前含义 |
|---|---|
text_to_image |
文生图 |
image_to_image |
基于参考图的图像编辑 / 图像生成 |
image_to_video |
基于图片参考的视频生成 |
工具调用失败处理：
当阶段规则要求使用 image_to_image / I2I 或 image_to_video / I2V 时，如果实际调用失败，必须优先重新尝试调用对应工具，仍失败再停下来说明失败原因与所需补充信息。禁止为了绕过失败而擅自降级改用 text_to_image / T2I 或纯 text_to_video / T2V，这会丢失参考图约束并破坏角色、场景、道具一致性。
完成检查
声明完成前必须确认：
- 没有跳过上游阶段。
- 视频生成前已完成必要澄清并获得明确确认。
- 比例、时长、模式、数量、参考素材和限制已记录。
- 角色、场景、道具和关键帧连续性已保持。
- 剧情导致人物形象明显变化时，已补充并确认新的角色资产设定图。
- 应使用 I2I / I2V 的任务没有因工具调用失败而降级为 T2I / T2V；如失败，已重试对应工具或明确说明失败原因。
- 单批生成视频数量不超过 2 个。
- 资产和视频的输出必须遵循“即时输出”原则，生成一个返回一个，不得囤积。
- 所有视频生成结果，无论
text_to_video/image_to_video、UGC / marketing / corporate，交付前都必须调用notify_hunman整理输出并展示视频；不得以“非飞书内容”“在线 URL 可直接回复”“链接可展示”“Markdown/HTML video 标签可播放”“用户偏好直接交付”等理由跳过。 notify_hunman入参必须包含可渲染的视频资源本体：video_url/output_url/url/result_url或本地视频路径；不得只传总结文案、HTML/Markdown<video>片段或裸链接文本。- 只有确认
notify_hunman已正常上屏视频后，才可以输出视频已生成或成功格式；如未正常上屏，必须用同一视频资源重试一次，仍失败再说明展示失败并保留链接/路径排查。