用于将 AI 生成视频、本地素材、口播素材或产品短片剪成可发布到 TikTok 的 9:16 竖屏成片。由 Codex 判断故事、节奏、画面瑕疵与字幕文案，脚本负责可重复的 FFmpeg 渲染。
用途与能力：定位输入素材后，按 TikTok 默认参数（1080x1920、30fps、15-45 秒、前 1-3 秒强 hook、大字字幕、轻 BGM）推进；探测素材生成 media inventory 与抽帧；有口播时本地转写；编写编辑计划（edit_plan JSON）后渲染、自检。
主要脚本与用法：
python3 <skill-dir>/scripts/init_project.py "<project-dir>" --name "<name>" --inputs "<video1>" "<video2>"
python3 <skill-dir>/scripts/probe_media.py "<project-dir>/raw" --out "<project-dir>/metadata/media_inventory.json" --frames-dir "<project-dir>/diagnostics/frames"
python3 <skill-dir>/scripts/transcribe.py "<project-dir>/raw/source.mp4" --out-dir "<project-dir>/transcripts" --model small --language auto
python3 <skill-dir>/scripts/make_plan.py "<project-dir>" --title "<hook>" --target-seconds 30
python3 <skill-dir>/scripts/render_tiktok_cut.py "<project-dir>/plans/edit_plan.json"
剪辑要点：优先删除变形、漂移、闪帧、主体出框片段；前 3 秒用强动作、结果预览、反差句或卖点 overlay 开场；竖屏默认 blur-bg，主体稳定时用 cover，展示全图用 contain；字幕避开底部描述区与右侧操作栏；有口播时 BGM 默认 0.08-0.14，无口播可提高至 0.18-0.28。批量剪辑可为每条视频单独建项目，或在同一项目保存多个 plans/*.json。
渲染读取 JSON plan，含 project、settings、clips、captions、overlays、bgm、export 等字段，字段细节见 references/edit-plan-schema.md。交付：renders/final_tiktok.mp4、plans/edit_plan.json、renders/render_report.json、captions/final_captions.ass，转写后附 SRT/JSON 路径。
限制：转写优先 faster-whisper，回退 whisper CLI；无法自动修复的画面变形、未安装 Whisper、BGM 缺失、品牌合规文案需人工确认，应列入短清单。部分运行细节与第三方依赖未在资料中提供。