Video ShotCraft：电影感产品视频制作技能
让 Claude Code / Codex 变成动效工作室：用 157 张镜头配方卡、Remotion 模板和声音设计，把产品网页变成一支电影感宣传片。
SKILL.md 明确最小只读产品检查、敏感数据冻结脱敏、确认节点、禁随机种子等安全规则，数据流透明度高；扣分点：发布引导含作者社交账号推广与 showcase 提交（外发用户内容），Windows 剪映路径未真机验证，回滚机制与权限范围未成文。
工作流自洽、确定性渲染规则明确、headless 三坑有解决参数、CI 含 tsc+vitest+冒烟渲染；扣分点：静态审查无法执行复现，剪映 Windows 路径自认未验证，失败反馈质量未见异常输入用例。
触发条件写得很具体（点名 skill、模板、镜头卡三种语义触发），三种模式边界与不适用场景清晰，中文文档完善，且明确披露 remotion.media CDN 在大陆可能被墙及本地替代方案；扣分点：样片画廊依赖 GitHub Pages 下载，大陆可达性存在残余风险。
分层文档结构清晰（SKILL→references→demos），含 LICENSE（Apache-2.0）、音源 ATTRIBUTION、致谢与商标声明、changelog 式更新记录；扣分点：未验证发布者身份与维护承诺成文程度，SKILL.md 数字（157 卡/214 样片）与描述（152/209）不一致。
提供已验收模板、可复制组件、音频资产与测试/CI 证据，模板可用 npm install+render 复现，边际价值明显高于手动制作；静态审查下代表输出（成片质量）无法独立验证，按上限 7 封顶。
仓库含 CI 工作流（pr-checks.yml）、vitest 单测与 demo 冒烟渲染脚本，事实与推断基本分离；扣分点：静态审查未执行，测试对 SKILL.md 关键制作路径（采集、分镜、渲染全链）覆盖有限，多重独立佐证不足。
- 发布引导环节会把用户成片/账号信息导向作者的外部 showcase（GitHub issue 表单），使用前请知悉并自行决定是否提交。
- remotion.media CDN 与 GitHub Pages 在中国大陆可能不可达，需准备本地 chrome-headless-shell 与离线样片。
- 剪映导出的 Windows 路径作者自述未经真机验证，Windows 用户应先跑 smoke_test.py。
- Remotion 本身有独立商业许可，公司使用前需确认授权。
- SKILL.md 与 README 的卡片/样片数量口径不一致（157/214 vs 152/209），以实际仓库为准。
这个 Skill 能做什么，适合哪些场景？
video-shotcraft 是一个 AI Agent Skill，面向 web/桌面产品的宣传片制作。它内置 157 张镜头配方卡（214 种样式、214 条动态样片）、一支已验收的 36.2 秒 Ink Press 完整模板、可复用 Remotion 组件与 149 个音效资产。技能支持三种模式：直接套模板、Agent 自主自由创作、或与用户逐阶段共同创作。核心方法论强调真实页面截图、视觉语言从产品设计系统生长、卡点剪辑、确定性渲染与独立终检。
技能读取 SKILL.md 与 references/ 下的配方卡、流水线、审美准则等文档；对目标产品做最小只读检查后，用无头浏览器截取真实页面 2x 全页纹理与元素级抠图，写 layout. 坐标表；再按选定模式生成产品简报、分镜与 Remotion 工程，复用 demos/ 中调校过的 TSX 实现；渲前用 librosa 做节奏分析、渲后回测切点误差，最终渲染成片并可选导出剪映工程或在浏览器动效工作台继续编辑。
- 独立开发者要在发布日为自己的 web/桌面产品快速出一支宣传片，直接走 Ink Press 模板路线换素材
- 营销团队想要全新风格的 launch video，授权 Agent 自主完成从产品理解到成片的全流程
- 品牌方希望深度参与分镜决策，选共同创作模式逐阶段确认产品简报、视觉方向与最终分镜
- 视频创作者只想给已有视频加一个高质量单个动效镜头，从画廊挑卡单独抽取使用
- 剪辑师交付后想继续微调，导出剪映工程或在动效工作台里改字卡、变速、替换音频
这个 Skill 有哪些优点和局限？
- 资产规模大且已调校：157 张配方卡配准确 demo 源码、214 条动态样片可在线预览挑选
- 方法论完整：真实截图采集、设计 token 蒙皮、librosa 卡点分析、独立 subagent 终检都有明确规范
- 附带完整可渲染模板与 149 个免费商用音效，开箱即可出片
- 交付后生态完善：动效工作台可视化编辑、剪映工程导出、双版本（带/无 BGM）渲染
- 强依赖本地工程环境：需要 Node.js、Remotion、Python 3、无头浏览器，纯 API 调用方需自行补 shell
- 剪映导出仅在 macOS 剪映 11.2 真机验证过，Windows 模块未真机测试
- BGM 商用需注意 Remotion 独立许可——个人与小团队免费，公司可能需付费
- 模板内置截图仅为演示素材，发布前必须替换为目标产品截图并做数据脱敏
如何安装这个 Skill？
最直接方式是把仓库链接交给 Agent：在 Claude Code / Codex 里输入 "Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft"。或手动安装：git clone https://github.com/Vincentwei1021/video-shotcraft.git 后，执行 ln -s "$(pwd)" ~/.claude/skills/video-shotcraft（Claude Code）或 ln -s "$(pwd)" ~/.codex/skills/video-shotcraft（Codex）。也可用 npx skills add Vincentwei1021/video-shotcraft。
如何使用这个 Skill？
安装后在 Claude Code / Codex 中直接发指令，例如："Use video-shotcraft to create a promo for my desktop product."（模板模式可加 with the Ink Press template）；指定镜头则说 "Use the deck-deal-flyin and row-embed shot cards to present this feature."。若未指定模式，Agent 会先做最小只读产品检查并介绍三种模式供选择。可先到在线画廊 https://vincentwei1021.github.io/video-shotcraft/ 浏览样片挑镜头。渲染需 Node.js 环境；无头 Linux 机器需加 --concurrency=1 并使用 chrome-headless-shell。
这个 Skill 与同类方案有什么区别？
源材料未提及其他同类技能或竞品，无可对比项。同系列的 video-talkcraft 面向口播解说视频（78 张卡片、词级时间戳对齐），与本技能专注产品宣传片形成互补而非竞争。