Video Reference
按需把一部成片拆成可复用的制作参考：测镜头节奏与响度，标注段落与音轨分工，把原片事实与可迁移方法分开， 导出不含原片人名台词的...
Install
npx skills add zenstory-ai/video-recap-skills --skill video-reference -g -a claude-code -y- Repository
- zenstory-ai/video-recap-skills601
- Category
- Engineering
- Updated
- 5d ago
- License
- MIT
- Context cost
- Lightabout 1,267 tokens
- Runs scripts
- Yes, review before use
What it does
按需把一部成片拆成可复用的制作参考：测镜头节奏与响度，标注段落与音轨分工，把原片事实与可迁移方法分开， 导出不含原片人名台词的 production_reference.json 供下次制作参考。不在默认生产路径上。 触发词：拆片、拆解成片、制作参考、参考模板、production reference。
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. 流程
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
