Video Recap
从输入视频生成中文解说成片或原声剧情短片。用户提供 .mp4 / .mov / .mkv / .webm，并要求剪辑、添加旁白、...
Install
npx skills add zenstory-ai/video-recap-skills --skill video-recap -g -a claude-code -y- Repository
- zenstory-ai/video-recap-skills601
- Category
- AI and agents
- Updated
- 5d ago
- License
- MIT
- Context cost
- Mediumabout 2,358 tokens
- Runs scripts
- Yes, review before use
What it does
从输入视频生成中文解说成片或原声剧情短片。用户提供 .mp4 / .mov / .mkv / .webm，并要求剪辑、添加旁白、 配音、总结、短剧/电视剧/电影/纪录片/科普解说时使用。负责编排 video-* 技能链：视频理解 → Agent 制定故事与视听方案 → 剪辑 → 配音 → 合成。触发词：视频解说、视频旁白、生成解说、 视频 recap、video recap、voiceover、narration、auto-dub、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 音轨。
组合只有下面几条路径，其余组合在启动时直接报错：
| 输入 | --edit-mode | --audio-mode | Agent 暂停点 | 流程 | 详见 |
|---|---|---|---|---|---|
| 单视频 | full | narration | 1：narration.json | 理解 → 写稿 → 校验 → 配音 → 合成 | §4 |
| 单视频 | cut | narration | 2：clip_plan.json，再对着成片写 narration.json | 理解 → 剪辑 → 重建输出时间 brief → 写稿 → 配音 → 合成 | §4 |
| 多视频 | cut | narration | 2：同上，clip 必须带 source_id | 逐源理解 → 剪辑 → 写稿 → 配音 → 合成 | §4.3 |
| 单视频 | full | source-mix / adopted-packet-copy | 无 | 直接合成当前整段 | §4.7 |
| 单 / 多视频 | cut | source-mix / adopted-packet-copy | 1：clip_plan.json | 理解 → 剪辑 → 合成，不写稿 | §4.7 |
| 单视频 | dub | narration | 1：dub_script.json | 英文转写 → 译稿 → 克隆音色整轨替换 | §5 |
| 已剪好的母版 | full | narration + 三个采用 JSON | 无 | 只做严格合成 | 下文 |
所有 full/cut 路径共用同一段收尾：（有旁白时）评审 → TTS → 合成 → 成片 QC。使用原声模式时读
references/audio-routing.md。
已有预制画面和本地采用的完整声音三件套时，可走严格 assembly-only 路径：
python3 scripts/recap.py picture.mp4 --edit-mode full --work-dir NEW_WORK \
--output-dir DELIVERY \
--tts-meta tts_meta.json \
--narration-adoption narration_adoption.json \
--audio-mix-adoption audio_mix_adoption.json
