Video Shotcraft

这是什么？

Video Shotcraft 是一个 Claude Code / Codex AI 视频 Skill。GitHub Vincentwei1021/video-shotcraft，3.5k Stars，296 Forks，MIT 许可证。

核心价值：106 张镜头配方卡 + 161 个动态预览 + 生产模板。Agent 用自然语言描述视频需求，Shotcraft 自动匹配镜头配方、生成 Remotion 代码、渲染视频。

适合谁：需要程序化视频生成的开发者、营销团队、AI Agent 开发者。

前置条件：Node.js 20+，Claude Code 或 Codex，Remotion 基础知识。

准备工作

安装

git clone https://github.com/Vincentwei1021/video-shotcraft.git
cd video-shotcraft
npm install

配置

在 Claude Code 中加载 Skill：

claude code --skill video-shotcraft

时间预算：安装 5 分钟，第一个视频 15 分钟。

三步上手

第一步：浏览镜头配方卡

ls cards/  # 106 张镜头配方卡

每张卡定义了镜头类型（推拉摇移）、时长、转场效果、推荐参数。

第二步：描述视频需求

在 Claude Code 中：

“创建一个 30 秒的产品宣传视频：开头 logo 渐入，中间产品功能展示，结尾 CTA 按钮”

第三步：渲染视频

npx remotion render src/index.ts --output video.mp4

常见踩坑

踩坑 1：Remotion 渲染速度慢

症状：1 分钟视频渲染超过 10 分钟。

原因：默认使用 CPU 渲染，未启用 GPU 加速。

解决：使用 --gl=angle（Windows）或 --gl=egl（Linux）启用 GPU 渲染。

踩坑 2：镜头配方卡参数冲突

症状：多个镜头叠加时出现闪烁。

原因：转场动画的时长参数冲突。

解决：使用 cards/transitions.json 中的预设转场组合，避免手动混搭。

踩坑 3：中文字体缺失

症状：中文文字渲染为方块。

解决：在 remotion.config.ts 中配置中文字体路径。

踩坑 4：Agent 生成的代码有语法错误

症状：渲染时报 TypeScript 编译错误。

原因：LLM 生成的 Remotion 组件代码不完整。

解决：使用 npx remotion typecheck 预检查，发现错误后让 Agent 修复。

踩坑 5：视频文件过大

症状：3 分钟视频超过 500MB。

原因：默认使用无损编码。

解决：使用 --codec h264 --crf 23 压缩视频。

FAQ

Q1: Video Shotcraft 是否免费？

A: 完全开源（MIT 许可证），免费使用。

Q2: 与 Hyperframes 有什么区别？

A: Shotcraft 基于 Remotion（React 组件），适合复杂动画；Hyperframes 基于纯 HTML，更轻量。

Q3: 支持哪些视频格式？

A: MP4、WebM、GIF、序列帧（PNG 序列）。

Q4: 能否自定义镜头配方？

A: 支持。在 cards/ 目录下创建自定义 JSON 配方文件。

Q5: 是否支持音频？

A: 支持背景音乐和 TTS 旁白，通过 audio/ 目录配置。

参考链接

• 官方 GitHub
• Remotion 文档

本文基于公开资料整理，AI 辅助生成，数据截至 2026-08-05。具体功能请以官方文档为准。