Video Sync：把分镜笔记与成片同步成一份可审阅视频

技能简介

Video Sync 是一款面向影视与视频分析场景的 Agent 技能，解决一个具体而常见的割裂问题：分镜笔记存放在结构化数据里，成片存放在视频文件里，两者各自独立，审阅时只能来回对照、手动掐时间点，效率极低。

这个技能把两者合二为一，生成一段"同步视频"——视频画面配上随播放进度联动的分镜信息面板，镜头切到哪里，对应的分镜说明就高亮到哪里。它基于 ffmpeg 与无头浏览器实现，不依赖额外的 npm 包，并会在有原声时保留原音轨。支持 Claude、Codex 与 Claude Code 等工具链。

核心能力

1. 读取分镜数据：解析 shots.json，把每一个镜头的细节与源视频逐一对位匹配。
2. 横屏布局：生成视频在上、信息面板在下的横屏版式，适合大屏审阅与投屏演示。
3. 竖屏布局：生成视频在侧、信息面板在旁的竖屏版式，适配移动端与竖版分发。
4. 逐帧同步高亮：在播放过程中，分镜明细行随剪辑点实时同步，当前镜头始终高亮。
5. 轻量技术栈：仅依赖 ffmpeg 与无头浏览器完成渲染，不引入额外 npm 依赖。
6. 保留原始音轨：当源视频带有音频时，合成结果会保留原音轨，便于同步听感判断。

安装配置

1. 安装技能：执行 npx skillstore add eternityspring/video-sync 将技能加入本地技能库。
2. 准备运行依赖：确保系统已安装 Node.js、ffmpeg 与 ffprobe，并准备 Chrome 或兼容浏览器作为无头渲染引擎。
3. 准备输入文件：把源视频与对应的 shots.json 放在同一工作目录，并确认二者描述的时长与内容一致。
4. 选择版式语言与缩略图目录：确定输出语言，并指定提供缩略图的 frames 目录，以便面板显示清晰的镜头截图。

使用步骤

1. 合并输入：用 video-sync 把源视频与匹配的 shots.json 组合，准备导出带注释的审阅视频。
2. 规划版式：先执行规划步骤，确定横屏或竖屏布局，并设置信息面板的比例参数。
3. 按需微调面板：当分镜描述较长时，调大面板比例以提升可读性，再渲染各帧面板。
4. 合成最终视频：用选定的设置把面板与视频合成为一份完整文件，并输出路径与分辨率信息。
5. 抽样校验导出：导出后在开头、中段、结尾各抽几帧检查，核对镜头对齐与高亮行是否正确，并汇总发现的错位问题。

适用场景

• 审阅镜头覆盖：生成同步参考视频，用于检查构图、节奏、运镜与画面连续性。
• 呈现分镜结论：在制作评审中，把分镜笔记直接挂在讨论到的那一帧上，沟通不跑偏。
• 审计视频分析：把结构化的分镜分析数据转化为可读交付物，用于研究、教学或归档。
• 教学与案例复盘：把分析数据与画面一起呈现，让讲解与画面证据一一对应。

适用人群

适合视频剪辑师、分镜与导演岗位、影视教学人员，以及需要把视频分析结果做成可交付材料的研究者。凡是"有一堆分镜笔记，却难以和成片对齐"的工作流，都可以用它。

工作原理

技能先读取 shots.json，把每个镜头的起止与内容提取出来，再调用 ffmpeg 抽帧、准备缩略图，随后由无头浏览器渲染出随播放进度变化的信息面板，最后把面板与源视频按时间轴合成为一段带同步高亮的成片。整个过程在本地完成，不依赖云端渲染服务，输出的是一份可以直接分发的视频文件。

注意事项

• 需要 Node.js、ffmpeg、ffprobe 以及 Chrome 或兼容浏览器。
• 要求 shots.json 与源视频的时长、内容相互匹配，否则同步会错位。
• 它不负责分镜检测、剪辑、转场、配乐或字幕，这些仍需其他工具完成。
• 分镜列表很长时，可能需要更大的面板或分段审阅。
• 不要用它来检测镜头或创建 shots.json；渲染成功也不等于分镜数据与素材一致。

官方链接

• Skill 详情页：https://skillstore.io/skills/eternityspring-video-sync
• 项目仓库：https://github.com/eternityspring/reelbench-skills