你打开 Remotion，想给产品做个宣传片。光标闪了十分钟，你还在纠结第一个镜头用什么动画、参数填多少。

不是你不会写代码——是从零设计一套动效语言，比写十个功能还累。一种动画手法（飞入、堆叠、翻页）全片只能当一次主角，106 种你要怎么选、怎么调？

一个叫 Vincent Wei 的开发者把这件事做成了开源技能：video-shotcraft。106 张配方卡、161 段样片、一支完整成片模板——Claude Code 装上它，直接变身电影级动效工作室。

---

这是什么东西

video-shotcraft 是一个专为 AI 编程代理打造的 Remotion 视频制作技能。它不是一个新的视频框架，而是架在 Remotion 上面的一整套"电影感产品宣传片操作系统"。

核心数字：

资产	数量	说明
镜头配方卡	106 张	每张含用途、时长、能量、参数表、已知坑、参考实现
动态样片	161 段	在线画廊可搜索预览，一键复制卡名
成品模板	1 支	Ink Press：36.2 秒、1920x1080、30fps、10 个完整镜头
音效资产	40+ 条	电影系 SFX（whoosh/impact/riser/sparkle）加 5 首 BGM
复用组件	7 个	PageCam（2.5D 运镜）、FlashCut、Caption、DigitRoll 等
审美准则	22 条	每条附真实用户反馈原文，含节奏、运镜、声音、文案、流程

作者 Vincent Wei（魏一昊），项目开源在 GitHub，Apache 2.0 协议，完全免费商用。

---

怎么安装

三种方式，从易到难：

方式一：直接让 AI 装（推荐）

在 Claude Code 里说一句话：

Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft

AI 会自动 clone 仓库、链接到 ~/.claude/skills/，全程不用手动操作。

方式二：用 npx skills CLI

npx skills add Vincentwei1021/video-shotcraft

方式三：手动克隆

git clone https://github.com/Vincentwei1021/video-shotcraft.git ln -s "$(pwd)/video-shotcraft" ~/.claude/skills/video-shotcraft

装完之后，在 Claude Code 里输入 Use video-shotcraft to create a promo for my product. 就能激活。

---

怎么用：三种模式

模式一：模板路线（最快，推荐入门）

skill 自带一支已验收的 36.2 秒成品宣传片模板——Ink Press（墨压）：纸墨琥珀风格，1920x1080、30fps，含 10 个完整镜头、2.5D 真实页面运镜、字卡、转场和已配好的电影级 SFX。

操作很简单：启动你的产品 dev server，skill 会自动截取页面截图和元素坐标，替换模板里的截图、文案和品牌信息，然后逐镜头适配渲染。从零到成片，换素材就能适配，最快路径还保质量。

模式二：自由创作

想要全新的视觉语言？skill 会按六阶段流水线推进：

阶段	内容	产出
阶段 0	开工三问（音乐选好了吗 / 模板还是自由 / 数据合规）	方向确认
阶段 1	素材采集	真实页面截图 + 元素坐标表
阶段 2	风格定调	色板、字体、动效风格
阶段 3	分镜设计	功能清单映射 + 能量曲线 + 时间轴
阶段 4	逐镜头实现	每个镜头 git commit + 静帧验收
阶段 5	声音设计	BGM + SFX 钉帧表
阶段 6	验收	独立 subagent 视觉审查 + 终渲成片

模式三：单镜头/单动效

只想要一个炫酷的卡片飞入效果？从 106 张配方卡里挑一张，或者在在线画廊里看着样片挑，skill 会读卡全文加对应的 demo 源码，把那个镜头做出来。

---

核心特点：这套"配方卡"强在哪

106 张镜头配方卡 = 106 种已验证的动效方案

每一张镜头卡不是"飞入效果"四个字那么简单，而是一份完整的工程文档：

卡名：deck-deal-flyin 一句话：暗场金属背景里的实体牌堆特写环绕开局，         拉远后一摞卡像发牌一样硬加速甩进网格 适用：展示"内容量大、源源不断汇入"的列表页与卡片墙 时长：约 2.6s 发牌段 + 可选 2s 牌堆特写 能量：高（节奏爬升段主力，不放开场第一镜） 参数表：orbit 环绕角度 | 堆叠高度 | 发牌节拍公式         单卡飞行路径 | 收尾拖拽层级 | 运动模糊…… 已知坑：抽象 flood 五轮不收敛，换"发牌"物理隐喻一轮通过 参考实现：template/src/aifl/live/SceneFlyIn.tsx

每张卡都附带可运行的 demo 代码——缓动曲线、时值配比这些参数是真实用户一轮轮调校出来的，不是你新写能复现的。

部分热门镜头卡：spotlight-hero-card（聚光主角卡）、brand-ink-open（墨线描画品牌开场）、document-typewriter-reveal（文档打字机揭示）、list-stack-press（列表堆叠压入加计数器落定）……

