播客剪辑 是做什么的?
将视频播客从存储卡处理成一个完整剧集、精彩片段、每人单独的社交片段、团队社交片段、LinkedIn片段、故事以及一份转录稿。这里每一条规则都来自真实剪辑中犯过的错误(参见 lessons.md)。
开始之前: 如果 ~/.claude/podcast-profile.md 存在,请先读取它。它包含该用户的文件夹、名称、风格和交付偏好,其优先级高于本文件的默认设置。如果已有配置文件,则“激活我的播客技能”将从第一步开始,无需询问一轮问题。如果没有配置文件,只询问以下步骤无法自行发现的内容(复制 profile.example.md 创建配置文件)。
语言: 从转录中读取会话的语言,并用该语言处理(填充词、行动呼吁、字幕、报告)。用用户的语言与用户交流。在双语会话中,每个片段遵循其讲述的语言。参见 steps/language.md。
视频类型
| 你拥有的内容 | 请遵循 |
|---|---|
| 多机位播客或访谈,每人一个麦克风 | 按顺序执行以下步骤 |
| 课程、讲座、工作坊或网络研讨会,通常只有一个机位(Osmo、手机),需要转为社交片段 | steps/long-video.md:它会复用这些步骤,并调整声音、寻找精彩时刻和单机位构图 |
步骤说明(按顺序)
| 步骤 | 文件 | 工具 | 输出 |
|---|---|---|---|
| 1. 整理存储卡 | steps/1-organize.md | tools/organize.py | 会话文件夹、Work/copy_report.json |
| 2. 音频处理,每人一个麦克风 | steps/2-sound.md | tools/audio.py | 麦克风映射、同步和偏移 |
| 3. 转录 | steps/3-transcript.md | Whisper + 对齐工具 | Work/words.json、干净的转录文本 |
| 4. 内容计划 | steps/4-content-plan.md | (阅读和判断) | Work/plan.md |
| 5. 剪辑(无粗剪) | steps/5-cutting.md | tools/cutlist.py、tools/joincheck.py | 每个视频的片段 |
| 6. 机位与构图 | steps/6-cameras.md | (为每个镜头制定计划) | 每个片段的机位和裁剪 |
| 7. 最终检查 | steps/7-final-check.md | tools/qa.py、tools/joincheck.py | Work/checks/<video>.json |
| 8. 预览与交付 | steps/8-delivery.md | ffmpeg | Review/、Final/ |
| 9. 画廊、云端与存储 | steps/9-gallery-cloud-storage.md | gallery/ | 嘉宾页面 |
另见:steps/captions.md(tools/captions.py)、steps/timeline.md(tools/timeline.py,生成用于 DaVinci、Premiere、Final Cut 的 FCPXML)。
停下来并询问
- 某条麦克风音轨丢失或无声(切勿静默地退回到相机音频;在单机位长视频中,当相机音轨是唯一来源时允许使用,但报告中需说明)。
- 文件在复制后校验和失败。
- 无法通过麦克风和画面确定谁在说话。
- 某个片段没有真正的口播行动呼吁(明确指出;切勿编造)。
- 任何操作会导致删除或覆盖:请将旧文件移至备份位置。
绝对禁止
- 在确认每个文件都存在于两个位置之前,切勿擦除存储卡。
- 切勿在单词中间切割,或在铺垫与其观点之间切割。
- 切勿通过缩放来隐藏跳跃剪辑:应切换机位。
- 切勿向人类展示未通过第七步检查的视频。
- 切勿在字幕、标题或行动呼吁中编造事实。
环境设置
Python 3.11+、ffmpeg(在Mac上运行 brew install ffmpeg:它包含烧录字幕所需的一切),并执行 pip install -r requirements.txt。对于转录:pip install faster-whisper whisperx(免费,本地运行)。在仓库根目录下运行工具:python3 tools/<tool>.py。