Generate Video Skill
这是负责自动生成产品说明视频的一组技能。
概要
这是 /generate-video 命令内部使用的技能。
它会执行“代码库分析 → 场景方案提议 → 并行生成”的完整流程。
機能詳細
Prerequisites
- 已完成 Remotion 设置（
/remotion-setup）
- Node.js 18+
- （可选）
GOOGLE_AI_API_KEY - 用于 AI 图片生成
/generate-video 流程
/generate-video
│
├─[Step 1] 分析（analyzer.md）
│ ├─ 检测框架
│ ├─ 检测核心功能
│ ├─ 检测 UI 组件
│ └─ 解析项目资产（Plans.md、CHANGELOG 等）
│
├─[Step 2] 场景提案（planner.md）
│ ├─ 自动判定视频类型
│ ├─ 提议场景结构
│ └─ 用户确认
│
├─[Step 2.5] 生成素材（image-generator.md）← NEW
│ ├─ 判断是否需要素材（开场、CTA 等）
│ ├─ 用 Nano Banana Pro 生成 2 张
│ ├─ 由 Claude 执行质量判定（image-quality-check.md）
│ └─ OK → 采用 / NG → 重新生成（最多 3 次）
│
└─[Step 3] 并行生成（generator.md）
├─ 并行生成场景（Task tool）
├─ 统合 + 转场
└─ 最终渲染
执行步骤
- 用户执行
/generate-video
- 确认 Remotion 已设置
- 用
analyzer.md 分析代码库
- 用
planner.md 提议场景并让用户确认
- 用
generator.md 并行生成
- 输出完成报告
视频类型（按漏斗阶段）
| 类型 | 漏斗阶段 | 时长范围 | 自动判定条件 | 结构核心 |
|---|
| LP/广告 teaser | 认知→兴趣 | 30-90 秒 | 新项目 | 痛点→结果→CTA |
| Intro 演示 | 兴趣→评估 | 2-3 分钟 | 检测到 UI 变更 | 跑通 1 个完整用例 |
| 发布说明 | 评估→确信 | 1-3 分钟 | CHANGELOG 更新 | 强调 Before/After |
| 架构讲解 | 确信→决策 | 5-30 分钟 | 大规模结构变更 | 实际运作 + 证据 |
| Onboarding | 持续使用 | 30 秒到数分钟 | 首次安装 | 通往 Aha 时刻的最短路径 |
詳細: references/best-practices.md
场景模板
90 秒 teaser（用于 LP / 广告）
| 时间 | 场景 | 内容 |
|---|
| 0-5 秒 | Hook | 痛点或想要的结果 |
| 5-15 秒 | Problem+Promise | 目标用户与承诺 |
| 15-55 秒 | Workflow | 具有代表性的工作流 |
| 55-70 秒 | Differentiator | 差异化依据 |
| 70-90 秒 | CTA | 下一步行动 |
3 分钟 Intro Demo（适合评估阶段）
| 时间 | 场景 | 内容 |
|---|
| 0-10 秒 | Hook | 结论 + 痛点 |
| 10-30 秒 | UseCase | 明确 use case |
| 30-140 秒 | Demo | 用真实界面完整演示 |
| 140-170 秒 | Objection | 先消除 1 个常见顾虑 |
| 170-180 秒 | CTA | 行动引导 |
通用场景
| 场景 | 建议时长 | 内容 |
|---|
| Intro | 3-5 秒 | Logo + 标语 |
| 功能 Demo | 10-30 秒 | Playwright 捕获 |
| 架构图 | 10-20 秒 | Mermaid → 动画 |
| CTA | 3-5 秒 | URL + 联系方式 |
详细模板见：${CLAUDE_SKILL_DIR}/references/best-practices.md
音频同步规则（重要）
有旁白的视频必须严格遵守以下规则：
| 规则 | 值 |
|---|
| 音频开始 | 场景开始 + 30f（等待 1 秒） |
| 场景长度 | 30f + 音频长度 + 20f 余白 |
| 转场 | 15f（与相邻场景重叠） |
| 场景开始计算 | 前一场景开始 + 前一场景长度 - 15f |
事前确认: 先用 ffprobe 确认音频长度，再设计场景
详情见：${CLAUDE_SKILL_DIR}/references/generator.md
BGM 支持
| 项目 | 推荐值 |
|---|
| 有旁白 | bgmVolume: 0.20 - 0.30 |
| 无旁白 | bgmVolume: 0.50 - 0.80 |
| 文件位置 | public/BGM/ |
详情见：${CLAUDE_SKILL_DIR}/references/generator.md
字幕支持
| 规则 | 值 |
|---|
| 字幕开始 | 与音频开始相同 |
| 字幕时长 | 音频长度 + 10f |
| 字体 | 推荐 Base64 内嵌 |
详情见：${CLAUDE_SKILL_DIR}/references/generator.md
视觉效果库
适合做出强冲击力视频的效果集合：
| 效果 | 用途 |
|---|
| GlitchText | Hook、标题 |
| Particles | 背景、CTA 汇聚 |
| ScanLine | 分析中演出 |
| ProgressBar | 并行处理显示 |
| 3D Parallax | 卡片展示 |
詳細: references/visual-effects.md
Notes
- 如果还没配置 Remotion，就引导用户使用
/remotion-setup
- 并行生成数会根据场景数量自动调整（最多 5）
- 生成的视频输出到
out/ 目录
- AI 生成图片保存到
out/assets/generated/
- 如果未设置
GOOGLE_AI_API_KEY，则跳过图片生成（使用现有素材或占位图）