声音设计：产品宣传片的"好莱坞句式"

很多人做视频只关注画面，声音是最后才贴的。但 video-shotcraft 把声音设计提到了和分镜同等的地位：

• BGM 先选好定能量骨架，选强鼓点、强节奏的电子底

• SFX 用电影系词汇：whoosh（运镜）、impact（落地）、riser（铺垫）、sparkle（光效）

• 钉帧表用相对表达式管理，时间线平移自动跟随

• 结尾固定句式：riser → impact → sparkle，听感就是"产品发布会预告"

22 条审美准则：不是空洞的"做好看点"

每条准则都是规则 + 用户原话判例 + 自检问题三要素组成，来自多支宣传片实战返工的经验沉淀：

R1：品牌字标落定后 hold 满 1 秒。

   判例——用户说"开头和结尾的动画，出现后延长停留 1 秒"。

Q4：高光扫光不群发，一个镜头最多给主角一次。

   判例——用户说"不需要每个卡片都闪烁一下"。

22 条，每条都是真金白银的返工换来的。验收阶段用独立 subagent 拿着检查清单逐条审查，替代用户当人肉 QA。

真实页面截图，不手搓假 UI

这是 skill 最硬核的设计哲学之一：要做产品页面，第一步就起 dev server，用浏览器截真实页面。手搓 HTML 复刻真页面一眼睛假，整段报废。

---

和传统 Remotion 开发比，区别在哪

维度	裸用 Remotion	加 video-shotcraft
起步	空白画布，从 npx create-video 开始	一句自然语言指令，AI 自动导航
动效	手动查文档、调参数、踩坑	106 张配方卡 + demo 源码，参数已调好
声音	自己找音效，BGM 凭感觉选	40+ 条电影系 SFX + 5 首 BGM，钉帧管理
质量	自己看完交活	22 条审美准则 + 独立 subagent 审查
迭代	Claude 从零写代码，10-20 分钟/复杂镜头	换素材适配，效率提升 3-5 倍

video-shotcraft 本质上就是"Remotion on rails"——不是替代 Remotion，而是在上面加了一层"电影级产品视频的操作系统"。分镜、动效、声音、验收这四件事不再从零做起。

---

跟其他 AI 视频方案比

方案	定位	适合
Remotion 官方 Skills	Remotion 公司出品，动画入门	想从零学 Remotion
video-shotcraft	产品宣传片专用	想做高质量产品视频，不想从零设计
Hyperframes	抽象掉代码层	非开发者，追求"一句话出片"
wilwaldon Video Toolkit	工具箱型	多场景探索

video-shotcraft 的定位很清楚：它不是给非开发者用的傻瓜工具，而是给会用 Claude Code 的工程师用的专业加速器。你会写代码、会用终端、能跑 Remotion 渲染——但不想在动效设计、声音选型、审美调校上浪费生命。

---

上手体验：装完发生了什么

1. 说 "Use video-shotcraft to create a promo for my product."

2. skill 先问：用模板还是自由创作？音乐选好了吗？

3. 确认后，它自动启动你的 dev server，截图，生成风格图，排分镜表

4. 你确认分镜，它逐镜头实现——每个镜头完了自己跑截图自检

5. 画面锁定后铺 BGM 加钉 SFX，独立 subagent 审查，终渲成片

从"想做个宣传片"到拿到成片，全程不需要你手动写一行 Remotion 代码。 你不是在操作工具，是在扮演导演——做决策、给反馈、说 yes 或 no。

---

不能做什么：坦诚说清边界

skill 作者在文档里没有回避这一点——它的全部设计假设是"拍一个 web 或桌面产品宣传片"。

不适合的场景	原因
手机竖屏视频	全部参数表和模板基于 1920x1080 横屏
文稿驱动视频	它的输入是产品 dev server，不是文字
非产品类叙事	80% 的镜头卡是为 UI 页面设计的
零代码用户	它假设你会写 React 代码

但有三层资产是可以通用的：动效参数库（缓动曲线、时值配比和横竖屏无关）、声音设计方法论（40+ 条 SFX 加选型词汇表）、审美准则和验收体系（22 条准则中一半以上不挑内容形态）。

---

小结

Vincent Wei 做的这件事，本质上是把一个专业动效工作室的完整知识体系——镜头设计、参数调校、声音选型、审美判断、质量验收——编码成了 AI 可以直接消费的配方卡加模板加方法论。

AI 不会替代视频创作者。但会使用这套武器库的创作者，一定会替代不会用的。

# 30 秒安装，0 元商用 Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft

---

video-shotcraft — AI Video Skill for Claude Code & Codex, Apache 2.0 License

在线画廊：vincentwei1021.github.io/video-shotcraft