Vincentwei1021/video-shotcraft · 上手攻略

  • 仓库：Vincentwei1021/video-shotcraft
  • 链接：https://github.com/Vincentwei1021/video-shotcraft
  • 分类：AI 视频 · Agent Skill · Remotion
  • 作者：Jay
  • 更新：2026-08-01

这是什么

video-shotcraft 是一个 AI Agent 技能，专门用于让 Claude Code 或 Codex 变身电影感产品宣传片制作工作室。它提供 104 张镜头配方卡（shot recipe cards）、161 条动态预览、161 种运动风格，以及一套经过实战验证的六阶段制作流水线。底层渲染引擎是 Remotion（用 React/TSX 写视频），成品是 1920×1080 / 30fps 的 mp4，包含 2.5D 运镜、真实页面截图、节拍同步剪辑和电影级音效。

它的核心价值是把"用 AI 做产品视频"这件事从玄学变成可工程化的流程：每颗镜头都有经过调校的参数（缓动曲线、时长、进场时机），不是凭空生成，而是像调色板一样按需选用。

解决什么问题

做产品宣传片有三条路：

方案 速度 质量 可控性
手工 AE/PR 慢 高 高，但人力贵
AI 视频生成（Sora等） 快 不稳 低，细节难控
video-shotcraft（Remotion） 中 高且稳 高，参数全透明

video-shotcraft 走的是第三条路。它解决了"AI 生成的视频产品感不强、细节不可控"的问题——用真实产品截图 + 可调参数的镜头模板 + 完整音频库，让 AI 代理能像专业动效师一样系统地制作宣传片，而不是抽奖。

快速安装

方式一：直接甩给 Agent（最推荐）

在 Claude Code / Codex 中直接说：

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

Agent 会自动 clone 仓库并 link 到 skills 目录。

方式二：CLI 手动安装

npx skills add Vincentwei1021/video-shotcraft

方式三：手动软链

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

本地渲染依赖（Linux 无头渲染时）

# 如果遇到 Chrome 启动问题，安装 chrome-headless-shell：
# --browser-executable=./chrome-headless-shell
# 低配置机器加 --concurrency=1

核心用法

1. 用自然语言驱动 Agent

安装后，直接告诉它你要做什么：

Use video-shotcraft to create a promo for my desktop product.
Use the deck-deal-flyin and row-embed shot cards to present this feature.

Agent 会自动读取 skill 文档，按流水线工作。

2. 从在线画廊挑镜头

访问 https://vincentwei1021.github.io/video-shotcraft/（官方 Gallery），可以搜索/筛选 161 条动态预览，选好心仪的镜头后把名字丢给 Agent：

Use video-shotcraft with the "deck-deal-flyin" and "spotlight-hero-card" shots.

Agent 负责解析卡名、读取配方卡和 demo 源码、实施到目标产品。

3. 用现成模板（最快出片）

Ink Press 模板：36.2 秒、1920×1080、30fps、10 个镜头，已验证可交付。

# 在 Agent 里说：
Use video-shotcraft to make a promo for my product with the Ink Press template.

Agent 会保留原有镜头结构，只替换截图、文案和品牌色——这是风险最低、出片最快的路线。

4. 三种制作模式

模式 说明 何时用
直接用模板 Ink Press 模板路线，换产品素材 想快速出片，风格合适
自主自由创作 Agent 全权决定，不逐阶段确认 授权 Agent 自主探索
共同创作（Co-creation） 关键节点交用户确认 想参与方向决策

用户没有指定模式时，Agent 会先做一次只读产品检查，然后推荐最适合的制作模式。

5. 镜头配方卡体系（核心资产）

104 张镜头卡覆盖 10 个功能类别：

  • 卡片结构：用途、能量、建议时长、参数、实现笔记、已知坑
  • 使用方式：从 references/shots/ 选卡 → 读卡片全文 → 按"参考实现"找对应 demo TSX → 复制到 Remotion 项目
  • 命名规则：Gallery 卡名用 gallery/api/library.json 校验，支持 卡名 · 样式名 格式

