product-demo-videolisted
Install: claude install-skill realruian/product-demo-video
# Product Demo Video(产品演示片)
把一个真实 web 产品做成**有调性**的演示片:真实页面截图 + 代码重建的界面,组装进浏览器窗口 mockup,配字幕、logo、音乐,渲染成竖屏/方屏短视频。
**它是自动的**——你只给一个能跑起来的项目,Claude 会:
- **自动理解产品**:读 `CLAUDE.md` / `README` / 路由,搞清每个页面是干什么的、产品的调性。
- **自动读代码生成文案**:根据每个页面的真实功能,自动写出对应场景的标题 / 副标题字幕与地址栏,不用你手写。
- **自动定位 logo**:在 `public/` 里找到你项目的真实矢量 logo,用在片头与收尾。
你只在几个关键点做选择题(画布比例、纳入哪些页面、节奏、声音)。
**前置 skill**:本 skill 依赖 [`remotion-best-practices`](视频框架)和 [`agent-browser`](截图)。处理 Remotion 代码前先加载 remotion-best-practices 拿领域知识。
## 何时用
用户要把一个跑得起来的 web 产品(自己的项目 / 给定目录)做成产品演示 / 宣传短视频。典型:"给我们的产品做个演示视频"、"把这个页面做成竖屏宣传片"。
## 产物形态
一个 Remotion 项目,渲染出 mp4:
- **画布**:竖版 1280×1706(3:4,默认,适合社媒)/ 方版 1080×1080 / 横版 1920×1080
- **结构**:N 个场景,每个场景 = 一张产品页面(真实截图或代码重建)放进**浏览器窗口 mockup**,配底部字幕;场景间 crossfade + 整窗缓慢 Ken Burns;收尾落到品牌 logo + slogan
- **声音**:免版权 BGM(默认)或 TTS 旁白(可选)
## 完整流程(5 阶段)
### 阶段 1 — 摸清��品 & 规划叙事
1. 读项目 `CLAUDE.md` / `README.md` / `DESIGN.md`,搞清:产品是什么、有哪些核心页面/功能、**调性规范**(配色/字体/禁忌——见 reference/tone.md,必须遵守项目自己的 DESIGN.md)。
2. 列出页面路由(`find app -name page.tsx`),**读懂每个页面的功能**,自动归纳一条「用户旅程」叙事线(如「核心功能 A → B → C → 结果页」),并为每段自动拟好字幕文案。
3. 跟用户确认:画布比例、纳入哪些环节、节奏、声音方案。**截不到真实图的页面要提前标注风险**(实时/需特殊数据的页面)。
### 阶段 2 — 截真实页面(能截的优先)
用 `agent-browser`。详见 [scripts/capture-pages.md](scripts/capture-pages.md)。要点:
- 启动目标项目前后端(后台),等就绪。
- **设标准视口** `agent-browser set viewport 1440 900 2`(@2x retina,16:10 正常浏览器比例,截图清晰)。
- **处理登录**:多数 `(app)` 页面要登录。从 dev.db 找测试账号;密码是 hash,**经用户授权**后用项目自己的 hash 函数临时重置(截完**必须还原**,见���训)。
- **去掉 dev 角标**:`agent-brows