| name | video-quick-create |
| description | 快速创建视频，全面拥抱 Seedance 2.0。一步完成：故事大纲 → 素材准备 → 文本分镜 → i2v 生成视频。 |
video-quick-create
注意：如果是首次使用，确保已安装 videoclaw：uvx videoclaw --help
触发场景
用户说"做一个xx视频"、"帮我生成一个视频"时触发。
流程概览
1. 故事大纲（用户描述 → AI 整理）
2. 素材准备（AI 推断需求 → 用户确认 → 素材处理）
3. 文本分镜（Seedance 2.0 格式）
4. i2v 生成视频
详细流程
Step 1: 故事大纲
用 AskUserQuestion 询问用户：
"请描述你想做的视频想法（如：宇航员在火星上发现外星遗迹）"
使用以下 prompt 生成故事大纲：
你是一个专业的视频策划专家。请根据用户的想法生成一个简化的故事大纲。
用户想法：<用户输入>
请生成以下格式的故事大纲：
【视频主题】一句话概括视频核心内容
【核心剧情】2-3句话描述视频的主要情节
【角色设定】
- 角色1：描述（包括外貌、性格）
- 角色2：描述
（如果没有明确角色，可省略）
【时长】X秒（默认15秒）
【风格偏好】用户指定的风格，如果没有则留空
生成后保存到 <project>/outline.md
用 AskUserQuestion 询问：
"故事大纲如下，满意吗？"
- 满意 → 继续 Step 2
- 调整 → 询问具体要改什么
Step 2: 素材准备
2.1 推断素材需求
根据故事大纲推断需要哪些素材：
基于以下故事大纲，分析需要哪些素材：
故事大纲：
<故事大纲内容>
请列出：
【角色素材】
- 需要几个角色？
- 每个角色需要什么类型的图片？
【场景素材】
- 需要什么场景？
- 是否需要背景图？
【参考素材】（可选）
- 是否需要视频参考？（运镜/动作）
- 是否需要音频参考？（配乐/对白）
请用清晰的列表格式回复。
2.2 用户确认素材
用 AskUserQuestion 询问：
"根据故事大纲，建议准备以下素材：
- 角色：xxx
- 场景：xxx
- 参考视频：可选
- 参考音频：可选
你有这些素材吗？需要补充什么？"
2.3 素材处理
对于每个需要的素材：
角色图（九宫格）：
一个合格的角色素材需要包含以下视角，放在一张九宫格图片中：
- 正面、侧面、背面、3/4侧面
- 面部特写
- 多种表情特写
- 如有武器：武器的多个视图
- 如有配饰（帽子等）：脱帽状态图片 + 配饰单独图片
角色图生成：
- 用户提供 → 跳过生成
- 无参考图 → T2I 模式生成（使用 video-t2i skill）
- 有参考图 → I2I 模式生成（使用 video-i2i skill）
T2I 生成角色九宫格 prompt 示例：
一个九宫格图片，展示一个黄色圆滚滚小怪兽角色设计。
左上格：正面全身照
上中格：3/4侧面全身照
右上格：侧面全身照
左中格：正面表情-微笑
中格：正面表情-严肃
右中格：正面表情-惊讶
左下格：背面全身照
下中格：面部特写
右下格：正面表情-愤怒
风格：卡通形象，无鼻设计，头顶一个小橘子
I2I 生成角色九宫格 prompt 示例：
保持角色特征不变，生成九宫格格式的角色展示图。
包含：正面、侧面、背面、3/4侧面、面部特写、多种表情
场景图：
- 用户提供 → 跳过
- 需要生成 → T2I 模式生成（使用 video-t2i skill）
生成后保存到 <project>/assets/
用 AskUserQuestion 确认：
"素材已准备好，满意吗？"
Step 3: 文本分镜
使用故事类分镜模板生成文本分镜，详见 video-text-storyboard/references/stories.md：
基于以下故事大纲和素材，使用故事类分镜模板生成文本分镜。
故事大纲：
<故事大纲内容>
素材：
- 角色图：<路径>
- 场景图：<路径>
- 参考视频：<路径>（如有）
- 参考音频：<路径>（如有）
请使用以下格式：
【素材介绍】：
【@图1】<角色/物体描述>
【@图2】<角色/物体描述>
【场景描写】：
<整体背景描述>
【背景音】：
<背景音描述>
【分镜】：
【镜头标题】（X-Y秒）
画面：<包含动作、台词、情绪的完整描述>
音效：<此镜头的音效>
【注意事项】：
- 角色设定：<关键角色特征>
- 氛围：<整体氛围要求>
- 动作节奏：<节奏要求>
- 细节还原：<关键细节>
生成后保存到 <project>/videos/<video>/storyboard/text_storyboard.md
用 AskUserQuestion 确认：
"文本分镜如下，满意吗？"
- 满意 → 继续 Step 4
- 调整 → 询问具体要改什么
Step 4: i2v 生成视频
执行 i2v 命令：
videoclaw i2v -p <project> \
-i <角色图> \
-i <场景图> \
--video-ref <参考视频> \
--audio-ref <参考音频> \
-t "<文本分镜内容>"
生成后用 AskUserQuestion 询问：
"视频已生成，满意吗？"
- 满意 → 结束
- 重新生成 → 重试
- 调整 → 修改后重试
分镜格式参考
详见 video-text-storyboard/references/stories.md
【素材介绍】：
【@图1】黄色圆滚滚小怪兽，无鼻设计，头顶小橘子
【@图2】冰封圣剑，剑身蓝光流转
【@图3】冰之王冠，由冰晶碎片拼接而成
【@图4】冰封王座，台阶和座椅有冰晶纹路
【@图5】极寒冰封王座大殿场景，浮空冰峰刺破阴云
【场景描写】：
极寒冰封之地，浮空冰峰刺破阴云，寒风呼啸，冰封大殿寂静威严
【背景音】：
史诗感 夹杂冰面细微碎裂声
【分镜】：
【特写圣剑】（0-4秒）
画面：特写【@图2】冰封圣剑，剑身蓝光流转，插在寒冰基座上
音效：冰裂声、低沉嗡鸣
【拔剑】（4-8秒）
画面：镜头后拉。【@图1】黄色小怪兽肉垫爪子紧紧握住【@图2】剑柄，用力向上拔剑
音效：拔剑声、冰裂声
【冰甲覆身】（8-12秒）
画面：全身镜头。【@图1】小怪兽拔出圣剑瞬间，无数冰晶碎片从四面八方飞聚而来，瞬间拼接成完整冰甲覆盖全身
音效：剑鸣、冰晶碰撞声
【戴上王冠】（12-16秒）
画面：【@图1】小怪兽抬手，冰晶拼成【@图3】王冠；将王冠戴在头上
音效：冰晶拼接声
【登基定格】（16-20秒）
画面：全景。【@图1】小怪兽手持【@图2】圣剑站在【@图4】王座上，双眼亮起冰蓝光芒，远处【@图5】冰峰堡垒矗立
音效：余音回荡
【注意事项】：
- 角色设定：黄色小怪兽严格保持无鼻设计，头顶小橘子
- 氛围：全程冷色调，突出寒冰、冰晶质感
- 动作节奏：每个镜头一个简单动作，拔剑 → 冰甲覆身 → 戴王冠 → 登基
常见错误
❌ 素材引用混乱：不说明引用了什么
✅ 使用【@图1】【@图2】格式明确引用素材
❌ 内容过载：4-5秒内塞入太多场景
✅ 精简内容：一个镜头只安排一个简单动作
❌ 忽视音效：音效设计能大幅提升质量
✅ 加入音效：背景音乐 + 音效
❌ 缺少注意事项：结尾没有强调关键要素
✅ 添加注意事项：角色设定、氛围、动作节奏、细节还原