6. 音频资产

assets/audio/
├── bgm/          # 5 个节奏感强的 BGM 备选
└── sfx/          # 149 个音效，分 16 类
                  # 类别：transition / impact / riser / camera / ui / text /
                  #       paper / film / light / data / scifi / mech / glass /
                  #       fluid / crowd / counter

选音效时先定位类别，再进目录试听。SFX 全部免费商用（见 audio/ATTRIBUTION.md）。

典型适用场景

  • Web/桌面产品宣传片：产品发布、Launch、官网首页 Banner 视频
  • 功能演示动画：单个镜头卡可以直接抽出来做功能点展示
  • 品牌电影：Ink Press 等模板适合需要统一视觉调性的产品线
  • AI Agent 产品展示：本身就是 Agent skill，做 AI 产品展示自己的宣传片（meta 感拉满）

坑与注意

⚠️ Linux 无头渲染三件套

在 2核 Linux（Node 22）上渲染会遇到三个典型问题：

  1. Maximum concurrency is 2 报错 → 加 --concurrency=1
  2. Chrome 启动失败（old headless 已废弃） → 用 chrome-headless-shell 替代完整 Chrome
  3. remotion.media CDN 被墙 → 加 --browser-executable=./chrome-headless-shell

完整渲染命令示例（Linux 无头）：

npx remotion render src/index.ts AiflPromo out/promo.mp4 \
  --concurrency=1 \
  --browser-executable=./chrome-headless-shell

⚠️ 以上 Linux 渲染参数为根据文档整理，真实环境可能因 Node/Remotion 版本不同略有差异，建议先跑 npx remotion still 验证单帧。

⚠️ 不要手搓 UI 来复刻已有页面

SKILL.md 明确规定：复刻既有页面必须用真实截图，手搓 UI 只用于非复刻场景。质感差距是硬伤。

⚠️ 素材数据安全

产品截图中的客户、个人、密钥、实时数据，必须先用虚构或脱敏内容替换，再进行素材采集。

⚠️ Parakeet TDT 引擎（v2）英文限定

如果支持 WhisperKit fallback（large-v3-turbo）尚未上线，其他语言的视频配音/字幕转写暂时无法支持。

⚠️ 渲染成品交付两版

有 BGM 的成片，Remotion 渲染时用 bgm inputProp 可以同时输出"带 BGM 版 + 无 BGM 版（保留 SFX）"，方便用户后期替换音乐。

与同类对比

工具 类型 视频质量 参数可控性 学习成本
video-shotcraft Agent Skill / Remotion 高（工程化） 极高（配方卡参数全透明） 中（需了解 Remotion）
Sora / Runway AI 生成视频 不稳定 低 低
手工 AE/PR 传统软件 高 高，但慢 高
Capcut AI 短视频剪辑 中 中 低
Remotion（原生） 视频编程 高 高但需手写 高

video-shotcraft 的独特价值：它是目前唯一一个把"镜头语言"做成结构化知识库、并让 AI Agent 能系统选用和组合的工具。Remotion 原生需要写代码；shotcraft 把经验固化成 104 张卡，降低了 AI 犯低级动效错误的概率。

一句话结论

如果你已经在用 Claude Code / Codex 做产品开发，想要一个可工程化、质量稳定的电影感产品视频工具，video-shotcraft 是目前最完整的开源解决方案——104 张镜头卡 + 完整音频库 + 六阶段流水线，把 AI 视频制作从玄学变成配方作业。

参考来源

  • GitHub README：https://github.com/Vincentwei1021/video-shotcraft
  • SKILL.md（Agent 入口与制作规范）
  • references/pipeline.md（六阶段制作流水线）
  • Gallery 在线预览：https://vincentwei1021.github.io/video-shotcraft/
  • YouTube 示例片：https://youtu.be/gcVvRM_P3SM（Gallery intro）、https://youtu.be/iShab28B_ak（Ink Press 模板）