eternityspring/reelbench-skills / skills/video-shots
video-shots
Verified拉片:把一条成片拆成逐镜头的分析表——每个镜头的时长、景别、类别、运镜、画面。 分工刻在骨子里:**能量的都由代码量**(切点来自 ffmpeg 场景检测,时长是切点相减, 运动量是逐帧差分的中位数),模型只判断它真正该判断的那几件事(景别 / 类别 / 运镜 / 画面 / 节奏), 然后每一条判断都被代码当场对账——**声称推拉摇移却实测几乎不动,门直接拦**。 看片走联系表(每镜起手帧 + 收尾帧各拼一张大图,一屏二十几个镜头,a/b 对照就是运镜), 不是一张张翻。检测漏刀多刀用 recut 补刀并刀,自动重编号重算时长,手改边界过不了门。 产出 shots.json + Markdown 镜头表 + **单页交互式拉片报告**:内嵌播放器(播放时同步高亮镜头、 点镜头跳转)、镜头节奏带、可搜索可筛选可排序的镜头表(列表 / 卡片两种视图、首尾关键帧并排、 点图开大图)、景别类别运镜分布、出场人物、质量门、导出 JSON。单文件零依赖,离线双击能开。 15 道质量门全部由脚本确定性检查。 零依赖、零 API key,只要 node 和 ffmpeg。 Use when asked to 拉片、拆镜头、分析视频镜头、镜头时长、景别、运镜、镜头表、 video shot breakdown、shot list from video。
| File | Kind | Size |
|---|---|---|
| README.en.md | markdown | 9.6 KB |
| README.md | markdown | 8.3 KB |
| SKILL.md | skill md | 13.5 KB |
| assets/report-mobile.png | binary | 125.8 KB |
| assets/report.png | binary | 384.5 KB |
| examples/demo-shots.json | config | 30.9 KB |
| examples/demo-track.json | config | 3.8 KB |
| references/analysis-pass.md | markdown | 5.5 KB |
| references/report-style.md | markdown | 5.4 KB |
| references/schema.md | markdown | 5.2 KB |
| references/taxonomy.md | markdown | 11.7 KB |
| scripts/report.css | other | 33.0 KB |
| scripts/report.js | script | 20.5 KB |
| scripts/selftest.mjs | script | 35.2 KB |
| scripts/video-shots.mjs | script | 75.6 KB |
references/analysis-pass.md
View on GitHub# 拉片:一批镜头怎么看、怎么填
一次任务拉一批镜头(默认 ≤ 25 个,正好一张联系表)。你拿到:这一批的镜头底稿
(镜号、起止、时长、实测运动,**全是量出来的,不要重算**)、这一批的联系表 a/b 两张、
以及 `taxonomy.md` 的词表。产出:把这一批每个镜头的 `size` / `category` / `camera` /
`frame` 四个字段填满,顺带记下 `subjects` / `onscreenText` / `audio`。
## 先看联系表,再看单帧
1. **先看 a 表**(每镜起手帧,行优先,S01 在左上):一屏把这一批的**内容**过一遍——
谁在、在哪、这一段在讲什么。
2. **再看 b 表**(每镜收尾帧,同样顺序):同一格前后对照,**取景变没变**一眼就知道——
这就是运镜的判据。
3. 只在**判不准的那几个镜头**上回去看单帧(`frames/S07a.jpg`)。一张张翻完整部片是浪费,
联系表存在的意义就是不用这么干。
## 填的顺序:景别 → 类别 → 运镜 → 画面
1. **景别**最客观,先定,定完心里就有了这一批的节奏轮廓。
2. **类别**看这一镜在片子里干什么活(定场?对话?插入?),判据在 `taxonomy.md`。
3. **运镜**看 a/b 取景差 + 实测运动值。两者打架时**信实测**:
- 取景看着没变,实测 0.3 → `static`
- 取景明显变了,实测 15 → 按变的方向选推/拉/摇/移/跟
- 取景没变但实测 20 → 多半是主体在动,仍然是 `static`(门不拦,报告会出一条提示)
- **实测接近 0 却想写推拉摇移 → 一定是判错了,门会拦**
4. **画面**最后写,一句话,12 字起,写看得见的东西。写完自问:只看这句话,
能不能把这一镜从片子里找出来?
## 硬规则
1. **时长不是估的。** 底稿上的秒数来自切点相减,**一个字都不要改**。觉得某个镜头的边界不对,
走 `recut`,不要手改 `start` / `end`。
2. **实测运动不是参考意见。** 它是像素证据。写运镜之前先看一眼这个数。
3. **对话镜头必须记台词**,字卡必须记画面文字,反应镜头必须写是谁在反应,空镜里不许有人——
门会逐条查(见 `taxonomy.md` 的证据列)。
4. **两镜的画面描述不许一字不差。** 同机位的正反打也要写出差别。
5. **判不准就写 `note`,不要猜一个确定的词。**
## 漏刀与多刀:检测不是神
场景检测按画面变化率切,所以它必然在两个地方出错。**发现了就用 `recut` 修,别将就**:
| 症状 | 原因 | 治法 |
| --- | --- | --- |
| 一个镜头的 a 帧和 b 帧根本是两个场景 | 中间漏了刀 | 在变化处 `recut --split <秒>` |
| 某镜长得离谱(十几秒还全是对话正反打) | 同机位、同亮度的切换检测不到 | 抽几张中间帧定位,逐个 `--split` |
| 暗场接暗场、片尾字卡一张接一张,全被并成一镜 | 黑底画面之间的变化率本来就低 | 降 `--threshold` 重跑,或逐个 `--split` |
| 一个稳定镜头被切成三四段碎片 | 手持晃动、闪光、字幕跳变冲高了变化率 | `recut --merge <秒>` 把多余的刀并掉 |
| 叠化段落里切点落在半透明的那几帧上 | 叠化本来就没有明确的一帧 | 切点取叠化中点,`transitionIn` 写 `dissolve` |
**补的刀会记进 `manualCuts`,门认它**;并刀只会减少边界,白送通过。手改边界过不了 `boundary` 门。
一上来就发现全片只切出十几个镜头、平均镜长十几秒,那是**阈值选高了**,
别一刀一刀补——`seed --threshold 0.15` 重跑一遍更快。
## 导演手感(不设门,但决定这份拉片有没有用)
- **节奏带比数字更快说明问题。** 深浅相间、长短相间是好节奏;一整片同色同宽,
要么是片子平,要么是你把所有镜头都填成了中景固定。
- **平均镜长是这部片的呼吸。** 短剧 2–4 秒、广告 1–2 秒、文艺片 8 秒以上都正常,
重要的是**它和片子的类型对不对得上**,以及**高潮段落有没有变速**。
- **对话戏看正反打的比例。** 全是一方的镜头说明另一方是工具人;反应镜头占比高的片子,
情绪一定给得足。
- **插入特写是重音。** 数一数它们落在哪儿——落在关键动作上是好剪辑,撒得到处都是是慌。
- **固定机位占比高不是缺点。** 运镜克制的片子往往更稳;反过来,一部片子七成都是推拉摇移,
多半是在用运镜掩盖内容。
## 常见病
| 病 | 症状 | 治法 |
| --- | --- | --- |
| 复制粘贴病 | 相邻几镜画面描述几乎一样 | dedup 门会拦。同机位也要写出动作进度的差别 |
| 空话病 | 「氛围感很强」「很有电影感」 | 空话词表会拦。改成看得见的东西 |
| 运镜幻觉 | 人在跑就判成跟拍,实际机位没动 | 看实测值;`static` 是默认,不是备选 |
| 景别通胀 | 什么都写特写 | 按人占画高判,OTS 通常是中近景 |
| 类别联动 | 特写一律写 `insert` | 说话的特写是 `dialogue`;类别看功能不看距离 |
| 字幕错位 | 把对白字幕记进 `onscreenText` | 有人在说就是台词,进 `audio` |
| 黑场硬套景别 | 给片尾黑底字卡写「全景」 | 黑场和字卡一律 `none` |
| 边界手改 | 直接改 `start` / `end` 挪刀 | `boundary` 门会拦。改边界只走 `recut` |
| 一遍过 | 填完不 validate 就交 | 门是代码,跑一次几毫秒,不跑等于没做 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |