Communitygithub.com

Reel · 剪辑引擎 VSL

一条技能,两个引擎,零面板。发送原始视频,自动完成切割与 VSL 风格剪辑,输出可供发布的 9:16 短片。

Reel · 剪辑引擎 VSL 是什么?

Reel 技能专为 AI 编程助手(如 Claude Code)设计,用于将用户提供的原始讲话视频自动剪辑为 9:16 竖版 Reel / Short。其工作流程包含两大核心引擎:**切割引擎**(corte/)负责消除沉默、呼吸声、口吃、错误、重拍和重复,基于经过生产验证的声音检测进行精准切割;**VSL 引擎**(modelo/)则遵循已批准参考视频的完整规则集(包括镜头切换、全屏/分屏布局、关键词动画、口型同步字幕、音效控制和 -14 LUFS 响度标准)进行最终剪辑。整个流程无需用户面板选择,支持在 macOS/Linux 上运行,依赖 ffmpeg、Whisper、Node.js 和 Python(MediaPipe/OpenCV)。用户只需提供视频,AI 将自动完成切割、编辑、渲染和迭代,最终输出 `render/reel-v1.mp4`。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lucascorel/skill-motion-graphic/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

reel · 切割与 VSL 引擎剪辑

一条技能,两个引擎,零面板。用户发送视频;你使用切割引擎 (corte/) 进行切割,并使用 VSL 引擎 (modelo/,即产生已批准参考视频的未改动工具包) 进行剪辑,遵循通用规则 (regras-da-casa.md,优先级最高) 和 ESTILO.md (引擎规范)。最终结果与工作室以 VSL 风格使用原生皮肤交付的效果一致:相同的颜色、字体、声音和规则。切勿发布或发送视频 (R9)。视频或文件中不得出现任何第三方名称 (R11)。

开始前请按以下顺序通读以下文件:regras-da-casa.md → corte/CORTE.md → ESTILO.md → modelo/README.md → modelo/exemplo/LEIA.md。值得花时间阅读的是:质量标准是参考示例,而非最低要求 (modelo/exemplo/beats-exemplo.js 是标杆;每个视频都有其自己的节拍图)。

技能地图

SKILL.md                      本文件 (流程)
regras-da-casa.md             R1–R11: 面部永不遮挡、SFX 节制、真实素材、无吞词、-14 LUFS…
ESTILO.md                     VSL 引擎规范:布局、取景、运动、字幕、元素、声音、流程、验收、经验教训
pele.json                     原生值 (字体、五种颜色、不变量) — 参考视频的外观
corte/                        切割引擎:CORTE.md (脚本) · references/EDICAO-BRUTA.md (原理) · scripts/ · exemplo/
modelo/                       VSL 引擎:kit/ (未改动) · montar.mjs · preparar.sh · ferramentas/ · exemplo/ (已批准的 reel) · README.md
ferramentas/                  preparar.py · rosto.py · ancoras.py · verificar.py · zona-segura.py · recortar.py · audio-final.sh
anexos/                       参考帧与调色前后对比

S=~/.claude/skills/reel (或 REEL_SKILL)。环境变量 (R10):WHISPER_MODEL, VSL_PYTHON (含 mediapipe 或 opencv 的 Python), FACE_MODEL, VSL_NODE_MODULES, CHROME, RVM_PYTHON (仅用于 matte)。

流程 (固定顺序)

0 · 项目

  1. 为每个 reel 在视频旁边创建一个独立文件夹:reel-<slug>/,内含 corte/, render/, qa/, entrega/, assets/。切勿重复使用其他剪辑;切勿在外部写入原始视频文件夹。
  2. 首次在本机运行时:python3 $S/corte/scripts/0-checar.py (检查 ffmpeg, whisper-cli, numpy, 模型)。
  3. 用一句话说明将要发生的事 ("正在使用 VSL 引擎进行切割和剪辑;v1 将在几分钟内完成"),并在每个耗时步骤前提醒。长步骤在后台运行。

1 · 切割 (切割引擎, 完整阅读 corte/corte.md)

B=$S/corte/scripts · 所有操作在 corte/ 文件夹内:

python3 $B/1-tomadas.py "<bruto>" corte && cat corte/tomadas.txt      # 在选择前完整阅读
# 编写 corte/keeps.json (保留规则:每个句子的最佳完整镜头;排除假起跑)
python3 $B/2-vicios.py corte
python3 $B/3-corte.py "<bruto>" corte                                  # 4 帧 J/L (VSL 默认)
python3 $B/4-conferir.py corte --prompt "<视频中的专有名词>" && cat corte/conferencia.txt

标准 (R5):conferencia.txt 中所有区块均通过;无吞词;无超过 0.25 秒的停顿。发生吞词 → 保护该区间 (raw/force) 并重新切割。如果用户说视频已经干净,则跳过:cp "<vídeo>" corte/clean.mp4 并使用 $S/ferramentas/preparar.py corte/clean.mp4 preparo 进行转录。输出:corte/clean.mp4, corte.wav, edl.json, cortepalavras.json。

2 · VSL 引擎 · 准备

cp -R "$S/modelo" motor && cd motor && bash preparar.sh

