Video Highlights Agent Skill

长视频 / 直播录像高光切片

> 从长视频里找高光段 → 切成多条短视频（可转竖版 + 加字幕）。切片执行走

> skills/shared/scripts/highlight_cut.py，不要手拼裁切命令——脚本已处理精确裁切、

> 前后留白、批量输出、转竖版、清单生成。

> 英文口播找笑点 + 逐段动态人脸 pan 见 clipify；只转画幅见 video-reframe；

> 字幕翻译见 subtitle-translate。

输入

| 字段 | 必填 | 说明 |

|------|------|------|

| 长视频 | 是 | 直播录像 / 长视频（没给就问） |

| 找点方式 | 否 | 能量（默认，情绪高涨处）/ 内容（转录后按金句/爆点挑） |

| 片段数 | 否 | 切几条（默认 5） |

| 每段时长 | 否 | 每条大约多长（默认 20s） |

| 转竖版 | 否 | 是否转 9:16 发抖音/小红书 |

输出（outputs/主题名/）

• 多条切片（highlight_01.mp4 …）+ 清单 highlights.json

执行步骤

脚本路径（相对项目根）：skills/shared/scripts/highlight_cut.py（energy -h / cut -h）。

方式 A：音频能量找点（快，适合有欢呼/情绪起伏的直播）

# 1) 找候选段
python skills/shared/scripts/highlight_cut.py energy -i <长视频> \
  --top 5 --clip-len 20 -o /tmp/hl_cand.json
# 2) 切片（可同时转竖版）
python skills/shared/scripts/highlight_cut.py cut -i <长视频> \
  --segments /tmp/hl_cand.json -o outputs/video-highlights \
  --reframe 9:16 --reframe-mode blur

方式 B：内容找点（准，适合口播/知识/带货，挑金句爆点）

• 先转录（复用 auto-subtitle 的 asr.py，带时间轴）：

   python skills/shared/scripts/asr.py transcribe -i <长视频> --format json -o /tmp/hl.json

• 你读转录，挑出 3-5 个最有价值/最抓人的片段（完整语义段，别切半句），

写成切片清单 /tmp/hl_segs.json：

   {"segments": [{"start": 73.2, "end": 95.0, "label": "金句：xxx"}, ...]}

• 切片：

   python skills/shared/scripts/highlight_cut.py cut -i <长视频> \
     --segments /tmp/hl_segs.json -o outputs/video-highlights --reframe 9:16

--pad 0.3 每段前后留白避免切太紧；不转竖版就去掉 --reframe。

Profile 感知

• 有 Profile：转竖版比例按 platforms.md 主平台；找点侧重贴合账号定位（带货看爆点、

知识看金句、娱乐看情绪高潮）；切片时长贴合平台（抖音 15-30s，视频号 30-60s）。

• 无 Profile：默认能量找点 top5、每段 20s，询问是否转竖版。

规则

• 内容找点务必切完整语义段，不要从半句话切进/切出。
• 能量找点适合有明显情绪起伏的素材；平淡口播优先用内容找点（方式 B）。
• 切片默认前后各留 0.3s 白，避免开头/结尾被切掉。
• 转竖版口播类建议 --reframe-mode smart（人脸居中），其它用 blur（不丢画面）。
• 产物统一进 outputs/主题名/，附 highlights.json 清单。

参考来源

音频能量选段用 librosa RMS 峰值（贪心去重保证峰间隔）；内容选段沿用 opus-clip 式"转录→挑金句"

思路但交给 LLM 判断。切片/转竖版复用确定性脚本，保证时间轴与画幅不出错。