solo-video-promo

/video-promo

根据项目的 PRD 生成宣传视频方案。制作一份 30-45 秒的视频脚本，并按镜头编写分镜。检测项目中是否使用 Montage-tool 或 Remotion；如果检测到，则输出兼容的配置。

MCP 工具（如可用）

• project_code_search(query, project) — 查找可展示的 UI 组件、屏幕和功能
• project_info(name) — 获取项目技术栈和详细信息
• kb_search(query) — 查找视频制作方法

如果 MCP 工具不可用，则使用 Glob + Grep + Read。

步骤

1. 解析项目，读取 $ARGUMENTS。

   • 阅读 PRD（docs/prd.md）、README 或 CLAUDE.md，了解产品信息。
   • 如果内容为空：通过 AskUserQuestion 提问。

2. 检测项目中的视频工具：

   • 检查 package.json 是否包含 remotion、@remotion/cli → Remotion 项目
   • 检查是否存在 montage.config.*、pnpm montage → Montage-tool 项目
   • 检查脚本中是否使用 ffmpeg → FFmpeg 工作流
   • 如果均未检测到：输出纯分镜脚本（不包含特定工具配置）

3. 提取要展示的关键屏幕和功能：

   • 如果 MCP 可用：project_code_search("main screen OR hero OR dashboard", project) — 查找值得展示的 UI
   • 否则：使用 Glob 查找截图、样稿或 UI 组件文件
   • 阅读 PRD，找出要展示的 3-5 项主要功能

4. 强制推理 — 视频策略： 编写脚本前，先列出：

   • 目标： 观众看完后应该做什么？（下载、注册、访问）
   • 吸引点类型： 问题？令人惊讶的数据？痛点？大胆的主张？
   • 演示时刻： 屏幕上要展示的 3 个关键产品时刻
   • 情绪曲线： 挫败 → 发现 → 宽慰/愉悦

5. 生成视频脚本（30-45 秒）：

   ## Video Script: {Project Name}
   
   **Duration:** 30-45 seconds
   **Format:** Vertical (9:16) for Reels/TikTok/Shorts
   **Style:** Screen recording + text overlays
   
   ### HOOK (0:00-0:03) — 3 seconds
   **Audio:** "{hook line — question or bold statement}"
   **Visual:** {what appears on screen — text overlay on gradient/blurred BG}
   
   ### PROBLEM (0:03-0:10) — 7 seconds
   **Audio:** "{describe the pain in user's words}"
   **Visual:** {show the frustrating current state — competitor UX, manual process, etc.}
   
   ### DEMO (0:10-0:25) — 15 seconds
   **Audio:** "{narrate what the product does}"
   **Visual:**
   - Shot 1 (5s): {first feature demo — screen recording}
   - Shot 2 (5s): {second feature demo}
   - Shot 3 (5s): {wow moment — the key differentiator}
   
   ### CTA (0:25-0:30) — 5 seconds
   **Audio:** "{call to action}"
   **Visual:** {product logo + URL + download badge}
   

6. 生成工具配置（如适用）：

   如果检测到 Remotion：

   ## Remotion Component Spec
   
   Component: `PromoVideo.tsx`
   Duration: 900 frames (30fps × 30s)
   
   Sequences:
   - HookSequence (0-90): Text animation on gradient
   - ProblemSequence (90-300): Screen recording import
   - DemoSequence (300-750): 3 feature recordings with transitions
   - CTASequence (750-900): Logo + URL fade in
   
   Assets needed:
   - screen-recording-problem.mp4
   - screen-recording-feature-1.mp4
   - screen-recording-feature-2.mp4
   - screen-recording-feature-3.mp4
   - logo.png
   - background-music.mp3
   

   如果检测到 Montage-tool：

   ## Montage Config
   
   Clips:
   - problem-clip.mp4 (7s)
   - demo-feature-1.mp4 (5s)
   - demo-feature-2.mp4 (5s)
   - demo-wow-moment.mp4 (5s)
   
   Music: {suggest genre/BPM for beat-sync}
   Transitions: crossfade (0.5s)
   Text overlays: hook, CTA
   

7. 将方案写入 docs/video-promo.md：

   # Video Promo Plan: {Project Name}
   
   **Generated:** {YYYY-MM-DD}
   **Duration:** 30-45 seconds
   **Format:** Vertical 9:16
   **Tooling:** {Remotion / Montage-tool / Manual}
   
   ## Script
   {full script from step 5}
   
   ## Assets Checklist
   - [ ] Screen recording: {feature 1}
   - [ ] Screen recording: {feature 2}
   - [ ] Screen recording: {wow moment}
   - [ ] Logo (transparent PNG)
   - [ ] Background music (royalty-free, upbeat)
   
   ## Tooling Config
   {config from step 6, or "Record manually and edit in CapCut/iMovie"}
   
   ---
   *Generated by /video-promo. Record assets, then render.*
   

8. 输出摘要 — 脚本概览、所需素材和建议的后续步骤。

备注

• 脚本默认以屏幕录制作为主要素材 — 无需演员
• 对于 iOS 应用：使用 Simulator 录制或设备镜像
• 对于 Web：使用浏览器屏幕录制
• 音乐：推荐免版税音乐来源（Artlist、Epidemic Sound、YouTube Audio Library）
• 此技能生成的是方案 — 实际视频渲染需手动完成，或使用 Montage-tool/Remotion

常见问题

未检测到视频工具

原因： 项目未使用 Remotion 或 Montage-tool。 解决方法： 技能默认输出纯分镜脚本。手动录制并使用 CapCut/iMovie 剪辑，或在项目中添加 Remotion。

脚本太长，不适合短视频

原因： 要展示的功能太多。 解决方法： 只选 TOP 3 项功能。30-45 秒约可容纳 75-100 个旁白词。内容越精简越好。

没有截图或可录制的 UI

原因： 产品尚未构建，或没有可视化界面。 解决方法： 在分镜中使用样稿、线框图，或描述预期画面。待 MVP 构建完成后再录制。