rough-cutlisted
Install: claude install-skill m15851855393-boop/mandarin-talking-head-rough-cut
# 口播粗剪流程（timeline.md 改文字机制）
按顺序执行。真值有两份：`segments.json`（词级时间，机器读）＋`timeline.md`（转写稿，
④在上面剪）。只有第④步动脑，其余调脚本。目标不是只抠几个口水词，而是删干净前摇、
收工、作废 take、过程话、真重复和不回收的跑题，同时守住连接骨架和原意。
## 运行约定
把本文件所在目录记为 `SKILL_DIR`，把任务产物目录记为 `OUT`。实际命令必须使用 Skill
目录中的脚本，不依赖当前工作目录：
- Windows：`PYTHON=<venv>\Scripts\python.exe`；首次使用先读
`references/windows_setup.md`，运行 `scripts\install_windows.cmd`。
- macOS/Linux：`PYTHON=<venv>/bin/python`；首次使用先读 `references/runtime.md`。
开始前运行：
```text
<PYTHON> <SKILL_DIR>/scripts/doctor.py --config <CONFIG>
<PYTHON> <SKILL_DIR>/scripts/probe.py --help
```
自动转写前还必须读 `references/volc_asr_setup.md`。如果检测到用户尚未配置火山，立即
进入该文档的“Agent 首次配置带领方式”，把它当作交互式开户向导执行，不得只列字段后让
用户自行研究：
1. 先用生活化语言说明为什么需要豆包语音和临时 TOS，不先抛出 `resource_id`、AK/SK、
Endpoint 等实现术语。
2. 一次只布置一个明确动作，并等用户完成或发截图后再讲下一步：注册/实名 → 开通录音
识别 → 取得语音鉴权 → 创建私有桶 → 取得 TOS 密钥 → 本地填写 → 体检。
3. 每一步说明“打开哪里、点什么、完成后应看到什么、如何回复”；界面不同时让用户发不含
密钥的截图，Agent根据截图继续指路。
4. 在用户取得所需服务和凭证之前，不让用户打开 `config.json`，也不发送整张工程字段表。
5. 首次阻塞回复优先解决开户，不用大段硬件、编码器和内部流水线状态淹没用户。
安装者只能使用自己的火山 ASR 和 TOS 配置；不得搜索、复制、输出或复用他人的
`config.json`，也不得让用户把密钥粘贴到聊天中。任务已有合格词级转写并明确跳过转写
时，环境检查可加 `--allow-no-asr`。
## 硬性规则
1. 原片只读；所有中间文件和成片写入 `OUT`，绝不覆盖原片。
2. 音视频处理只调用 `scripts/` 中的现成脚本；不得临时拼 FFmpeg 或音频命令。
3. 删减只在 `timeline.md` 上裁决，不手猜毫秒时间码。
4. 删除完整语义块；句内划删必须逐词兑现，不能留下半句或切断字尾。
5. 拿不准就保留，并在行尾标 `%待确认：理由%`。
6. 渲染前必须完成剪后逐字稿通读；渲染后必须抽听所有删除接口。
7. 带货和引流内容必须执行合规检查；合规要求优先于 keep-biased。
8. 脚本失败就停止并说明失败步骤和错误，不反复破坏性重试。
9. **病句不等于无效内容。** 主讲人句子即使有口误、ASR 错字或量词重复，只要包含独有的
方法、步骤、人物身份、数字、例子、因果或承接信息，就