用途:在 Codex 中把 raw/ 里的新影片跑成一条 YouTube 生产线,覆盖长片与短片两大阶段,中间设 3 个 STOP 关卡,每关必须停下等用户拍板,不得自动继续。
主要能力:阶段 1 长片依次为剪口播、转字幕、疑虑字幕确认、时间码硬关卡、产标题、产封面、写长片 metadata、打包;阶段 2 短片为读完整字幕、亮点侦测、三候选确认、切片组片、短片 metadata、打包。字幕流程为 Groq transcription → resegment → apply_vocab → 逐段清字 → STOP 1 → validate_srt 硬关卡 → srt_to_txt。
必要用法:先读 HANDOFF.md、AGENTS.md 及 assets 下的风格与人物参考图。剪口播执行 skills/smart-cut/scripts/smart_cut.py,建议起始参数 --threshold 0.05。疑虑术语用 find_dubious_terms.py 导出,再用 finalize_subtitles.py 套更正,段落限定格式如 390:AGE->Agent。时间码校验用 validate_srt.py --raw <vocab.srt> --clean <clean.srt>,段数或时间码不一致即中止。封面用 Codex 内置 Image2 生图,不调用 skills/cover-image/draw.py,每次须重新参考人物形象照。输出文件夹固定加 [Codex] 后缀,文件名不加。短片切片对齐字幕段落边界,≤120s,并产 9:16 直式版。
适用场景:需要批量处理口播教学类长片并派生 Shorts 的 YouTube 内容生产。
限制:短片阶段非必跑;Groq 转写会把音频上传第三方,需授权时先停下;Codex 的 Python 环境可能与 Claude Code 不同,缺包需装到当前 python;含中文、空格与 [Codex] 的路径需用引号与 -LiteralPath。