bggg-tiktok-cut

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 缺失、用户需人工确认品牌合规文案。