solo-video-promo

使用 30-45 秒的脚本、逐个镜头的故事板和可选的 Remotion/Montage 工具配置生成宣传视频计划。当用户说“创建视频”、“宣传视频”、“视频脚本”、“故事板”、“演示视频”或“产品视频计划”时使用。请勿用于社交媒体文本帖子（使用 /content-gen）或登陆页面副本（使用 /landing-gen）。

# /video-promo

Generate a promo video plan from a project's PRD. Produces a 30-45 second video script with shot-by-shot storyboard. Detects Montage-tool or Remotion in the project and outputs compatible config when found.

## MCP Tools (use if available)

- `project_code_search(query, project)` — find UI components, screens, features to showcase
- `project_info(name)` — get project stack and details
- `kb_search(query)` — find video production methodology

If MCP tools are not available, fall back to Glob + Grep + Read.

## Steps

1. **Parse project** from `$ARGUMENTS`.
   - Read PRD (`docs/prd.md`), README, or CLAUDE.md for product info.
   - If empty: ask via AskUserQuestion.

2. **Detect video tooling** in the project:
   - Check `package.json` for `remotion`, `@remotion/cli` → Remotion project
   - Check for `montage.config.*`, `pnpm montage` → Montage-tool project
   - Check for `ffmpeg` usage in scripts → FFmpeg pipeline
   - If none found: output plain storyboard (no specific tooling config)

3. **Extract key screens/features** to showcase:
   - If MCP available: `project_code_search("main screen OR hero OR dashboard", project)` — find showcase-worthy UI
   - Otherwise: Glob for screenshots, mockups, or UI component files
   - Read PRD for top 3-5 features to demonstrate

4. **Forced reasoning — video strategy:**
   Before scripting, write out:
   - **Goal:** What should the viewer DO after watching? (download, sign up, visit)
   - **Hook type:** Question? Surprising stat? Pain point? Bold claim?
   - **Demo moments:** 3 key product moments to show on screen
   - **Emotion arc:** Frustration → Discovery → Relief/Delight

5. **Generate video script** (30-45 seconds):

   ```markdown
   ## 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. **Generate tooling config** (if applicable):

   ### If Remotion detected:
   ```markdown
   ## 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
   ```

   ### If montage tool detected:
   ```markdown
   ## 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. **Write plan** to `docs/video-promo.md`:

   ```markdown
   # 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. **Output summary** — script overview, assets needed, suggested next steps.

## Notes

- Script assumes screen recording as primary footage — no actor needed
- For iOS apps: use Simulator recording or device mirroring
- For web: use browser screen recording
- Music: suggest royalty-free sources (Artlist, Epidemic Sound, YouTube Audio Library)
- This skill generates the PLAN — actual video rendering is manual or via Montage-tool/Remotion

## Common Issues

### No video tooling detected
**Cause:** Project doesn't use Remotion or Montage-tool.
**Fix:** Skill outputs plain storyboard by default. Record manually and edit in CapCut/iMovie, or add Remotion to the project.

### Script too long for short-form video
**Cause:** Too many features to showcase.
**Fix:** Pick TOP 3 features only. 30-45 seconds = ~75-100 words of narration. Less is more.

### No screenshots or UI to record
**Cause:** Product not built yet or no visual interface.
**Fix:** Use mockups, wireframes, or describe intended visuals in the storyboard. Record after MVP is built.

---

## 中文说明

# /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 秒）：

   ```markdown
   ## 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：
   ```markdown
   ## 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 工具：
   ```markdown
   ## Montage Config

   Clips:
   - problem-clip.mp4 (7s)
   - demo-feature-1.mp4 (5s)
   - demo-f