name: generate-video
description: “自动生成产品演示视频。百闻不如一见，体现于此。当用户提到’/generate-video’、视频生成、产品演示或视觉文档时使用。不要用于：嵌入视频播放器、实时演示、视频播放功能。需要Remotion设置。”
description-en: “自动生成产品演示视频。百闻不如一见，体现于此。当用户提到’/generate-video’、视频生成、产品演示或视觉文档时使用。不要用于：嵌入视频播放器、实时演示、视频播放功能。需要Remotion设置。”
description-ja: “自动生成产品演示视频。百闻不如一见，体现于此。当用户提到’/generate-video’、视频生成、产品演示或视觉文档时使用。不要用于：嵌入视频播放器、实时演示、视频播放功能。需要Remotion设置。”
allowed-tools: [“Read”, “Write”, “Edit”, “Grep”, “Glob”, “Bash”, “Task”, “AskUserQuestion”, “WebFetch”]
disable-model-invocation: true
argument-hint: “[demo|arch|release]”
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）← 新增
│ ├─ 素材必要判定（引言、CTA等）
│ ├─ Nano Banana Pro 生成2张
│ ├─ Claude 质量判定（image-quality-check.md）
│ └─ OK → 采用 / NG → 重新生成（最大3次）
│
└─[步骤 3] 并行生成（generator.md）
├─ 场景并行生成（Task工具）
├─ 整合 + 转场
└─ 最终渲染
执行步骤
- 用户执行
/generate-video
- 确认Remotion设置
analyzer.md 进行代码库分析planner.md 进行场景提案 + 用户确认generator.md 进行并行生成- 完成报告
视频类型（漏斗别）
| 类型 |
漏斗 |
长度目标 |
自动判定条件 |
构成核心 |
| LP/广告预告 |
认知～兴趣 |
30-90秒 |
新项目 |
痛点→结果→CTA |
| 介绍演示 |
兴趣→考虑 |
2-3分 |
UI变更检测 |
1用例完成 |
| 发布说明 |
考虑→确信 |
1-3分 |
CHANGELOG更新 |
Before/After重视 |
| 架构讲解 |
确信→决策 |
5-30分 |
大规模结构变更 |
实际运用+证据 |
| 入门引导 |
持续·活用 |
30秒-数分 |
首次设置 |
Aha体验最短路径 |
详细: references/best-practices.md
场景模板
90秒预告（LP/广告向）
| 时间 |
场景 |
内容 |
| 0-5秒 |
Hook |
痛点或期望结果 |
| 5-15秒 |
Problem+Promise |
目标用户和承诺 |
| 15-55秒 |
Workflow |
象征工作流 |
| 55-70秒 |
Differentiator |
差异化依据 |
| 70-90秒 |
CTA |
下一步行动 |
3分介绍演示（考虑向）
| 时间 |
场景 |
内容 |
| 0-10秒 |
Hook |
结论+痛点 |
| 10-30秒 |
UseCase |
用例声明 |
| 30-140秒 |
Demo |
实际画面完成 |
| 140-170秒 |
Objection |
常见不安消除 |
| 170-180秒 |
CTA |
行动号召 |
共通场景
| 场景 |
推荐时间 |
内容 |
| 引言 |
3-5秒 |
标志 + 口号 |
| 功能演示 |
10-30秒 |
Playwright捕获 |
| 架构图 |
10-20秒 |
Mermaid → 动画 |
| CTA |
3-5秒 |
URL + 联系方式 |
详细模板: references/best-practices.md
音频同步规则（重要）
带旁白视频时严格遵守:
| 规则 |
值 |
| 音频开始 |
场景开始 + 30f（1秒等待） |
| 场景长度 |
30f + 音频长度 + 20f余白 |
| 转场 |
15f（相邻场景重叠） |
| 场景开始计算 |
前场景开始 + 前场景长度 - 15f |
事前确认: 用 ffprobe 确认音频长度后设计场景
详细: references/generator.md
BGM 支持
| 项目 |
推荐值 |
| 有旁白 |
bgmVolume: 0.20 - 0.30 |
| 无旁白 |
bgmVolume: 0.50 - 0.80 |
| 文件放置 |
public/BGM/ |
详细: references/generator.md
字幕支持
| 规则 |
值 |
| 字幕开始 |
音频开始相同 |
| 字幕时长 |
音频长度 + 10f |
| 字体 |
Base64嵌入推荐 |
详细: references/generator.md
视觉效果库
用于有冲击力视频的效果集:
| 效果 |
用途 |
| GlitchText |
Hook、标题 |
| Particles |
背景、CTA收敛 |
| ScanLine |
解析中演出 |
| ProgressBar |
并行处理显示 |
| 3D Parallax |
卡片显示 |
详细: references/visual-effects.md
注意事项
- Remotion未设置时引导
/remotion-setup
- 并行生成数按场景数自动调整（最大5）
- 生成视频输出到
out/ 目录
- AI生成图像保存到
out/assets/generated/
GOOGLE_AI_API_KEY 未设置时跳过图像生成（使用现有素材或占位符）