制作 9:16 画幅的视频 (assets/clean.mp4),生成工具包格式的转录本,执行 npm install,进行嘴部跟踪和首次装配。若无 pele-resolvida.json,则皮肤为原生 (即参考视频皮肤):请勿创建。

3 · 第一阶段 · 规划 (modelo/README.md)

  1. 转录稿 (R6):手动修正 assets/transcript.json (Cloud → Claude, A → IA, 名称按品牌写法, CTA 关键词全大写);原始版保留为 transcript-whisper.json。
  2. 取景:python3 $S/ferramentas/rosto.py assets/clean.mp4 ../preparo --916 并在应用 punch 后的画面上测量 → vsl.json (punch, face, head, fullPos, splitPos;颜色和网格不改动)。头顶上方可用空间少于 ~300 像素 → 全屏画面顶部不放任何内容:文字、引题、印章放在胸前 (R1)。
  3. 真实素材 (R3):官方截图和标志放入 assets/img/ + ../assets/SOURCES.md (来源、许可、日期);事实和价格附官方页面;若无截屏 → 使用声明为插图的素材 (ferramentas/ilustracoes/)。切勿编造标志、数字或截图。
  4. 节拍图 → beats:assets/map.md (时间 × 讲话 × 镜头 × 元素,格式如 exemplo/mapa.md) 然后写 src/beats.js,每行映射表对应一行 K.* 调用,时间仅通过 K.at("确切短语") 设置 (请先完整阅读 exemplo/beats-exemplo.js)。每 1.5–3 秒出现新内容;全屏 ≈ 分屏;每次切换和每个文字元素都调用 K.hideMouth;K.mouthCaps 最后调用。
  5. node montar.mjs && npx hyperframes lint (0 错误;空快照 = 锚点损坏,请查看控制台)。
  6. ../entrega/planta.json (编号, 布局, 开始, 结束, 讲话, 画面) 和 node ferramentas/cards.mjs → entrega/cards/P01.png…。

关卡: 默认情况下直接进入第二阶段 — 用户要求快速。仅当用户要求 ("先给我看看") 或存在只有用户能解决的内容疑问 (事实、价格、名称) 时,才暂停并向用户展示节拍图或卡片。

4 · 第二阶段 · 渲染 (modelo/README.md)

npx hyperframes snapshot --at <每次切换和每个 beat> -o snapshots      # 面部无遮挡 (R1), 无裁剪/重叠
node ferramentas/zona-segura-dom.mjs . --strict                           # "安全区域 OK"
npx hyperframes render -q high -o ../render/_reel-bruto.mp4
node montar.mjs --so-camera && npx hyperframes render -q high -o ../render/_camera-so.mp4 && node montar.mjs
bash ferramentas/audio-final-vsl.sh ../render/_reel-bruto.mp4 ../render/reel-v1.mp4   # −14 LUFS ±0.3 · 峰值 ≤ −1 dBTP
node ferramentas/sons.mjs && bash ferramentas/folha.sh ../render/reel-v1.mp4 ../qa/folha-final.png
python3 "$S/ferramentas/verificar.py" .. --video render/reel-v1.mp4 --sfx ../sons.json --camera ../render/_camera-so.mp4

之后编写 MINUTAGEM.md (逐拍:时间、讲话、出现内容、布局、声音) 和 progresso.md 至项目文件夹。在展示前先自我审查: VERIFY.md 全部通过、帧表、R1 (面部)、R2 (精简模式下 SFX ≤ 0.8/秒)、R6 (字幕)、R7 (安全区域)、R8 (音频)。最多进行 2 轮调整后再交付。

5 · 交付与迭代

回复内容:reel-v1.mp4 的路径、时长 (原始 → 切割 → 最终)、LUFS 和峰值、画面数量和效果数量、切割中剔除的内容和被保护的内容、字幕修正、事实来源、未决事项。用户要求调整 → reel-v<N+1>.mp4 (旧版本保留在 render/ 中);切割变更 → 重新转录并重新映射 (corte/scripts/remapear.py),切勿手动重新计时。

操作规则

  • 引擎不可被重写。 modelo/kit/ 和 corte/scripts/ 保持原样;每个视频仅编写 src/beats.js、vsl.json、keeps.json 和调整参数。切割参数的修改只能基于 corte/references/EDICAO-BRUTA.md 第 9 节的诊断,一次一个,并记录在案。
  • 每轮一个版本,完整且经过验证。
  • 精简声音 ("sfxModo": "enxuto", vsl-padrao.json 中的默认值):≤ 0.8 效果/秒 (含打字声),打字声必须连续。仅当用户要求时才使用参考视频的精确声音 ("referencia")。
  • 始终使用真实素材;插图必须声明。面部永不遮挡。 安全区域。
  • 你在本次会话中负责生产。 如果用户要求特定 agent 或模型,请使用此 SKILL.md、ESTILO.md 和 modelo/README.md 作为简报启动通用型 agent,并审查其交付成果。
  • 出现任何失败 (ffmpeg、whisper、模型、npm、Chrome)?用一句话说明如何处理;corte/scripts/0-checar.py 可诊断机器环境。

相关技能