name: generate-video
description: “自动生成产品演示视频。体现百闻不如一见。当用户提到’/generate-video’、视频生成、产品演示或视觉文档时使用。不要用于:嵌入视频播放器、实时演示、视频播放功能。需要Remotion设置。”
description-en: “自动生成产品演示视频。一幅图胜过千言万语,得以体现。当用户提到’/generate-video’、视频生成、产品演示或视觉文档时使用。不要用于:嵌入视频播放器、实时演示、视频播放功能。需要Remotion设置。”
description-ja: “自动生成产品演示视频。体现百闻不如一见。当用户提到’/generate-video’、视频生成、产品演示或视觉文档时使用。不要用于:嵌入视频播放器、实时演示、视频播放功能。需要Remotion设置。”
allowed-tools: [“读取”, “写入”, “编辑”, “Grep”, “Glob”, “Bash”, “任务”, “询问用户问题”, “网页获取”]
disable-model-invocation: true
argument-hint: “[演示|架构|发布]”
context: fork
生成视频技能
负责自动生成产品说明视频的技能群。
概要
在/generate-video命令内部使用的技能。
执行代码库分析 → 场景提案 → 并行生成的流程。
功能详细
先决条件
- Remotion 已设置(
/remotion-setup)
- Node.js 18+
- (可选)
GOOGLE_AI_API_KEY - 用于AI图像生成
/generate-video 流程
/generate-video
│
├─[步骤 1] 分析(analyzer.md)
│ ├─ 框架检测
│ ├─ 主要功能检测
│ ├─ UI组件检测
│ └─ 项目资产分析(Plans.md, CHANGELOG等)
│
├─[步骤 2] 场景提案(planner.md)
│ ├─ 视频类型自动判定
│ ├─ 场景构成提案
│ └─ 用户确认
│
├─[步骤 2.5] 素材生成(image-generator.md)← 新
│ ├─ 素材必要性判定(介绍、行动号召等)
│ ├─ 使用Nano Banana Pro生成2张图像
│ ├─ Claude进行质量判定(image-quality-check.md)
│ └─ 通过 → 采用 / 不通过 → 重新生成(最多3次)
│
└─[步骤 3] 并行生成(generator.md)
├─ 场景并行生成(任务工具)
├─ 整合 + 过渡
└─ 最终渲染
执行步骤
- 用户执行
/generate-video
- 确认Remotion设置
- 使用
analyzer.md进行代码库分析
- 使用
planner.md进行场景提案 + 用户确认
- 使用
generator.md进行并行生成
- 完成报告
视频类型(按漏斗)
| 类型 |
漏斗 |
长度参考 |
自动判定条件 |
构成核心 |
| LP/广告预告 |
认知~兴趣 |
30-90秒 |
新项目 |
痛点→结果→行动号召 |
| 介绍演示 |
兴趣→考虑 |
2-3分钟 |
UI变更检测 |
1个用例完成 |
| 发布说明 |
考虑→确信 |
1-3分钟 |
CHANGELOG更新 |
前后对比重视 |
| 架构讲解 |
确信→决策 |
5-30分钟 |
大规模结构变更 |
实际运用+证据 |
| 入门指导 |
持续・活用 |
30秒-数分钟 |
首次设置 |
通往Aha体验的最短路径 |
详细: references/best-practices.md
场景模板
90秒预告(LP/广告向)
| 时间 |
场景 |
内容 |
| 0-5秒 |
钩子 |
痛点或期望结果 |
| 5-15秒 |
问题+承诺 |
目标用户和承诺 |
| 15-55秒 |
工作流程 |
象征性工作流程 |
| 55-70秒 |
差异化 |
差异化依据 |
| 70-90秒 |
行动号召 |
下一步行动 |
3分钟介绍演示(考虑向)
| 时间 |
场景 |
内容 |
| 0-10秒 |
钩子 |
结论+痛点 |
| 10-30秒 |
用例 |
用例声明 |
| 30-140秒 |
演示 |
实际屏幕完成 |
| 140-170秒 |
异议处理 |
解决一个常见不安 |
| 170-180秒 |
行动号召 |
行动唤起 |
共同场景
| 场景 |
推荐时间 |
内容 |
| 介绍 |
3-5秒 |
标志 + 标语 |
| 功能演示 |
10-30秒 |
Playwright捕获 |
| 架构图 |
10-20秒 |
Mermaid → 动画 |
| 行动号召 |
3-5秒 |
URL + 联系方式 |
详细模板: references/best-practices.md
语音同步规则(重要)
有旁白的视频中严格遵守以下规则:
| 规则 |
值 |
| 语音开始 |
场景开始 + 30帧(等待1秒) |
| 场景长度 |
30帧 + 语音长度 + 20帧余量 |
| 过渡 |
15帧(与相邻场景重叠) |
| 场景开始计算 |
前场景开始 + 前场景长度 - 15帧 |
事先确认:使用ffprobe确认语音长度后再设计场景
详细: references/generator.md
BGM 支持
| 项目 |
推荐值 |
| 有旁白 |
bgmVolume: 0.20 - 0.30 |
| 无旁白 |
bgmVolume: 0.50 - 0.80 |
| 文件配置 |
public/BGM/ |
详细: references/generator.md
字幕支持
| 规则 |
值 |
| 字幕开始 |
与语音开始相同 |
| 字幕时长 |
语音长度 + 10帧 |
| 字体 |
推荐Base64嵌入 |
详细: references/generator.md
视觉效果库
用于冲击力视频的效果集:
| 效果 |
用途 |
| GlitchText |
钩子、标题 |
| Particles |
背景、行动号召收敛 |
| ScanLine |
解析中演出 |
| ProgressBar |
并行处理显示 |
| 3D Parallax |
卡片显示 |
详细: references/visual-effects.md
注意事项
- Remotion未设置时建议使用
/remotion-setup
- 并行生成数根据场景数自动调整(最大5)
- 生成的视频输出到
out/目录
- AI生成图像保存在
out/assets/generated/
GOOGLE_AI_API_KEY未设置时跳过图像生成(使用现有素材或占位符)