$npx -y skills add T0UGH/videoclaw --skill video-text-storyboard使用 AI 生成结构化文本分镜,作为视频生成的输入。用于用户需要一个视频的文本描述(分镜)的场景。用户说"帮我生成一个分镜"、"帮我写视频脚本"时触发。
| 1 | # video-text-storyboard |
| 2 | |
| 3 | > **注意**:如果是首次使用,确保已安装 videoclaw:`uvx videoclaw --help` |
| 4 | |
| 5 | ## 触发场景 |
| 6 | |
| 7 | 用户说以下话时触发: |
| 8 | - "帮我生成一个分镜" |
| 9 | - "帮我写视频脚本" |
| 10 | - "帮我设计一下这个视频怎么拍" |
| 11 | - "帮我做一个视频方案" |
| 12 | |
| 13 | ## 输入 |
| 14 | |
| 15 | 通过 AskUserQuestion 依次追问获取: |
| 16 | |
| 17 | 1. **视频类型**(第一个问,多选一) |
| 18 | - 故事类(情感短片、微电影) |
| 19 | - 产品展示类(品牌广告、电商视频) |
| 20 | - 角色动作类(武侠、舞蹈、格斗) |
| 21 | - 风景旅拍类(自然风光、城市街拍) |
| 22 | |
| 23 | 2. **视频主题**:"这个视频想讲什么 / 展示什么?" |
| 24 | |
| 25 | 3. **素材来源**(二选一) |
| 26 | - 我有图片,直接上传 |
| 27 | - 帮我用 AI 生成素材图(→ 先调用 t2i 生成素材图,再进入分镜生成) |
| 28 | |
| 29 | 4. **类型专属追问**(根据步骤1的结果分支) |
| 30 | |
| 31 | | 类型 | 追问内容 | |
| 32 | |------|---------| |
| 33 | | 故事类 | 角色外观描述 / 风格(搞笑/温馨/史诗感) | |
| 34 | | 产品展示类 | 产品名称和外观描述 / 品牌调性(高端/科技感/轻快时尚) | |
| 35 | | 角色动作类 | 角色外观描述 / 动作类型(武侠/舞蹈/格斗/特技) | |
| 36 | | 风景旅拍类 | 拍摄地点/场景描述 / 氛围(治愈系/史诗感/纪录片风格) | |
| 37 | |
| 38 | 5. **时长**:"视频需要多长?15秒 / 30秒" |
| 39 | |
| 40 | ## 生成要点 |
| 41 | |
| 42 | 加载 skill 后,利用上下文生成文本分镜。 |
| 43 | |
| 44 | ### 模板选择 |
| 45 | |
| 46 | 根据用户选择的视频类型,加载对应 references 文件: |
| 47 | |
| 48 | - **故事类** → [references/stories.md](references/stories.md) |
| 49 | - **产品展示类** → [references/product.md](references/product.md) |
| 50 | - **角色动作类** → [references/action.md](references/action.md) |
| 51 | - **风景旅拍类** → [references/scenic.md](references/scenic.md) |
| 52 | |
| 53 | 加载对应文件后,使用其中的模板结构和示例生成分镜。 |
| 54 | |
| 55 | ### 分镜生成要点 |
| 56 | |
| 57 | 每个分镜包含: |
| 58 | - **时间范围**:精确的秒数(如 2-6秒) |
| 59 | - **画面**:场景 + 动作 + 台词 + 情绪,融合在一个字段中 |
| 60 | - **音效**:此镜头的背景音效 |
| 61 | |
| 62 | ### 合格示例 |
| 63 | |
| 64 | **输入**:做一个冰霜王登基的动画视频 |
| 65 | |
| 66 | **输出**: |
| 67 | |
| 68 | ``` |
| 69 | 【素材介绍】: |
| 70 | 【@图1】黄色圆滚滚小怪兽,无鼻设计,头顶小橘子 |
| 71 | 【@图2】冰封圣剑,剑身蓝光流转 |
| 72 | 【@图3】冰之王冠,由冰晶碎片拼接而成 |
| 73 | 【@图4】冰封王座,台阶和座椅有冰晶纹路 |
| 74 | 【@图5】极寒冰封王座大殿场景,浮空冰峰刺破阴云 |
| 75 | |
| 76 | 【场景描写】: |
| 77 | 极寒冰封之地,浮空冰峰刺破阴云,寒风呼啸,冰封大殿寂静威严 |
| 78 | |
| 79 | 【背景音】: |
| 80 | 史诗感 夹杂冰面细微碎裂声 |
| 81 | |
| 82 | 【分镜】: |
| 83 | 【特写圣剑】(0-4秒) |
| 84 | 画面:特写【@图2】冰封圣剑,剑身蓝光流转,插在寒冰基座上 |
| 85 | 音效:冰裂声、低沉嗡鸣 |
| 86 | |
| 87 | 【拔剑】(4-8秒) |
| 88 | 画面:镜头后拉。【@图1】黄色小怪兽肉垫爪子紧紧握住【@图2】剑柄,用力向上拔剑 |
| 89 | 音效:拔剑声、冰裂声 |
| 90 | |
| 91 | 【冰甲覆身】(8-12秒) |
| 92 | 画面:全身镜头。【@图1】小怪兽用力拔出圣剑瞬间,无数冰晶碎片从四面八方飞聚而来,瞬间拼接成完整冰甲覆盖全身 |
| 93 | 音效:剑鸣、冰晶碰撞声 |
| 94 | |
| 95 | 【戴上王冠】(12-16秒) |
| 96 | 画面:【@图1】小怪兽抬手,无数冰晶冰片从空中飞聚而来,拼成【@图3】冰之王冠;小怪兽将王冠戴在头上 |
| 97 | 音效:冰晶拼接声 |
| 98 | |
| 99 | 【登基定格】(16-20秒) |
| 100 | 画面:全景。【@图1】小怪兽(穿戴冰甲)手持【@图2】圣剑,站在【@图4】冰封王座上,双眼亮起冰蓝光芒,远处【@图5】冰峰堡垒在背景中矗立 |
| 101 | 音效:余音回荡 |
| 102 | |
| 103 | 【注意事项】: |
| 104 | - 角色设定:黄色小怪兽严格保持无鼻设计,头顶小橘子 |
| 105 | - 氛围:全程冷色调,突出寒冰、冰晶质感,与角色暖黄色形成强烈视觉对比 |
| 106 | - 动作节奏:每个镜头一个简单动作,拔剑 → 冰甲覆身 → 戴王冠 → 登基 |
| 107 | - 细节还原:头顶小橘子、冰封圣剑蓝光、王冠冰晶拼接纹路等关键细节必须清晰呈现 |
| 108 | ``` |
| 109 | |
| 110 | ## 保存 |
| 111 | |
| 112 | 生成后保存到 `<project>/videos/<video>/storyboard/text_storyboard.md` |
| 113 | |
| 114 | ## 交互确认 |
| 115 | |
| 116 | 用 AskUserQuestion 询问用户: |
| 117 | > "这是生成的分镜,满意吗?" |
| 118 | |
| 119 | 选项: |
| 120 | - 满意 → 继续下一步 |
| 121 | - 修改 → 询问具体哪里要改 |
| 122 | - 重新生成 → 不修改直接重试 |
| 123 | |
| 124 | ## 常见错误 |
| 125 | |
| 126 | ❌ 每个镜头安排太多内容:视频生成模型4秒绝对执行不了这么多东西,一个镜头只安排一个简单动作 |
| 127 | |
| 128 | ✅ 每个镜头内容要精简,只描述一个动作或变化 |
| 129 | |
| 130 | --- |
| 131 | |
| 132 | ❌ 素材引用混乱:不说明引用了什么 |
| 133 | |
| 134 | ✅ 使用【@图1】【图2】格式明确引用素材 |
| 135 | |
| 136 | --- |
| 137 | |
| 138 | ❌ 忽视音效:音效设计能大幅提升质量 |
| 139 | |
| 140 | ✅ 加入音效:背景音乐 + 音效 |
| 141 | |
| 142 | --- |
| 143 | |
| 144 | ❌ 缺少注意事项:结尾没有强调关键要素 |
| 145 | |
| 146 | ✅ 添加注意事项:角色设定、氛围、动作节奏、细节还原 |
| 147 | |
| 148 | ❌ 镜头数量太少:1-2个镜头无法展现完整故事 |
| 149 | |
| 150 | ✅ 多用镜头没问题,每个镜头内容细化,但总量控制在30秒左右(6-8个镜头) |
| 151 | |
| 152 | --- |
| 153 | |
| 154 | ❌ 段落之间有多余空行:每个段落、镜头之间不需要空行 |
| 155 | |
| 156 | ✅ 全部连续书写,不要有空行 |
| 157 | |
| 158 | **反例**: |
| 159 | ``` |
| 160 | 剧情梗概 |
| 161 | |
| 162 | 大法师安东尼达噜想要在小镇广场展示法术。 |
| 163 | |
| 164 | 镜头1 |
| 165 | 阳光明媚的小镇广场... |
| 166 | ``` |
| 167 | |
| 168 | **正例**: |
| 169 | ``` |
| 170 | 剧情梗概 |
| 171 | 大法师安东尼达噜想要在小镇广场展示法术。 |
| 172 | 镜头1 |
| 173 | 阳光明媚的小镇广场... |
| 174 | ``` |