Individual skill

video-recap

从输入视频生成中文解说成片或原声剧情短片。用户提供 .mp4 / .mov / .mkv / .webm，并要求剪辑、添加旁白、配音、总结、短剧/电视剧/电影/纪录片/科普解说时使用。负责编排 video-* 技能链：视频理解 → Agent 制定故事与视听方案 → 剪辑 → 配音 → 合成。触发词：视频解说、视频旁白、生成解说、视频 recap、video recap、voiceover、narration、auto-dub、recap。

packages/knowledge/video-recap/skills/video-recap/SKILL.md

Read pinned source

Source commit ed56e4a3946fe7e6713b07164787a23128f6a848

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: No
Observed behavior: Not checked yet
Last checked: Nov 10, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 737
Repository last updated: Nov 8, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

ai-agents Repository topic
creative-writing Repository topic
deepseek-harness Repository topic
dsh-plugin Repository topic
fiction-writing Repository topic
novel-writing Repository topic
oh-story Repository topic
screenwriting Repository topic
short-drama Repository topic
drama-skills Repository topic
engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
SKILL.mdcore · 17,221 bytes
references/audio-routing.mddoc · 7,245 bytes
references/config-playbook.mddoc · 13,079 bytes
references/data-schema.mddoc · 36,172 bytes
references/resource-library.mddoc · 10,146 bytes
scripts/doctor.pyruns · 13,727 bytes
scripts/final_qc.pyruns · 15,918 bytes
scripts/lib.pyruns · 10,357 bytes
scripts/library.pyruns · 27,579 bytes
scripts/materials.pyruns · 14,006 bytes
scripts/recap.pyruns · 183 bytes
scripts/recap_cli.pyruns · 9,088 bytes
scripts/recap_inspect.pyruns · 18,630 bytes
scripts/recap_review.pyruns · 2,894 bytes
scripts/recap_runner.pyruns · 28,906 bytes
scripts/recap_runtime.pyruns · 12,639 bytes
scripts/recap_source.pyruns · 9,263 bytes
scripts/recap_stage_qc.pyruns · 2,828 bytes
scripts/recap_timeline.pyruns · 29,321 bytes
scripts/resources/__init__.pyruns · 200 bytes
scripts/resources/lock.pyruns · 7,157 bytes
scripts/resources/project_binding.pyruns · 15,025 bytes

Read excerpt


## 1. 定位与流程

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

```text
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` 记录的源视频路径、文件大小/修改时间与运行参数，拒绝复用来自其他源视频或其他参数的旧工作目录；视频理解产物也只在来源一致时复用。