reel-style-clone

用途

reel-style-clone 用于对一条参考短视频进行“取证式”风格拆解，把隐藏在画面与声音中的剪辑规律变成可执行的风格指南和逐行构建指令，使后续构建流程能把同一风格套用到完全不同的素材与脚本上。

主要能力

• 探针与切点检测：用 ffprobe 读取时长、分辨率、帧率；用 select='gt(scene,0.25)',showinfo 检测硬切，输出切点时间戳及每个切点后首帧 PNG，并统计整体与各段落（钩子/主体/CTA）的每秒切点数与镜头长度。
• 画面证据：以 2fps 抽帧并缩放到 360 宽，拼成 5×4 接触表（每张 20 帧约 10 秒），便于逐帧研究字幕排版、图形叠层、B-roll 语法、构图与调色。
• 音频证据：提取音频做 Whisper 转写（base 模型即可，只需旁白节拍），渲染频谱图与波形图，据此推断是否有音乐、由底鼓间距估算 BPM、音效落点与能量起伏。
• 并行取证分析：有子代理时按接触表、切点帧、音频证据分头分析；无子代理则顺序执行同样的分析步骤。
• 风格指南合成：把各报告合并成含 PACING / CAPTIONS / GRAPHIC LANGUAGE / B-ROLL GRAMMAR / COLOR & GRADE / SOUND DESIGN / BUILD DIRECTIVES 七部分的指南；声音设计写成可直接生成的 ElevenLabs 音乐提示词；构建指令按用户脚本逐行规划切点、画面、字幕处理与音效落点，并匹配参考的每秒切点密度。
• 交付构建：将风格指南与构建指令交给 branded-ad-edit（完整动效管线），或当参考风格仅为横幅加卡拉 OK 字幕加紧凑节奏时交给 reel-recut。

使用方式

1. 用户提供本地参考视频；若只有平台链接（Instagram/TikTok/YouTube），平台下载通常需要用户自己的已登录会话，应请其自行下载（实在不行录屏）或提供已登录的浏览器会话，不应匿名抓取。
2. 运行前阅读 references/method.md，其中包含确切命令、子代理提示词、风格指南模板与分析经验法则。
3. 依次执行：探针与切点检测 → 画面证据 → 音频证据 → 并行取证分析 → 合成风格指南 → 交接构建。
4. 输出写入项目工作目录（而非本技能目录）：style-guide.md（七段式指南）、build-directives.md 或指南内的逐行计划表、evidence/（切点列表与切点 PNG、接触表、频谱图、波形、转写文本；评审轮次会重新打开这些证据）。

五条分析经验

• 模式/语域系统才是标志：剪辑师用条件规则而非恒定外观，例如人脸在屏时用无衬线小写、图形替换人脸时用衬线全大写；要抓住触发条件本身。
• 统计镜头内构建，不只统计切点：感知节奏约为硬切率的两倍，因为镜头内还有字幕词、列表项、推镜等元素弹出。
• 找到每片一次的特殊技巧并只用一次：如漏光闪、反色帧、变速；用一次是标志，重复就是噱头。
• 给重复装置命名：例如“截图浮于自身模糊之上”“蓝色阅读高亮”等，能命名就能重建。
• 说明每个叠层的功能而非外观：“黑底白衬线大写”是照抄，“权威语域——用于让观众把某主张当作事实”才是克隆；每个图形都要有功能，构建指令才能把它部署到参考从未说过的新台词上。

适用场景

需要把某条爆款或客户参考视频的剪辑风格系统化复现到新脚本/新素材的短视频制作场景，尤其是经客户评审轮次的风格克隆交付。

限制与要求

• 需要 PATH 中有 ffmpeg / ffprobe。
• 需要本地 whisper（whisper-cli + ggml 模型，base 即可），或使用 npx hyperframes transcribe（需 Node ≥ 20）。
• 子代理（Task 工具）可选但强烈建议用于并行分析。
• 分析阶段无需 API 密钥；下游经 branded-ad-edit 构建需在仓库根目录 .env 中提供 ELEVENLABS_API_KEY，该要求在其文档中说明。
• 平台视频下载需用户自己的认证会话，匿名抓取通常不可行。