从URL生成产品视频
流程:URL → 提取 → 草拟简报 → 盲点问题 → 构建 → 审阅 → 渲染
创意简报模板位于 references/video-brief.md。提取脚本是 scripts/extract_site.mjs。在步骤4之前请先阅读简报模板。
1. 检查环境
node --version # 需要18+
获取任意网站和下载Chromium都需要开放网络访问。在Web版Claude Code中,环境的网络访问必须设置为完全(默认的“可信”白名单会阻止大多数客户端网站和浏览器下载)。如果获取失败并出现网络/代理错误,请用一行通知用户并回退(参见步骤2回退方案)。
2. 提取网站
mkdir -p work && cd work
npm init -y >/dev/null && npm i playwright@1 >/dev/null
npx playwright install --with-deps chromium # 如果没有root权限则去掉 --with-deps
node <skill-dir>/scripts/extract_site.mjs "<URL>" ./site
此命令会输出到 ./site/:
site.json— 标题、meta/OG标签、标题、CTA、导航、正文、品牌颜色排名、CSS颜色变量、字体、Logo候选、爬取的子页面hero-desktop.png、hero-mobile.png、full-desktop.png、section-*.png、page-*.png- 如果找到则生成
logo.*
claims 是一个宽泛的集合(任何包含数字的内容)——将其视为待审阅的列表,而非直接使用的声明列表。
如果Chromium已安装在别处(例如 /opt/pw-browsers),跳过安装并将 PLAYWRIGHT_BROWSERS_PATH 设置为该路径。
接下来查看截图(打开PNG文件)——不要仅依赖JSON。判断:是否可见真实的产品UI,还是只有营销图形/库存照片?哪些部分裁剪成特写效果更好?提取的颜色与看到的是否匹配?
回退方案(无浏览器/被阻止):使用任意可用的网页获取工具获取页面文本,尽可能填充内容,并将颜色、Logo和截图标记为缺失——这些将成为盲点问题。
3. 起草项目详情
填写项目详情块中的每个字段。为每个值标注来源:
[site]— 网站上的陈述(引用或近似引用)[inferred]— 对网站的合理推断[guess]— 无支持,需要确认
规则:
- 声明: 仅使用网站上出现的指标/评价/声明,并标记为
[site]。切勿编造数字、客户数量或结果。如果网站没有,则视频中也没有。 - 功能: 选择2–3个最具视觉表现力和最具体的功能。无法在屏幕上展示的功能是弱选择。
- 主要优点: 一句话,用户结果导向,除非公司口号已经是明确的优点。
- 颜色: 从提取结果中选择一组克制的颜色(背景、文字、1个品牌色、最多1个强调色)。提供十六进制代码。
- 素材: 列出
./site/中的实际文件路径,并说明每个文件展示的内容。
4. 询问盲点问题——一次完成,批量提出
在构建之前,发送一条包含草拟详情块和问题的消息。规则:
- 仅询问那些可能改变视频内容且无法从网站解决的问题。跳过已经明确的内容。
- 每个问题都附带你建议的默认答案,以便用户可以回复“继续”后你直接进行。
- 最多约6个问题,按影响排序。保持简短。
检查以下盲点(仅询问适用的):
- 用途——作为冷推销售样本、付费广告、作品集片段,还是发布视频?(改变CTA、基调、宽高比。)
- 宽高比——9:16(Reels/TikTok/DM)还是16:9(网站/YouTube/LinkedIn)。默认:推销/广告使用9:16,网站嵌入使用16:9。
- 受众——如果网站服务于多个群体(例如买家和卖家),选择哪一个?
- 功能选择——如果候选功能超过3个,确认你的选择。
- 产品视觉——如果截图未显示真实UI(仅有照片/插画),询问:使用简化的重新创建UI、使用他们的摄影素材,还是用户有真实的应用截图?
- Logo——缺失、低分辨率或仅有网站图标 → 是否使用品牌字体构建一个干净的文字标记?
- 声明——网站有统计数据/评价:是包含它们(逐字)还是保持无声明?
- CTA——网站上无明确CTA,或用途是推销 → 结尾卡片应显示什么/链接到哪里?
- 实体/本地业务且无应用 → 设备模型不适用;建议替代的中心视觉(他们的照片、预订/菜单卡片、地图标记)。
- 音乐/配音——简报为无声视频;仅当用户用途暗示声音(如广告)时才提及。
如果用户说“直接继续”或部分回答,使用你的默认值,并用一行说明。
5. 填写简报并执行
阅读 references/video-brief.md。将确认的项目详情(去掉来源标签)插入其中,并保存为 work/brief.md。然后将简报作为自己的指令遵循:先制作故事板(简要展示,无需等待批准,除非用户要求审阅),然后构建。
Remotion设置(非交互式)
mkdir video && cd video
npm init -y >/dev/null
npm i remotion @remotion/cli react react-dom
npm i -D typescript @types/react
npx remotion browser ensure
mkdir -p src public && cp ../site/*.png ../site/logo.* public/ 2>/dev/null
所有 remotion / @remotion/* 包必须使用完全相同的版本。入口文件:src/index.ts 调用 registerRoot(Root);src/Root.tsx 注册 <Composition>。使用 staticFile('name.png') 和 <Img> 引用素材。当品牌字体是Google字体时,使用 @remotion/google-fonts 加载Web字体,否则使用接近的备用字体。
结构:
src/content.ts— 所有文案、颜色、素材文件名、场景时长(秒)。这是用户编辑的文件。src/scenes/*.tsx— 每个场景一个组件。src/components/*— 设备框架、文字揭示效果等。- 总时长根据
content.ts的场景时长计算。
使用 remotion 中的 interpolate + spring,使用 <Sequence> 或 @remotion/transitions 的 <TransitionSeries> 处理场景。不要使用CSS动画或 Math.random()(非确定性渲染);如果需要,使用 remotion 的 random('seed')。
6. 最终渲染前的审阅
在代表帧(每个场景的开始、中间和结束)渲染静态画面并查看:
npx remotion still src/index.ts <CompId> out/f-<n>.png --frame=<n>
对照简报的审阅清单检查:手机尺寸下文字可读、无内容被裁剪、每个场景一个焦点、截图未拉伸、结尾停留时间≥1.5秒。修复后重新检查你更改的帧。
7. 渲染并交付
npx remotion render src/index.ts <CompId> out/<product>-video.mp4
交付内容:MP4路径、简报故事板(简短)、以及4行编辑说明——文案/颜色/时长在 src/content.ts 中、素材在 public/ 中、预览使用npx remotion studio、使用上述命令重新渲染。用一行说明你假设的任何默认值。