用途：在 Claude Code 中把 raw/ 里的新影片跑成一条 YouTube 生产线，覆盖长片与短片两个阶段，并产出双格式营销信息。
主要能力：阶段 1 长片流程为剪口播、转字幕、疑虑字幕确认、时间码硬关卡、产标题、产封面、写长片 metadata、打包；阶段 2 短片流程为读完整字幕、亮点侦测、三候选确认、切片组片、短片 metadata、打包。中间设 3 个 STOP 关卡，必须停下等用户确认，不得自动继续。
使用方式：先读 HANDOFF.md、CLAUDE.md 及 assets 下的风格与人物基准资料。剪口播执行 skills/smart-cut/scripts/smart_cut.py，实测参数为 --threshold 0.06 --margin "0sec,0.1sec"。转字幕走 transcribe_groq.py、resegment.py、apply_vocab.py、逐段清字、find_dubious_terms.py 与 finalize_subtitles.py，最后用 validate_srt.py 做硬关卡校验。封面用 skills/cover-image/draw.py，需 OPENAI_API_KEY 或 ~/.openai.env，并带 --edit assets/persona/三師爸人物形象照.png。
适用场景：面向教师受众的科技教学类 YouTube 频道，需要批量处理长片与 Shorts 并统一封面、字幕与营销文案。
限制：需 OpenAI API Key 且账号通过验证，否则封面失败；Groq 转写有 25MB 上限并会上传音频到第三方；resegment.py 需先建 _subtitles 目录；PowerShell 路径含 [Claude] 时需用 -LiteralPath 或单引号。短片阶段非必跑，用户未要求则停在阶段 1。