bggg-tiktok-cut - SKILL.md Agent Skill

name: bggg-tiktok-cut description: > 用于把 AI 生成的视频、本地素材、口播素材或产品短片剪成可发布到 TikTok 的竖屏成片。当用户要求剪短视频、TikTok/Reels/Shorts 版本、9:16 重构图、批量短视频剪辑、AI 视频二创、加大字字幕、BGM、音频 ducking、hook overlay、去空白、粗剪、导出 final.mp4 或根据素材文件夹生成可发布短视频时，应使用此 skill。适合本地 FFmpeg/Whisper/Codex 工作流。 compatibility: "Requires Python 3, ffmpeg and ffprobe. Optional: faster-whisper or whisper CLI for transcription, auto-editor for silence removal."

BGGG TikTok Cut

把 AI 生成的视频剪成 TikTok 可发布的 9:16 成片。Codex 负责判断故事、节奏、画面瑕疵和字幕文案；脚本负责可重复的 FFmpeg 渲染。

快速流程

定位输入：确认视频文件、素材文件夹、BGM、字幕/SRT、产品卖点或脚本。用户没有给完整参数时，先按 TikTok 默认值推进：1080x1920、30fps、15-45 秒、前 1-3 秒强 hook、大字字幕、轻 BGM。

建项目：把本次产物收进一个项目目录，避免散落在工作区。

python3 <skill-dir>/scripts/init_project.py "<project-dir>" --name "<name>" --inputs "<video1>" "<video2>"

探测素材：生成 media inventory 和抽帧，用抽帧判断 AI 视频的坏帧、主体位置、适合 cover 还是 blur-bg。

python3 <skill-dir>/scripts/probe_media.py "<project-dir>/raw" --out "<project-dir>/metadata/media_inventory.json" --frames-dir "<project-dir>/diagnostics/frames"

需要语音时转写：有口播/旁白时生成 JSON/SRT；无语音的 AI 视频可直接根据脚本写 captions/overlays。

python3 <skill-dir>/scripts/transcribe.py "<project-dir>/raw/source.mp4" --out-dir "<project-dir>/transcripts" --model small --language auto

写剪辑计划：编辑 plans/edit_plan.template.json，或先生成 starter plan 再修改。

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"

自检：用 ffprobe 验证输出尺寸、时长、音频；抽查开头、字幕密集处、结尾。如果字幕被 TikTok UI 安全区遮挡、画面主体被裁掉、音频爆音或 BGM 过响，改 plan 后重渲染。

剪辑判断

AI 视频优先看画面连续性：删掉变形手、漂移 logo、字幕穿帮、闪帧、明显循环卡顿和主体出框的片段。
前 3 秒要给理由：用画面强动作、结果预览、反差句、价格/痛点/卖点 overlay 之一开场。不要用慢慢铺垫。
竖屏重构图默认 blur-bg：横屏或宽画幅 AI 视频用模糊背景保留完整主体；主体稳定且足够大时用 cover；需要展示全图时用 contain。
字幕安全区：字幕默认放在中下区域，避开 TikTok 底部描述区和右侧操作栏。价格、优惠、CTA 放顶部或中部 badge。
BGM 是辅助：有口播时 BGM 轻铺，默认 0.08-0.14；无口播的视觉向视频可提高到 0.18-0.28，但避免压过关键音效。
批量剪辑：每条视频单独建项目或在同一项目中保存多个 plans/*.json，输出命名带产品/角度/序号。

Edit Plan

渲染脚本读取 JSON plan。需要详细字段时读 references/edit-plan-schema.md。

最小可用示例：

{
  "version": 1,
  "project": {
    "title": "TikTok cut",
    "platform": "tiktok",
    "target": {"width": 1080, "height": 1920, "fps": 30}
  },
  "settings": {
    "fit": "blur-bg",
    "grade": "punch",
    "caption_style": "tiktok-bold",
    "voice_volume": 1.0,
    "output_name": "final_tiktok.mp4"
  },
  "clips": [
    {"source": "raw/clip.mp4", "start": 0.0, "end": 6.2, "fit": "blur-bg", "label": "HOOK"}
  ],
  "captions": [
    {"start": 0.0, "end": 2.4, "text": "第一眼就要看到结果", "style": "hook"}
  ],
  "overlays": [
    {"start": 0.0, "end": 2.4, "text": "AI 视频二创", "style": "hook"}
  ],
  "bgm": {"path": "assets/bgm/music.mp3", "volume": 0.12},
  "export": {"crf": 20, "preset": "fast"}
}

脚本职责

scripts/init_project.py：创建项目结构，复制输入，写 plan 模板和 manifest。
scripts/probe_media.py：ffprobe 素材并抽帧。
scripts/transcribe.py：可选本地转写，优先 faster-whisper，回退 whisper CLI。
scripts/make_plan.py：从 raw/ 生成保守 starter plan。
scripts/render_tiktok_cut.py：按 plan 标准化片段、拼接、加字幕/overlay/watermark、混 BGM、导出 TikTok MP4。

参考资料

需要剪辑策略时读 references/tiktok-editing-playbook.md。
需要修改 JSON 字段时读 references/edit-plan-schema.md。
需要理解参考项目取舍时读 references/source-projects.md。
第三方参考仓库不随本 skill vendored；references/source-projects.md 只记录学习到的设计模式和可回溯来源。

交付格式

完成后给用户这些路径：

成片：<project-dir>/renders/final_tiktok.mp4
剪辑计划：<project-dir>/plans/edit_plan.json
渲染报告：<project-dir>/renders/render_report.json
字幕：<project-dir>/captions/final_captions.ass，如果生成了转写，也给 SRT/JSON 路径

如果有未自动解决的问题，明确写成短清单：例如某段 AI 画面有不可修复变形、没有安装 Whisper、BGM 缺失、用户需人工确认品牌合规文案。