reel-editor

短视频编辑器

将原始的真人出镜片段制作成符合品牌风格的竖屏短视频。所有品牌选择（颜色、字体、字幕样式、音效、CTA）都来自个人的 品牌文件，绝不使用此技能内置的默认设置。你负责剪辑；只有需要他们决定的事，才让他们来拍板。

首先：有没有品牌文件？

工作区为 ~/reels/，除非设置了 REELS_HOME。

• 没有 ~/reels/brand.md → 先运行 references/setup-interview.md 中的设置访谈。没有品牌文件时，不要剪辑任何片段，即使他们说“随便用什么都行”。访谈只需 5 分钟，也是此技能的核心。
• 品牌文件已存在 → 完整读取 brand.md 和 brand.json，然后继续。

检查工具（每台机器只需检查一次）

bash scripts/doctor.sh - 检查 ffmpeg、Node、HyperFrames 技能，以及（如果品牌文件指定使用 CapCut）CapCut 连接器。剪辑前先修复所有标出的问题。安装步骤见仓库 README。

按顺序剪辑

每条短视频都使用独立文件夹：~/reels/<yyyy-mm-dd>-<short-name>/。将原始片段复制进去（绝不编辑原文件）。

1. 转录 - python3 scripts/transcribe.py <clip> transcript.json。如果 ~/.config/reels/.env 中有 ELEVENLABS_API_KEY，则使用 ElevenLabs Scribe（词语时间点精确，字幕与词语同步）；否则使用本地 Whisper（免费，但时间点可能偏差约 0.3 s）。
2. 清理人声 - bash scripts/clean_audio.sh <clip> voice.wav（如果有背景噪声，添加 --denoise）。目标响度为 -14 LUFS，这是 Instagram 和 TikTok 预期的水平。
3. 审核（由他们决定） - 提出建议：要删减的内容（重复、说错后重来、冗长内容）、要去掉的语气词、移到结尾的 CTA、控制在 60 s 以内，以及图形方案。得到他们同意后再剪辑。 这是大家最关心的环节。 提出删减建议前，先查看开头和结尾： 在最初和最后 4 s 内每隔 0.5 s 截取一帧。即使有语音覆盖，也要剪掉任何相机准备动作（镜头对着地板／花园、翻转摄像头、伸手拿手机）。从他们在镜头中站稳后的第一帧开始，并从适合作为开场的词语开始。
   • 主要流程：Reel Review 页面。 先确认此会话中有 Artifact 和 ArtifactData 工具（如果它们处于延迟加载状态，请通过工具搜索加载）。如果有，请按照 references/review.md 操作：他们点击词语进行剪辑，观看实时粗剪，检查图形、字幕、声音和颜色，然后说“build preview”。其导入步骤会写入 edl.json + edit.json，因此跳到第 4 步的剪辑和第 5.4 步的渲染。
   • 备用方案：在聊天中审核，适用于没有这些工具的情况（较旧版本的 Claude Code、其他应用）。按编号列出转录文本（格式见 references/rough-cut.md），然后列出第 5 步中的卡片。
