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 · 项目
- 为每个 reel 在视频旁边创建一个独立文件夹:
reel-<slug>/,内含corte/,render/,qa/,entrega/,assets/。切勿重复使用其他剪辑;切勿在外部写入原始视频文件夹。 - 首次在本机运行时:
python3 $S/corte/scripts/0-checar.py(检查 ffmpeg, whisper-cli, numpy, 模型)。 - 用一句话说明将要发生的事 ("正在使用 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)
- 转录稿 (R6):手动修正
assets/transcript.json(Cloud → Claude, A → IA, 名称按品牌写法, CTA 关键词全大写);原始版保留为transcript-whisper.json。 - 取景:
python3 $S/ferramentas/rosto.py assets/clean.mp4 ../preparo --916并在应用 punch 后的画面上测量 →vsl.json(punch,face,head,fullPos,splitPos;颜色和网格不改动)。头顶上方可用空间少于 ~300 像素 → 全屏画面顶部不放任何内容:文字、引题、印章放在胸前 (R1)。 - 真实素材 (R3):官方截图和标志放入
assets/img/+../assets/SOURCES.md(来源、许可、日期);事实和价格附官方页面;若无截屏 → 使用声明为插图的素材 (ferramentas/ilustracoes/)。切勿编造标志、数字或截图。 - 节拍图 → beats:
assets/map.md(时间 × 讲话 × 镜头 × 元素,格式如exemplo/mapa.md) 然后写src/beats.js,每行映射表对应一行K.*调用,时间仅通过K.at("确切短语")设置 (请先完整阅读exemplo/beats-exemplo.js)。每 1.5–3 秒出现新内容;全屏 ≈ 分屏;每次切换和每个文字元素都调用K.hideMouth;K.mouthCaps最后调用。 node montar.mjs && npx hyperframes lint(0 错误;空快照 = 锚点损坏,请查看控制台)。../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可诊断机器环境。