video-recap

1. 定位与流程

本技能是五个独立技能的轻量编排器。各技能只通过 work_dir 中的 JSON / MP4 产物通信，不共享代码：

video-understanding ─▶ Agent 按 video-script 制定方案并写稿 ─▶ [video-cut] ─▶ video-voiceover ─▶ video-assemble

把成片拆成制作参考不是生产路径。用户要求时：对成片跑 video-understanding（建议 ASR_SEGMENT_SECONDS=5）， 再用 video-reference 做 measure、标注、check、export，把导出的 production_reference.json 复制进下一次运行的 work_dir，或登记成资源库的 production_reference 模板、采纳后经 --project 绑定。recap 不会自动运行它，也不拿新成片与参考做比对。

流程支持断点续跑：写好 narration.json 后重复同一条命令即可继续。第二阶段会比对 recap_run_manifest.json 记录的源视频路径、文件大小/修改时间与运行参数，拒绝复用来自其他源视频或其他参数的旧工作目录；视频理解产物也只在来源一致时复用。 暂停时打印的续跑命令就是原命令：保留原来的写法，视频与路径参数转成绝对路径，补上 --work-dir 和来自环境变量的设置，从任何目录都能直接运行；同一份参数写在 manifest 的 argv。

画面流程 --edit-mode full|cut|dub 与声音策略 --audio-mode 是两个独立开关； narration 保留上述解说流程，source-mix 不做配音，adopted-packet-copy 冻结当前输入的已采用 AAC 音轨。 组合只有下面几条路径，其余组合在启动时直接报错：