4. 收紧节奏，然后剪辑并调整速度 - 根据已批准的行编写 edl.json，然后运行 python3 scripts/tighten.py <folder>：它会去掉语气词并缩短保留行内部的停顿，力度由品牌的 "pacing" 设置决定（默认为 natural，也可设为 tight、fast；预设见 scripts/pacing.py）。这些调整无需逐项征得他们批准。然后运行 python3 scripts/cut.py <folder>。速度采用相同的预设，除非 brand.json 设置了 "speed"。聆听检查：重新转录 master.mp4，确认拼接处没有截断词语。
5. 图形和字幕：填充模板，不要做设计。 你在这里是剪辑师，不是设计师——视觉风格已根据品牌文件构建完成。
   1. python3 scripts/transcribe.py master.mp4 master_transcript.json
   2. python3 scripts/auto_edit.py <folder> → 起草 edit.json（按其字幕模式添加字幕、添加推近效果）
   3. 一次性自行编辑 edit.json：每句话中的一个关键词设置 "accent": true，并按照 brand.json 的 "graphics" 要求的密度添加卡片：minimal 约每 8-12 s 一张，balanced（默认）每 4-6 s 一张，busy 每 2-4 s 一张。没有内容可展示的行不加卡片；不要为了填空而给每个数字都制图，或给每个工具都加截图。卡片类型和字段见 scripts/build_reel.py 的文件头；HyperFrames 目录中的动态效果（轮播图、图表、计数器、通知、光标、关注卡片）见 references/motions.md。每张卡片都必须展示对应那一行确切表达的内容。
      • Hook 标题： 每行最多约 10 个字符，分成 2-3 行（"still / uploading / screenshots?"），这样显示出来才够大。这是唯一带描边的文字。
      • 轮播图： 如果 brand.json 中有 "require_carousel": true，每条 Reel 都必须添加一个（motion 卡片，名称以 carousel-* 开头，images 使用截图／他们的素材）。如果没有适合的行，就询问他们；如果他们拒绝，则设置 "no_carousel_ok": true。
      • 截图： 对于他们提到且该行内容所指的工具或网站，运行 bash scripts/screenshot.sh <url> shots/<name>.png。退出代码为 2 表示网站已拦截：尝试使用该工具的营销页面，或请他们提供截图。绝不要使用空白截图。
      • 混合使用不同类型： 网站截图、色块、列表卡片（液态玻璃效果设置 "glass": true）、他们素材中的贴纸、用于重点时刻的 follow 卡片，以及在他们提到数字时使用的计数器或图表。
   4. 使用 REEL_PREVIEW=1 bash scripts/render.sh <folder> 渲染草稿（1080p，低优先级）；得到批准后，运行 bash scripts/render.sh <folder> --final（分辨率由 brand.json 指定；使用 CapCut 流程时添加 --capcut）→ 生成 final.mp4 + 阶段用时。 这里不要手写合成 HTML，也不要使用其他 HyperFrames 工作流：这些方式更慢，而且会忽略品牌模板。只有当他们明确要求模板不支持的效果（例如文字显示在他们头后方）时，才说明这样会更慢，然后使用 hyperframes skill 实现该效果。
6. 质量检查 - 运行 python3 scripts/qa.py <folder>（响度、大小、时长、缺失词语）。然后在每张卡片出现时截取一帧并检查：文字是否位于画面内、在背景上是否清晰可读、是否符合品牌风格。修复 edit.json 并重新运行 render.sh，直到检查通过。
7. 交付 - 运行 bash scripts/deliver.sh <final.mp4> "<clear name>" → 在他们的交付文件夹中生成可供上传的 MP4。
8. CapCut（仅当 brand.json 中有 "capcut": true 时） - 创建可编辑的 CapCut 草稿并提供链接。见 references/capcut.md。 告诉他们改了什么，以及需要通过试听检查什么（剪辑点、名称、品牌用词是否拼写正确）。

以品牌规则为准

如果品牌文件和你的偏好不一致，以品牌文件为准。如果他们在编辑时纠正了某项内容（“不，字幕绝不能加描边”），请立即将其添加到 brand.md 的“Rules”下，确保下一次编辑能做好。

常见错误

错误	应采取的做法
品牌文件尚不存在就开始编辑	进行设置访谈
盲目按 Whisper 的单词时间点剪辑	检查剪辑衔接处；将剪辑点微调到单词之间的静音间隙
图形只起装饰作用，而非用于说明	每张卡片都应展示这句台词所说的具体内容
使用品牌文件禁止的字体制作字幕	执行第 5 步前，重新阅读 brand.md 中的“Rules”
声称 CapCut 到处都能用	事实并非如此（参见 capcut.md）。MP4 方案始终可用
通过降低标准来解决 QA 未通过的问题	修正剪辑，然后重新运行 QA