video-shotcraft 教程：用 Opus 5.5 按镜头配方卡做 Remotion 电影感产品片（2026）
阅读说明
仓库信息查阅日期：2026-10-24；星数、更新时间会变，以仓库页面为准；本文不写价格。
一句话结论
Vincentwei1021/video-shotcraft 是给 Claude Code 和 Codex 用的产品视频技能。你描述一支宣传片，助手抓取真实页面，从镜头配方库里选镜头，用 Remotion 做动画，按音乐卡点并配音效，逐帧检查后交给你一支还能改的 MP4。
适合已经有产品页面、仓库或截图，想做成电影感产品片，并且接受成片是 Remotion 工程而不是生成模型出的视频的人。README 写明为 Claude Code 和 Codex 调校。它没有写必须使用 Opus 5.5。
仓库信息
截至 2026-10-24，星数、最近推送和创建时间取自仓库元数据，日期为北京时间。
| 仓库 | 星数 | 最近推送（北京时间） | 许可 | 创建时间 |
|---|---|---|---|---|
| Vincentwei1021/video-shotcraft | 13,241 | 2026-10-18 | Apache-2.0 | 2026-07-19 |
仓库描述是 “AI video skill for Claude Code & Codex — cinematic product videos with Remotion: 152 shot recipe cards, 209 motion previews, a production-ready template”。
README 正文（英文和中文）写的是另一组数字。2026-10 的镜头库更新说：全部 216 个演示经过打磨和评审，择优保留 124 张配方卡 / 150 个镜头，Gallery 样片已重新渲染。正文后文也写 “10 类、124 张配方卡、共 150 个镜头”。描述字符串和 README 正文不一致。理解当前库的规模时，以 README 正文为准。
README 的许可一节写明：
- 代码和文档是 Apache-2.0。
assets/audio/下每个音频文件各自有许可，见 ATTRIBUTION.md。- Remotion 另有自己的许可，正文在 remotion 仓库的 LICENSE.md。README 写明个人和小团队可以免费使用，公司可能需要另行取得许可。本文不写价格。
默认分支是 main。仓库同时有 README.md、README_CN.md、README_JA.md 和 README_RU.md。下面的安装命令和用法，英文 README 与中文 README 一致。
它能做什么样的视频
对 Claude Code 或 Codex 说「给我的产品做一支宣传片」。README 写明助手会抓取真实页面，从调好的动效配方里挑镜头，排分镜，用 Remotion 做动画，按节拍剪，做声音设计，逐帧检查，最后给你一支可以继续改的 MP4。
README 写明它不是视频生成模型。每一帧由代码根据你自己的截图和文案绘制。
README 流程图上的文字是：产品，抓取真实页面，用镜头配方卡排分镜，Remotion 动画，踩点剪辑和声音设计，渲染和逐帧验收，然后得到 MP4、动效工作台和剪映草稿。
2026-09 增加了动效工作台：交付后在浏览器里用剪映式编辑器继续改。2026-08 增加了剪映草稿导出，并提到系列里的另一个仓库 video-talkcraft：口播稿和成品配音进去，动效节拍钉在人声上。README 写明那边有 78 条口播动效样片。那是另一个仓库，不是本仓库的安装步骤。
镜头库
在 Gallery 里搜索、筛选、复制卡名。README 写明一共 150 个镜头。封面图标注的名字还有 graze-face-tour、logo-shrink-wordmark-lockup、panel-grid-moves、product-card-progressive-assemble、space-camera-moves、exploded-view、spotlight-hero-card。使用示例里另外点了 deck-deal-flyin、row-embed 和 spotlight-hero-card。
| 类别 | 镜头数 | README 的例子 | 目录名 |
|---|---|---|---|
| 开场与品牌（Opening & Brand） | 11 | text-as-mask | opening |
| 运镜与空间（Camera） | 13 | exploded-view | camera |
| 转场（Transitions） | 19 | card-flock-tumble | transition |
| 文字与字卡（Typography） | 25 | flying-words | typography |
| 界面登场（UI Entrance） | 22 | card-stack | ui-entrance |
| 交互演示（Interaction） | 13 | palette-theme-ripple | interaction |
| 数据与指标（Data） | 9 | axis-rescale-shock | data |
| 光效与强调（Light & Emphasis） | 23 | spotlight-sweep | effects |
| 节奏与蒙太奇（Rhythm） | 8 | paparazzi-flash | rhythm |
| 收尾（Outro） | 7 | input-morph-assemble | outro |
上表镜头数相加是 150，和 README 的总数一致。目录名来自仓库的 references/shots/ 和 demos/。光效这一类的配图文件名是 effects.webp，文件夹也叫 effects。README 没有单独一张「类名对目录名」的表。
每张卡在 references/shots/<类别>/<卡名>.md，Remotion 实现在 demos/<类别>/<卡名>/。怎么接到自己的工程，README 指向 demos/README.md。
交付物
| 产出 | README 写明的内容 |
|---|---|
| 成片 | MP4，1920×1080，30 fps，h264，带音乐和音效 |
| Remotion 工程 | 整支片子的源码，每个镜头是一个 React 组件 |
| 动效工作台 | 交付后打开。多轨、检查器、改时间、换镜头、再导出。预览和渲染逐帧一致 |
| 剪映草稿 | 可选。按镜头分段，原生字幕轨，SFX 和 BGM 分开。README 写明在 macOS 上的剪映专业版 11.2 验收过 |
| 社交平台发布 | 可选，而且要你开口才做。经 Upload-Post 发到 TikTok、Instagram、YouTube、LinkedIn、X 等。先确认文案和平台，dry-run 之后再发 |
另外 README 写明附带：可复用的 Remotion 组件（2.5D 页面相机、字幕、闪切、数字滚动）、149 个音效、5 首 BGM、页面采集脚本，以及制作方法（采集、视觉方向、分镜、声音设计、卡点、终检）。方法入口是 references/pipeline.md。
音效先按 16 类挑，再挑音色。类名是 transition、impact、riser、camera、ui、text、paper、film、light、data、scifi、mech、glass、fluid、crowd、counter。索引在 sound-design.md。仓库 assets/audio/sfx/ 下是这 16 个目录，assets/audio/bgm/ 下有 5 个文件。
模板里带的产品截图是演示素材。对外发布前换成自己的产品截图，并检查产品、客户或个人信息要不要脱敏。
做完可以按仓库的 Showcase 表单投稿：issues/new?template=showcase.yml。通过后会出现在 Showcase 页。
仓库里和做片直接相关的路径
这些说明来自 README 的项目结构。根目录还有 .claude-plugin/、.github/、agents/、shot-polish/、videos/、package.json 和 package-lock.json。README 的结构树没有解释这几项。
| 路径 | README 写明的内容 |
|---|---|
SKILL.md | 助手入口和核心制作规则 |
references/pipeline.md | 从开始到结束的制作流程 |
references/shots/ | 124 张镜头配方卡，10 个功能类 |
references/sequences/ | 可复用的全片结构和桥段 |
references/aesthetic-rules.md | 视觉验收标准 |
references/music-beat-sync.md | BGM 分析和卡点方法 |
references/sound-design.md | 声音设计说明和例子 |
references/jianying-export.md | 剪映草稿导出 |
references/publish-upload-post.md | 可选的社交发布（Upload-Post API） |
references/workbench.md | 动效工作台的清单约定和可编辑规则 |
demos/ | 与配方卡同一套分类的 Remotion 参考实现 |
gallery/ | Gallery 的静态站点 |
template/ | 可运行的完整成片模板 |
jianying-export/ | 剪映草稿安装模块。结构注释写 macOS 已验收，Windows 未验证 |
publish/ | 可选的社交发布脚本（只使用 Python 标准库）和离线测试 |
workbench/ | 交付后的动效工作台（Vite + Remotion Player） |
assets/lib/ | 可复用的 Remotion 组件 |
assets/scripts/ | 页面素材采集脚本 |
assets/audio/bgm/ | 5 首 BGM |
assets/audio/sfx/ | 149 个音效，16 类 |
工作台的中文图文指南在 workbench/GUIDE.md。
需要准备什么
README 的环境表只列了下面这些。表里没有 API key，也没有写 Node 的最低版本号。
| 需要 | 用来 | README 写明的装法 |
|---|---|---|
| Node.js 和 npm | Remotion 渲染、模板、动效工作台 | README 未给出安装命令。无头 Linux 的记录里写了 Node 22 |
| ffmpeg / ffprobe | 抽帧检查和最终验收 | README 未给出安装命令 |
| uv | 只在分析 BGM 节拍时跑一次性 Python 脚本 | README 未给出安装命令 |
| puppeteer | 只在抓取页面时用 | 采集脚本按需安装 |
Remotion 第一次渲染时会下载它自己的无头 Chrome。README 写明已在 macOS 上测试。Linux 按下一节的三个参数。
无头 Linux 或 CI（README 记录的环境是 2 核、Node 22）有三件事：
- 核数少时，
remotion still/render会报 “Maximum for --concurrency is 2”。加上--concurrency=1。 - 新版 Chrome / Chromium 去掉了旧的 headless 模式，把 Remotion 指到系统 Chromium 会启动失败。改用 chrome-headless-shell，不用完整版 Chrome。
- 访问不了
remotion.media时（README 写明国内常见），自动下载 headless-shell 会失败。加上--browser-executable=<本地 chrome-headless-shell 路径>。
README 写明加上这三个参数后，仓库自带的模板可以渲染出帧。
安装与第一次运行
README 写了三条安装路径，并写明使用时不需要命令，直接描述片子。
- 把仓库链接交给助手。英文 README 的原文是：
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft
中文 README 的原文是：
帮我安装这个 skill：https://github.com/Vincentwei1021/video-shotcraft
- 或者用 README 写的 skills CLI：
npx skills add Vincentwei1021/video-shotcraft
- 或者手动克隆，再软链进技能目录。两条
ln -s按你用的助手选，不必两条都执行：
git clone https://github.com/Vincentwei1021/video-shotcraft.git
cd video-shotcraft
ln -s "$(pwd)" ~/.claude/skills/video-shotcraft # Claude Code
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft # Codex
README 写明，在中国大陆如果克隆 GitHub 很慢，可以改用 AtomGit 镜像：
git clone https://atomgit.com/VincentWei/video-shotcraft.git
- 装好之后直接描述片子。README 的对照表是：
| 你说 | README 写明会发生什么 |
|---|---|
用 video-shotcraft 给我的产品做一支宣传片。 | 助手先介绍 Ink Press 模板，并问你用不用。然后抓取页面、做片 |
用 Ink Press 模板给这个仓库做一支发布片。 | README 称为最快路径：把你的截图、文案和标志放进已经验收过的模板 |
用 deck-deal-flyin 和 row-embed 两张镜头卡展示这个功能。 | 按名字点镜头。名字从 Gallery 复制 |
参考 spotlight-hero-card，为这个页面设计一个产品特写镜头。 | 只做这一个镜头，按你的产品改编 |
英文 README 里对应的四句是 Use video-shotcraft to make a promo for my product.、Make a launch film for this repo with the Ink Press template.、Use the deck-deal-flyin and row-embed shot cards to present this feature.、Design a product close-up inspired by spotlight-hero-card.
README 没有把
npm install或npx remotion render写成第一次运行的命令。模板在template/，替换步骤的正文 README 指向模板目录里的说明，使用表本身没有逐步命令。无头 Linux 渲染时用上一节的三个参数。交付后，技能会在浏览器里打开动效工作台。README 写的命令是：
node workbench/scripts/open.mjs <project>
中文 README 把 <project> 写成 <工程>。工作台里成片按原来的镜头拆成镜头、转场、字幕和音效轨。选中镜头可以改文案、字号和颜色，可以移动、裁切、变速，也可以把库里的 150 个镜头拖上去，再用 Remotion 导出。
剪映导出和社交发布都是可选的。README 没有在安装节写出 Upload-Post 的密钥变量名，说明在 references/publish-upload-post.md。
在 Claude Code 里用 Opus 5.5 驱动它
在 Claude Code 里用 /model 选 Opus 5.5，详见 Claude Opus 5.5。
README 没有单独的斜杠命令，也没有写必须使用 Opus 5.5。技能声明面向 Claude Code 和 Codex。做片就是把上一节的句子发给它。完整规则在 SKILL.md。本文的步骤停在 README 已经写明的安装和四句用法上。
示例提示词（按 README 写明的用法改写，不是仓库原文）
先让助手介绍模板再做片：
用 video-shotcraft 给我的产品做一支宣传片。先介绍 Ink Press 模板，问我是否采用。我确认之后再抓取页面并做片。成片按仓库 README 的交付规格：MP4、1920×1080、30 fps、h264，带音乐和音效。
指定走模板，并换掉演示截图：
用 Ink Press 模板给这个仓库做一支发布片。把我的截图、文案和标志放进模板。模板自带的演示截图不要留在对外发布的成片里。发布前说明产品数据、客户信息和个人信息里哪些需要脱敏。
按 Gallery 上的卡名点两个镜头：
用 deck-deal-flyin 和 row-embed 两张镜头卡展示这个功能。卡名按 Gallery 上的原名。
只改编一个特写镜头：
参考 spotlight-hero-card，为这个页面设计一个产品特写镜头。只做这一个镜头，按我的产品改编。
交付之后如果要自己改轨，再发：
用 node workbench/scripts/open.mjs 打开刚才这支片子的动效工作台。
限制与已知问题
- 仓库描述仍写 152 张配方卡、209 条动态预览。README 正文写 216 个演示择优之后是 124 张卡、150 个镜头。两处数字不一致。
- 成片规格 README 写的是 1920×1080、30 fps、h264。竖屏或其他帧率 README 未说明。
- 环境表没有 API key。可选的社交发布要走 Upload-Post API，密钥字段 README 的安装节未写。
- 音频不是 Apache-2.0，逐个文件见
assets/audio/ATTRIBUTION.md。Remotion 另有许可。 - 模板截图是演示素材。发布前要换成自己的画面，并做脱敏检查。
- 致谢写明：不少配方是研究 ClickUp、Perplexity、Slack、Notion、Figma、Framer、Bear、Raycast、Pitch、Miro、Superhuman、Loom 等产品片的运动语言之后，从零重写的时序、缓动和编排。仓库不包含那些影片的画面、美术或品牌资产。商标归各自所有者。
- 致谢写明库内音效和音乐来自 Mixkit 的免费授权。逐文件许可以 ATTRIBUTION 为准。
- 无头 Linux 要自行加上文的三个参数。README 未给出 ffmpeg、ffprobe、uv、Node 的安装命令。
- 剪映导出 README 写明在 macOS 剪映专业版 11.2 上验收过。
jianying-export/的结构注释写 Windows 未验证。 - 口播成片不是这个仓库的主路径。README 把口播指向另一个仓库 video-talkcraft。
- 截至 2026-10-24，开放的 issue 有 9 个，开放的 pull request 有 2 个。
常见问题
成品是 HTML 还是 MP4？怎么预览？
README 写明交给你的成片是 MP4：1920×1080、30 fps、h264，带音乐和音效，同时留下可改的 Remotion 工程。交付后打开动效工作台，预览和渲染逐帧一致。命令是 node workbench/scripts/open.mjs <project>。镜头库的动态预览在 Gallery，那是配方卡的样片，不是你的成片。README 未说明用浏览器直接打开某个 HTML 来代替这次渲染。
能不能商用？
代码和文档 README 标明为 Apache-2.0，全文在仓库 LICENSE。音频各自许可，见 assets/audio/ATTRIBUTION.md。Remotion 另有许可，README 写明个人和小团队可以免费使用，公司可能需要另行取得许可。模板里的产品截图是演示素材，发布前要换掉。本文不写价格，也不把许可正文扩写成法律意见。
要不要 API key？
环境要求表里没有 API key。页面抓取用的 puppeteer 由采集脚本按需安装。可选的社交发布使用 Upload-Post API。密钥怎么写进环境，README 的安装节未说明，文件在 references/publish-upload-post.md。
有没有中文字幕和中文配音？
动效工作台有字幕轨，剪映导出会重建原生字幕轨。README 未说明默认字幕语言，也未写语音合成或中文旁白。需要口播和配音卡点时，README 指向的是另一个仓库 video-talkcraft，不是本仓库的默认流程。
相关阅读
- 热门项目合集
- 用 Opus 5.5 做视频
- 从提示词到成片
- 场景模板
- 报错与省用量
- 开源 Skill 与工具
- Claude Opus 5.5
- 环境搭建
- 开源 AI 视频 Skill 目录
- Claude Motion（官方功能）
- product-launch-motion 教程
- video-use 教程
- mg-styles-15 教程
- lemo-opuscar 教程
- motion-graphics-skills 教程
参考来源
- Vincentwei1021/video-shotcraft（查阅日期：2026-10-24）
- 仓库 README.md（查阅日期：2026-10-24）
- 仓库 README_CN.md（查阅日期：2026-10-24）
- SKILL.md 只作 README 指向的规则入口；上手步骤未超出 README（查阅日期：2026-10-24）
- LICENSE（查阅日期：2026-10-24）
- 仓库根目录、
references/shots/、demos/、assets/audio/bgm/、assets/audio/sfx/的目录列表（查阅日期：2026-10-24） - Remotion 许可（仓库 README 所引，查阅日期：2026-10-24）