# Video Reference

按需把一部成片拆成可复用的制作参考：测镜头节奏与响度，标注段落与音轨分工，把原片事实与可迁移方法分开， 导出不含原片人名台词的...

- Repository: https://github.com/zenstory-ai/video-recap-skills (601 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add zenstory-ai/video-recap-skills --skill video-reference -g -a claude-code -y`
Codex: `npx skills add zenstory-ai/video-recap-skills --skill video-reference -g -a codex -y`
Cursor: `npx skills add zenstory-ai/video-recap-skills --skill video-reference -g -a cursor -y`
Gemini CLI: `npx skills add zenstory-ai/video-recap-skills --skill video-reference -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add zenstory-ai/video-recap-skills`

## Description

按需把一部成片拆成可复用的制作参考：测镜头节奏与响度，标注段落与音轨分工，把原片事实与可迁移方法分开， 导出不含原片人名台词的 production_reference.json 供下次制作参考。不在默认生产路径上。 触发词：拆片、拆解成片、制作参考、参考模板、production reference。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 1. 定位

本技能把一部**已完成的成片**拆成下一次制作可参考的方法与数值，按需在本地运行。它只写自己的测量、标注与导出物，不调用 MiMo，也不对生产流程评分或拦截。

Agent 的角色是**拆片编辑**：先如实记录"这部片子怎么做的"（事实），再提炼"换一部素材还能怎么用"（方法）。
两者必须分开：事实只留在本地工作目录，导出物只含方法和测得的数值。

## 2. 输入

- 成片文件（`.mp4 / .mov / .mkv / .webm`）。
- 对**这部成片**跑出的视频理解产物目录 `U`（建议 `ASR_SEGMENT_SECONDS=5`，窗口越短，旁白语速越准）。
  本技能读取其中可选的 `asr_result.json`、`asr_timing_evidence.json`、`background_research.json`、`understanding_index.json`
  （其 `characters` 的名字、别名与 ASR 提及都进入人名泄漏扫描）；
  标注时 Agent 还应看故事板 / contact sheet 与 `vlm_analysis.json`。

没有理解产物也能跑，但旁白语速为空，泄漏扫描只剩 Agent 自己写的 `entities`，check 会给出警告；
看画面可用 `frames --span 0,<时长> --step 2` 生成的抽帧拼图。

下面的 `scripts/...` 均相对于本技能目录。

## 3. 流程

```bash
python3 scripts/reference.py measure <成片> --work-dir U        # 一次 ffmpeg：切点 + 响度，按文件身份缓存
python3 scripts/reference.py frames  <成片> --work-dir U --review          # 逐帧看被压下的疑似切点
python3 scripts/reference.py frames  <成片> --work-dir U --longest 5       # 看最长镜头里有没有漏切
python3 scripts/reference.py check   --work-dir U [--json]      # 校验并打印派生值
python3 scripts/reference.py export  --work-dir U --out <下次运行的 work_dir>/production_reference.json
```

The rest: https://github.com/zenstory-ai/video-recap-skills/blob/HEAD/skills/video-reference/SKILL.md