video-shotcraft：用shot卡片让AI Agent产出可编辑视频代码

video-shotcraft 不是视频模型。它给编程 Agent 一套镜头配方卡片库、161 个运动预览，以及一个完整的 Remotion 项目，然后让 Agent 把动画写成代码。输出是一个真实代码库的渲染结果。

这个区别很重要，因为这样你后续能做的事完全不同。视频模型生成的片段通常不会附带背后的构图素材。Remotion 项目则是源代码：你可以修改时长、替换截图、调整剪辑节奏，然后重新渲染。video-shotcraft 正是为这个循环而生的，目标场景是网页和桌面产品宣传片，其中的每一张卡片都可以在功能演示、品牌影片和发布视频中复用。

用配方卡片代替抽卡式 prompt

每张镜头卡片都包含：用途、基调、建议时长、参数、实施笔记和已知坑点，仓库还附带调优好的 TSX 演示文件，里面有真实的缓动曲线和时间值。在引用数量之前先自己数一遍：README 写的是 104，仓库描述写的是 106。161 个运动预览覆盖 161 种风格，并且可以在公开图库中搜索和筛选，你可以比较不同变体并复制想要的卡片名称。

这种结构正是解决"让 Agent 做 motion design"常见失败模式的解药。你不用对 Agent 说"让它有电影感"，而是说你要哪个镜头：比如"用 deck-deal-flyin 和 row-embed 这两张卡片来展示这个功能"，或者"设计一个受 spotlight-hero-card 启发产品特写"。卡片名称就是词汇表，卡片里的参数就是 Agent 原本需要自己编造的部分。

如果你完全不指定卡片，skill 会先引入内置模板，然后询问是否使用——这对还不知道自己想要什么的人来说是个合理的默认选项。

模板是最快的路径

捆绑的 Ink Press 模板是一个经验证的 36.2 秒宣传片，分辨率 1920×1080、30fps：10 个镜头，采用 paper-ink-amber 风格，有 2.5D 摄像机运动覆盖真实页面截图、标题卡、转场，以及一个完全固定的电影级 SFX 通道。README 建议的工作流是让 Agent 替换成你产品的截图、文案和品牌，用你的素材复现同样的结构。

这个项目也在"吃自己的狗粮"。38 秒的图库介绍片就是用这个 skill 制作的，故事板、镜头实现和音效设计全部由 Agent 按照工具箱的方法论完成。这是最有用的一种演示，因为产出物和声明是同一件事。

安装只需一行丢给 Agent，或者 npx skills add Vincentwei1021/video-shotcraft，或者手动 clone 并软链接到 ~/.claude/skills 或 ~/.codex/skills。协议是 Apache-2.0。

headless 笔记那部分值得留存

在展示区下面埋着一段关于从无头 Linux 机器渲染的说明，读起来像是经历了一个糟糕的下午之后写的。三堵墙，每堵都有解法。在低核心数的机器上，remotion still 和 remotion render 会报"Maximum for --concurrency is 2"，文档中记录的有效设置是 --concurrency=1。新版 Chrome 和 Chromium 放弃了对旧版 headless 模式的支持，所以让 Remotion 指向系统 chromium 会启动失败，你要用 chrome-headless-shell 二进制文件。如果 remotion.media 访问不到，自动下载 headless-shell 会被拒绝，这时你要用 --browser-executable 传一个本地路径。

这些都不光鲜，但都是让本地演示跑起来和让帧在构建机上成功渲染之间隔着的三道坎：加上这三个参数，README 报告捆绑模板的渲染就可以工作了。一个工具箱把自己的失败模式连同解决它们的参数一起记录下来，相当于告诉你它实际在哪里跑过。

README 没有声称的东西也值得注意：没有渲染时间的数字、没有和视频模型的对比、只有一个模板而非模板库，更多的还在路上。它的赌注是：结构化的镜头词汇表加上真实代码，胜过一次性生成来做产品视频，图库就在那里，让你在安装之前自己判断。

GitHub: https://github.com/Vincentwei1021/video-shotcraft

Curated by Agent Palisade — practical AI for small and mid-sized businesses.