npx claudepluginhub t0ugh/videoclawThis skill uses the workspace's default tool permissions.
> **注意**：如果是首次使用，确保已安装 videoclaw：`uvx videoclaw --help`
Transforms multimodal assets (images, videos, audio) and user intent into optimized JSON prompts with parameters for Seedance 2.0 video generation.
Generates timed storyboard prompts for Seedance 2.0 AI videos from ideas, guiding narrative, visuals, lenses, actions, and multimodal references.
Generates videos from text prompts or images using ByteDance Seedance-1.5-pro model via volcengine-ark Python SDK. Provides CLI for custom parameters, task management, and async polling.
Share bugs, ideas, or general feedback.
注意：如果是首次使用，确保已安装 videoclaw：
uvx videoclaw --help
用户说"做一个xx视频"、"帮我生成一个视频"时触发。
1. 故事大纲（用户描述 → AI 整理）
2. 素材准备（AI 推断需求 → 用户确认 → 素材处理）
3. 文本分镜（Seedance 2.0 格式）
4. i2v 生成视频
用 AskUserQuestion 询问用户：
"请描述你想做的视频想法（如：宇航员在火星上发现外星遗迹）"
- 用户输入想法
使用以下 prompt 生成故事大纲：
你是一个专业的视频策划专家。请根据用户的想法生成一个简化的故事大纲。
用户想法：<用户输入>
请生成以下格式的故事大纲：
【视频主题】一句话概括视频核心内容
【核心剧情】2-3句话描述视频的主要情节
【角色设定】
- 角色1：描述（包括外貌、性格）
- 角色2：描述
（如果没有明确角色，可省略）
【时长】X秒（默认15秒）
【风格偏好】用户指定的风格，如果没有则留空
生成后保存到 <project>/outline.md
用 AskUserQuestion 询问：
"故事大纲如下，满意吗？"
- 满意 → 继续 Step 2
- 调整 → 询问具体要改什么
根据故事大纲推断需要哪些素材：
基于以下故事大纲，分析需要哪些素材：
故事大纲：
<故事大纲内容>
请列出：
【角色素材】
- 需要几个角色？
- 每个角色需要什么类型的图片？
【场景素材】
- 需要什么场景？
- 是否需要背景图？
【参考素材】（可选）
- 是否需要视频参考？（运镜/动作）
- 是否需要音频参考？（配乐/对白）
请用清晰的列表格式回复。
用 AskUserQuestion 询问：
"根据故事大纲，建议准备以下素材：
- 角色：xxx
- 场景：xxx
- 参考视频：可选
- 参考音频：可选
你有这些素材吗？需要补充什么？"
- 确认现有素材
- 添加新素材
- 跳过某些素材
对于每个需要的素材：
角色图（九宫格）： 一个合格的角色素材需要包含以下视角，放在一张九宫格图片中：
角色图生成：
T2I 生成角色九宫格 prompt 示例：
一个九宫格图片，展示一个黄色圆滚滚小怪兽角色设计。
左上格：正面全身照
上中格：3/4侧面全身照
右上格：侧面全身照
左中格：正面表情-微笑
中格：正面表情-严肃
右中格：正面表情-惊讶
左下格：背面全身照
下中格：面部特写
右下格：正面表情-愤怒
风格：卡通形象，无鼻设计，头顶一个小橘子
I2I 生成角色九宫格 prompt 示例：
保持角色特征不变，生成九宫格格式的角色展示图。
包含：正面、侧面、背面、3/4侧面、面部特写、多种表情
场景图：
生成后保存到 <project>/assets/
用 AskUserQuestion 确认：
"素材已准备好，满意吗？"
使用故事类分镜模板生成文本分镜，详见 video-text-storyboard/references/stories.md：
基于以下故事大纲和素材，使用故事类分镜模板生成文本分镜。
故事大纲：
<故事大纲内容>
素材：
- 角色图：<路径>
- 场景图：<路径>
- 参考视频：<路径>（如有）
- 参考音频：<路径>（如有）
请使用以下格式：
【素材介绍】：
【@图1】<角色/物体描述>
【@图2】<角色/物体描述>
【场景描写】：
<整体背景描述>
【背景音】：
<背景音描述>
【分镜】：
【镜头标题】（X-Y秒）
画面：<包含动作、台词、情绪的完整描述>
音效：<此镜头的音效>
【注意事项】：
- 角色设定：<关键角色特征>
- 氛围：<整体氛围要求>
- 动作节奏：<节奏要求>
- 细节还原：<关键细节>
生成后保存到 <project>/storyboard/text_storyboard.md
用 AskUserQuestion 确认：
"文本分镜如下，满意吗？"
- 满意 → 继续 Step 4
- 调整 → 询问具体要改什么
执行 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秒内塞入太多场景
✅ 精简内容：一个镜头只安排一个简单动作
❌ 忽视音效：音效设计能大幅提升质量
✅ 加入音效：背景音乐 + 音效
❌ 缺少注意事项：结尾没有强调关键要素
✅ 添加注意事项：角色设定、氛围、动作节奏、细节还原