# Chengfeng Videocut Skills:剪口播

口播基础素材包生成。转录口播、识别口误、生成审核页；用户确认后剪出新视频，Agent 再基于剪后视频重新转写、AI 校对字幕，输出后续口播成片可用的...

- Repository: https://github.com/Pluviobyte/rnskill (1706 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-09-21
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:剪口播 -g -a claude-code -y`
Codex: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:剪口播 -g -a codex -y`
Cursor: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:剪口播 -g -a cursor -y`
Gemini CLI: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:剪口播 -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Pluviobyte/rnskill`

## Description

口播基础素材包生成。转录口播、识别口误、生成审核页；用户确认后剪出新视频，Agent 再基于剪后视频重新转写、AI 校对字幕，输出后续口播成片可用的 source_cut.mp4 和 subtitles.srt。触发词：剪口播、处理口播素材、准备口播素材、识别口误、基础素材包

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

<!--
input: 视频文件 (*.mp4)
output: subtitles_words.json、auto_selected.json、review.html、剪后视频、video.raw.srt、AI 校对后的 video.srt/subtitles.srt
pos: 口播素材准备入口；默认完成粗剪 + 剪后字幕校对

架构守护者：一旦我被修改，请同步更新：
1. ../README.md 的 Skill 清单
2. /CLAUDE.md 路由表
-->

# 剪口播 v3

> 火山引擎转录 + AI 口误识别 + 网页审核 + 剪后重转写 + AI 字幕校对

## 快速使用

```
用户: 帮我剪这个口播视频
用户: 处理一下这个视频
用户: 把这条录屏做成基础素材包
```

不要再把字幕生成拆成单独 Skill。`剪口播` 是口播基础素材包的唯一入口。

用户给一条口播录屏后，本 Skill 默认产出后续 `口播成片` 可直接使用的基础素材包：

```text
source_cut.mp4       # 剪后口播视频
subtitles.srt        # 基于剪后视频重新转写并 AI 校对后的字幕
assets/              # 可选截图、评论图、结果页
```

审核页只负责让用户确认“删哪里”并剪出新视频。字幕不能沿用原始视频字幕，也不能把火山转写初稿直接当最终字幕；Agent 必须基于剪后视频重新转写，并做 AI 校对后，才能写入 `subtitles.srt`。

## 输出目录结构

```
output/
└── YYYY-MM-DD_视频名/
    ├── 剪口播/
    │   ├── 1_转录/
    │   │   ├── audio.mp3
    │   │   ├── volcengine_result.json
    │   │   └── subtitles_words.json
    │   ├── 2_分析/
    │   │   ├── readable.txt
    │   │   ├── auto_selected.json
    │   │   └── 口误分析.md
    │   └── 3_审核/
    │       ├── review.html
    │       └── video.mp4 → 源视频(符号链接)
    └── 字幕/
        ├── 1_转录/
        │   ├── audio.mp3
        │   └── volcengine_result.json
        ├── subtitles_with_time.json
        └── 3_输出/
            ├── video.raw.srt
            └── video.srt
```

**规则**：已有文件夹则复用，否则新建。

## 流程

```
0. 创建输出目录
    ↓
1. 提取音频 (ffmpeg)
    ↓
2. 调用火山引擎录音文件识别 2.0（Seed ASR v3）
    ↓
3. 生成 volcengine_result.json
    ↓
4. 生成字级别字幕 (subtitles_words.json)
    ↓
5. AI 分析口误/静音，生成预选列表 (auto_selected.json)
    ↓
6. 生成审核网页 (review.html)
    ↓
7. 启动审核服务器，用户网页确认
    ↓
【等待用户确认】→ 网页点击「执行剪辑」
    ↓
8. 服务器只剪出新视频
    ↓
9. Agent 监听剪后视频生成完成
    ↓
10. 基于剪后视频重新提取音频，发火山转写，生成 video.raw.srt
    ↓
11. Agent 对照原稿/正文做 AI 校对，写 video.srt
    ↓
12. 整理基础素材包：source_cut.mp4 + subtitles.srt + 可选 assets/
```

剪后字幕硬规则：

- 必须基于剪后视频重新转写，不能用原始视频字幕反推。
- 火山转写只是初稿，输出到 `video.raw.srt`。
- `video.srt` / `subtitles.srt` 只能是 Agent AI 校对后的最终字幕。
- 校对时对照用户给的口播稿、正文、专名和上下文，修正术语、同音误识别、断句；不能添加视频里没说的话。

## 执行步骤

### 步骤 0: 创建输出目录

The rest: https://github.com/Pluviobyte/rnskill/blob/HEAD/skills/chengfeng-videocut-skills/剪口播/SKILL.md