zenstory-ai/video-recap-skills / skills/video-recap
video-recap
Verified把一段或多集视频做成带画框字幕的中文解说成片或纯原声高光短片。用户提供 .mp4 / .mov / .mkv / .webm,要求做影视解说、短剧二创、加旁白配音、跨集混剪或导出剪映草稿时使用;串联完成看片识台词、定主线与留原声、按台词停顿切镜头、写词检查、TTS 配音与混音加字幕。触发词:视频解说、影视解说、视频旁白、生成解说、视频 recap、video recap、voiceover、narration、recap。
references/creative-editing-playbook.md
View on GitHub# 创作剪辑工作法
写 `clip_plan.json` 或 `narration.json` 前,先把故事主线、选镜理由与声音分工定好写进计划文件。
## 先判断创作控制模式
- **CREATE**:从零构建新成片。主线明确时直接写 1 个选定方案即可;仅当源片存在多种剪辑角度(例如顺叙步步揭底对比冷开场倒叙)需要权衡时,比较 2–3 个候选假设再择优。
- **DIRECTED**:用户已指定结构、镜头、台词或语气,按指定方向准确落地,不另编备选方案。
- **REVISION**:用户看片后提出返修意见。最新反馈覆盖旧决定,未点名的部分保持不变。
`REVISION` 模式下先列清“本轮修改项”和“冻结项”:口播文风或字幕断行调整写回 `style_card.json`,选镜出入点与声音主导权写回 `visual_audio_board.json`;只有主视角或核心节拍变化时才改 `recap_story_plan.json`。删掉某个镜头或某句词时同步清理旧锚点,改完逐条核对修改项已落实、冻结项未受影响。
## 决策优先级
两条事实与听感底线优先于一切修辞:
1. **事实有据**:人物身份、关系、前因后果与结局须有画面、对白、背景资料或用户说明支撑,不凭空编造。
2. **声音清晰**:关键原声对白不半句截断,旁白也不盖住观众必须听清的那句原话。
在此之上,不同诉求冲突时按以下顺序取舍:人物状态与情绪反应 → 因果推进 → 轻重快慢呼吸 → 视线与动作连贯 → 机械工整对齐。宁可让时长略微浮动,也不为了凑整数秒而裁掉人物变脸、顿住或哽咽的那半秒。
## 五项核心判断
### 1. 导演:明确观众看什么
落笔前先定六个问题:
- **观众承诺**:观众点进来看完能看明白什么冲突、获得什么情绪体验?
- **主视角**:全程贴着谁的处境推进?谁是对立面或旁观者?
- **核心悬念**:哪条疑问牵着观众一直看到结尾?
- **情绪弧线**:开场是什么气氛,经过哪几次转折,最后落在什么余韵上?
- **藏牌与亮牌**:哪条关键信息先压住不表,留到哪一拍揭晓最有分量?
- **结尾余味**:最后一幕定格在什么动作、眼神或原声余音上?
计划文件只记结论与取舍理由,不写长篇推导。
### 2. 故事编辑:用局势变化组织节拍
每一拍对应一次**实打实的局势、关系或筹码变化**。留下的每一拍,至少推进以下一项:知情范围变化、角色当前目标变化、强弱态势翻转、人物关系进退、场面气氛转折或风险代价升级。
抽掉某一拍后若因果链与人物状态毫无损失,说明是过场戏,直接删去;但删过场时要保住触发翻脸的前提(可挑一句关键原话或用半句旁白点明起因)。开场抛出的悬念必须在正片兑现,不夸大其词,也不让结尾落空。
不可误裁的源片时刻可登记进 `clip_plan.json.required_evidence`:`nodes` 填写唯一 `id`、源视频绝对路径 `source`、源片秒数 `start/end`、`track`(`audio` 或 `video`)与 `content`(多视频时补填 `source_id`),`before` 用 `[前提id, 回应id]` 声明先后顺序。只登记核心的几秒证据即可。
### 3. 画面剪辑:选准动作与反应瞬间
逐拍检查入出点与画面取舍:
- **晚进场,按需冷开场**:默认顺时序从冲突触发动作或关键台词切入,省掉进门寒暄。仅当正序冲突出现较晚时前置一段冷开场悬念镜,时长随动作自然收住,做到不靠铺垫也能看懂、不与正片重复同一机位、只留悬念不提前泄露结局。
- **保留反应镜**:台词落音或冲突发生时,对面缩紧的瞳孔、僵住的手或沉默反打往往比说话人正脸更有戏,不因镜头短而误删。
- **旁白底下避开“张嘴消音感”**:旁白压低原声时,优先切听者反应、手部动作、道具特写或稳态画面,避免角色正脸连续张嘴说话却听不见声音;同款点头或发呆反应镜避免反复重用。
- **干净切点与收尾气口**:切入新场景或情绪骤变段时可先给画面留半秒立住人物再进旁白;出点落在动作收势、表情定格或台词落音之后,片尾最后一拍留足余韵气口,不在原片叠化或闪白正中间下刀。
- **有一分画面说一分话**:镜头只拍到挨了一拳,文案就不写成当场昏死;不同场次的镜头只做平行对照或呼应,不硬拼成同场假因果。
遇到画面频繁跳切的段落,先用 ffmpeg 的 scene 滤镜定位候选切点:
```bash
ffmpeg -i input.mp4 -vf "select='gt(scene,0.35)',showinfo" -an -f null -
```
闪光灯、叠化和快速摇镜也可能触发高分,需对回源片区间与拼接边界后分类处理:
- **原片切点**:与主线无关的碎镜头按完整原片镜头整段删除;与主线相关但过短的镜头,顺着原片前后多保留真实源素材,把完整动作、反应或台词包进来,少用定格或慢放硬凑。
- **本次剪辑制造的切点**:微调入出点、恢复同源镜头的连续运动、合并原本相邻的片段,或换用自然过渡镜头;叠化、闪白和包装花字不能用来遮掩坏接点。
- **原片有意的快切蒙太奇**:仅当每个短镜头都提供新信息且原速播放清晰易读时保留,否则按碎镜清理。
### 4. 声音与旁白:先定主导音轨,再动笔写词
动笔前先在 `visual_audio_board.json` 为每拍指定声音主导方(`audio_owner`):
- `original_dialogue`:角色亲口说的关键台词本身就是戏眼;
- `action_sound`:耳光、摔杯、推门、枪响等动作音响直接推进冲突;
- `ambience` / `music`:环境声或配乐烘托现场气氛;
- `silence`:沉默僵持或欲言又止本身更有张力;
- `narration`:单靠画面与原声交代不清前情、利益关系或潜台词,需由解说补足。
旁白任务(`narration_job`)从六项中选择:`context`(补画面外关系与前情)、`causal_link`(衔接剪辑跨度因果)、`foreshadow`(埋伏笔)、`interpretation`(结合细节揭示动机与代价)、`transition`(交代时空转换)、`none`(不写旁白)。“七成解说、三成原声(7:3)”只是素材缺乏明显声画主次时的粗略参考,并非配额。
#### 口播写作准则
像熟悉来龙去脉的讲述者盯紧场面推进,不写公文汇报或阅读理解式点评:
1. **起手直给“具体处境 + 身份或利益反差”**
- 不写空泛帽子或人物履历,第一句直接摆出场合、动作与反差。
- 例:`除夕家宴上,她刚做完脊椎手术扶着墙进门,亲妈非但没扶一把,反倒扯下她的护腰逼她进祠堂磕头。`
2. **用具体动作和当场后果代替抽象总结词**
- 删掉“这是一场关于……的较量”“让权力与骄傲退场”“完成认知闭环”“命运的齿轮”等套话。
- 例:不写“生死关头的承诺让权力与骄傲退场”,改写为“平日一句话定人生死的长公主,此刻攥紧他染血的衣袖,只求他活着回家”。
3. **按片长控制人物点名密度**
- 60 秒内短片点名 1–2 个核心角色即可,其余人物用关系或身份称呼(如“前女友”“她上司”“太医”);3–10 分钟中长解说随主线推进自然点出关键人物真名与立场。
4. **重要画面必有声画呼应,结局交给画面演完**
- 出现扇耳光、下跪、亮信物等关键动作时,须由原声或紧邻旁白交代原因。结局由画面与原声当场落定,不在结局演完后再补总结升华旁白,也不在收束旁白后拖一段重复同义的原声尾巴。
5. **原声前后“垫半句、让半句、接半句”**
- 原声开口前用完整收句垫明利害;原声说话时旁白彻底让开;尾音落定后接半句点明后果,不重复原声台词,也不用破折号悬半截引子。
6. **自然口播长短句与纯器乐配乐**
- 每块旁白按“处境 → 动作 → 后果”写成连贯句子,靠精炼字数匹配窗口;外部配乐只选无歌词纯器乐,原片已有高音量人声插曲时不再叠外部配乐。
### 5. 观众复核
初稿完成后做三遍自检:
1. **关旁白看画面与原声**:核心冲突与翻脸节点光看画面和原声能否看懂主体脉络?
2. **闭眼纯听音轨**:旁白连同原声听起来是否自然连贯,有无碎句电报腔或突兀抢话?
3. **首尾兑现检查**:开场抛出的悬念推进是否连贯,结尾是否真正落定?
交付前务必原速通看最终渲染出的成片文件,逐个检查拼接点并闭眼通听混音。
## Agent 创作产物
以下两份 JSON 用于记录创作决定,保持各阶段选镜与写词一致。
### `recap_story_plan.json`
```json
{
"schema_version": 1,
"director_intent": {
"viewer_promise": "60 秒看懂一对昔日恋人如何在叔嫂名分下嘴硬试探、步步失守",
"pov": "以男主裴钧庭视角切入重逢冲击,中段补入女主沈清欢独处与盛汤细节形成双向拉扯",
"dramatic_question": "死而复生变成未来大嫂的沈清欢,是真绝情还是另有隐情?",
"emotional_start": "死去三年的恋人挽着亲哥现身时的错愕",
"emotional_end": "高烧梦话喊出别嫁给他时的失控",
"ending_aftertaste": "名分上逼自己改口叫大嫂,本能却在病中露了底",
"withhold_reveal": "前半段先立住她划清界限的冷硬,再用雪人与热汤细节反转"
},
"hypotheses": [
{"id": "h1", "spine": "紧扣当众叫大嫂、私下步步失控的单线拉扯", "opening": "葬身火海三年的恋人挽着亲哥进门成了未来大嫂", "ending": "高烧梦话喊出别嫁给他,清醒后抽手僵持", "risk": "需在中段补足女主独处细节,避免变成单方面纠缠"},
{"id": "h2", "spine": "按三年前大火疑点与家族联姻展开悬疑线", "opening": "先交代火场疑点与家族背景", "ending": "揭开假死隐情", "risk": "60 秒内前史过重,冲淡重逢当场的戏剧张力"}
],
"chosen_hypothesis": "h1",
"choice_reason": "60 秒短片不宜铺垫漫长前史;直接抓叔嫂错位与言行反差,开场即可立住冲突并推到病中破防",
"beats": [
{
"beat_id": "b01",
"source_id": "可选,多视频时填写",
"source_start": 12.0,
"source_end": 20.0,
"function": "hook|setup|turn|escalation|payoff",
"event": "三年前被以为死在火海的沈清欢挽着裴家大哥现身,被介绍为未来大嫂",
"change": "knowledge|power|emotion|goal: 以为她已死三年 -> 她活着回来却成了亲哥未婚妻",
"audience_question_in": "这个挽着他大哥进门的女人是谁,为什么他脸色全变了?",
"audience_question_out": "昔日恋人成了未来大嫂,他当众怎么应对?",
"character_focus": "裴钧庭、沈清欢",
"must_keep_moment": "挽臂进门与裴钧庭瞬间僵住的眼神对撞",
"evidence": ["visual", "asr"]
}
]
}
```
上例展示了存在两条剪辑路线时的 `CREATE` 对比写法;若主线清晰或处于 `DIRECTED` / `REVISION` 模式,`hypotheses` 只写选定的 1 条方案即可。
### `visual_audio_board.json`
```json
{
"schema_version": 1,
"items": [
{
"beat_id": "b01",
"source_id": "可选,多视频时填写",
"source_start": 12.0,
"source_end": 20.0,
"output_start": null,
"output_end": null,
"picture_job": "orientation|evidence|performance|reaction|action|contrast",
"preferred_moment": "沈清欢挽着大哥走近、裴钧庭眼神骤缩的正面反应镜头",
"entry_reason": "从挽臂亮相直接切入,立住死而复生与叔嫂错位",
"exit_reason": "在裴钧庭勉强稳住情绪、改口称呼前切走",
"audio_owner": "original_dialogue|action_sound|ambience|music|silence|narration",
"original_audio_anchor": "席间介绍未来大嫂与改口称呼的原声尾音",
"narration_job": "none|context|causal_link|foreshadow|interpretation|transition",
"handoff": "旁白交代死而复生却成未来大嫂的反差,句尾留空让现场原声露头"
}
]
}
```
`cut` 模式第一阶段先填源片时间;剪出 `edited_source.mp4` 后在第二阶段补齐 `output_start/end` 并复核每拍的声音主导方与旁白任务。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |