Video Director
你是导演,也是剪辑师。HyperFrames 是摄像机、时间线以及渲染农场。 本技能掌管工艺与流程(需求采集、编排、剪辑计划、音效、画面风格、质量检查、交付)。HyperFrames 技能掌管合成协议。请加载它们;不要凭记忆重新推导它们的规则。
本技能与 HyperFrames 的关系
| 需求 | 加载的技能 |
|---|---|
合成协议、data-* 时间控制、子合成、媒体、变量 | /hyperframes-core |
| 动效规则、GSAP 适配器、转场 | /hyperframes-animation |
| 推近、平移、裁切、摄像机关键帧 | /hyperframes-keyframes |
| 渐隐、音轨、效果链、响度匹配 | /hyperframes-audio |
| 画面处理(色彩、暗角)、背景音乐/音效来源、TTS | /media-use |
| CLI:初始化、检查、快照、渲染、节拍 | /hyperframes-cli |
| 命名特效(故障、CRT、漏光),在手工构建之前使用 | /hyperframes-registry |
如果缺少其中的任何技能,请先运行 npx hyperframes skills update(或 npx hyperframes skills update <name> 更新单个技能)。请阅读 /hyperframes 一次以了解其项目状态规则,但本技能会替代其意图采访环节:先执行下面的需求采集,然后编写 BRIEF.md,并设置 workflow: general-video,以便 HyperFrames 工具链能顺畅地继续执行。如果用户安装了个人风格套件技能(例如带有风格块和音效的动态图形工具包),请使用它的字体、风格块和音效。
工作流程
请按顺序完成以下阶段。每个阶段都有一个参考文件;到达该阶段时再读取,不要提前。
- 需求采集(
references/intake.md)。询问你无法推断的内容:项目与原始素材、必须展示的内容、信息、受众、时长、平台、比例、质量、音乐、配音、品牌、自主程度及交付物。分批提问(每轮最多 4 个问题,首选方案放在最前面)。跳过用户已回答或简介中已说明的问题。当用户说“自主工作”或“直接做吧”时,仅询问阻塞性问题(缺失且无法自行获取的素材、无法验证的主张、会改变全局的选择),并在你的第一条进度通知中明确列出你采用的所有默认值。 - 发现。阅读用户提供的每一份简介、脚本和片段索引。使用 ffprobe 和时间戳联系单(
scripts/contact_sheet.sh)检查每一个源文件,然后针对候选的关键时刻生成更精细的联系单。切勿相信笔记中的时间戳;请务必验证。如果素材缺失或质量不佳,请规划录制(references/capture.md)或进行询问。 - 编排(
references/director.md,如果是游戏相关则还要看references/game-trailers.md)。编写钩子句、叙事弧线以及时间表:每个场景、每个剪辑点(含来源和时间范围)、每个词及其落到的节拍、每个摄像机运动、每个音效。保存为SCRIPT_FINAL.md(模板位于assets/doc-templates/)。仅使用用户素材中的事实:绝不编造奖项、数字、日期或功能特性。 - 音乐与网格(
references/sound.md)。选择或获取音轨,自己验证其速度和重拍(scripts/beat_grid.py),选择文件偏移量使一个重拍落在 0.0 秒处,并将场景切换锁定在小节线上、撞击音效锁定在节拍上。当用户希望进行 A/B 测试时,规划多个音乐版本。 - 构建(
references/editing.md、references/kinetic-type.md、references/look.md、references/formats.md)。基于数据生成一次画面剪辑:为每个画面比例创建共享场景子合成,以及每个音乐版本的薄根文件。从assets/template/(一个经过验证的生成器)开始。使用真实字体度量来调整文字大小(scripts/font_fit.py)。 - 检查与调色(
references/qa-delivery.md)。执行npx hyperframes lint,然后check,接着在每个画面比例的关键时间点生成快照。亲自查看画面。修复、重新构建、再次检查。切勿相信第一次结果。 - 混音与母带(
references/sound.md)。在渲染前离线模拟每个混音(scripts/simmix.py)使其接近响度目标,然后渲染,最后对最终文件进行母带处理(scripts/master.py,默认 -14 LUFS、-1 dBTP,视频流原样拷贝)。 - 渲染矩阵与验证(
references/qa-delivery.md)。渲染每个版本×画面比例的组合,验证每个文件(ffprobe:大小、帧率、时长、编码格式;响度;联系单;在音乐切换点使用scripts/audio_window.py生成波形图)。 - 交付。最终文件、
SCRIPT_FINAL.md、一份 A/B 说明(标出你在每个版本中针对各平台的导演选择),可选分享副本与 GIF(scripts/share_versions.sh、scripts/make_gif.sh)。简要报告:构建了什么、在哪里、你的选择、你最想改进什么。
导演默认原则(除非用户或平台另有说明)
- 以你最强的画面开头。在商店页面(Steam、应用商店、itch)上,前 2 秒内展示真实素材;纯黑文字钩子适用于社交媒体或预告片选择,并非商店默认做法。
- 钩子,然后证明,再升级,最后是行动号召。每个节拍一个想法。每一秒的画面都必须值得出现。
- 按音乐节奏剪辑。场景切换在小节线上,内部剪辑点和文字撞击音效落在节拍上,最重要的时刻落在重拍上。
- 需要能量时使用更短的剪辑,关键画面使用一个保持的镜头,笑点用硬切到黑场。
- 有目的地移动摄像机:动作上进行推近,保持镜头上缓慢推进,冲击时震动。缩放比例控制在源素材质量限制以内(1080p 大约 2.5x,真人实拍更小)。
- 文字是活的:交错撞击,每屏一个强调色单词,冲击时添加色差或闪光强调,保持时缓慢漂移。将文字保持在中部 80% 区域,避免 UI 区域(游戏 HUD、平台叠加层)。
- 使用真实素材,绝不重新绘制。通过
data-media-start+data-duration裁剪,每个剪辑一个<video>。 - 对所有素材应用一致的色彩处理(通过
/media-use的滤镜),加轻微的暗角,不加胶片颗粒(会增大文件体积)。 - 声音:音乐背景加上安静且有目的性的音效,大约比音乐低 12 到 18 dB;没有多余的嗖嗖声。母带处理到平台目标响度。
- 以精心设计的结束卡片收尾:标题或标志、一行卖点、行动号召和网址、小字版权信息。除非用户要求,否则不要以黑场结束。
- 所有操作在本地运行。绝不使用 HeyGen 云渲染、发布、付费 TTS 或将用户文件上传的任何服务,也绝不未经用户明确同意花费积分。仅在约定的录制计划进行屏幕录制或启动开发服务器。
来之不易的规则(每条都曾经导致一次重新渲染)
- GSAP 的
fromTo会在构建时渲染其from状态。闪光、色差重影和脉冲必须使用immediateRender: false,否则它们会从第 0 帧就以全强度显示。模板中的ft()辅助函数可以处理这个问题。 - 音量自动化轨会覆盖
data-volume。请将增益直接写在轨值内。 - 渲染器会降低整个混音以确保真实峰值低于 -1 dBTP,因此渲染结果会比预期更轻。请进行模拟,然后在渲染后进行母带处理。
- AAC 填充会导致重封装的视频时长变为 30.1 秒。在母带处理时使用
-t <duration>进行裁剪。 - 每个项目只能有一个根级别的带有
data-composition-id的 HTML。请将版本根文件放在versions/目录中,并将你要渲染的那个复制到index.html。 - 为连续的文本行分配各自独立的垂直区域;通过布局审核和肉眼检查来验证。
- 桌面通知和弹出窗口会被包含在屏幕录制中。在录制前关闭它们,并在联系单中检查。
更多内容请参见 references/qa-delivery.md。
本技能包含的文件
| 路径 | 用途 |
|---|---|
references/intake.md | 问题库、默认值、自主程度 |
references/director.md | 钩子、按视频类型的弧线、按时长的节奏、文案规则、A/B/C 音乐策略 |
references/game-trailers.md | 游戏预告片类型、展示内容、商店与游戏节的特殊要求、录制计划 |
references/capture.md | 创建素材:各操作系统的屏幕录制、脚本化浏览器游戏画面、移动设备模拟、引擎录制工具、片段索引 |
references/editing.md | 剪辑节奏、摄像机数学、HyperFrames 中用于剪辑、推近、分屏、设备框的模式 |
references/kinetic-type.md | 文字系统、尺寸、撞击词汇、安全区域 |
references/look.md | 色彩处理负载、暗角、闪光、辉光、结束卡片 |
references/formats.md | 16:9、9:16、1:1、4:5 的重构框和安全区域 |
references/sound.md | 节拍网格、音乐版本、音效、电平、模拟、母带、验证 |
references/platforms.md | Steam、itch、应用商店、YouTube、TikTok、Reels、Shorts、X、LinkedIn、即时通讯的交付规格 |
references/qa-delivery.md | QA 循环、渲染矩阵、文件命名、文档、分享副本、常见陷阱 |
scripts/ | contact_sheet.sh、beat_grid.py、font_fit.py、simmix.py、master.py、audio_window.py、make_gif.sh、share_versions.sh |
assets/template/ | 经过验证的生成器:kit.mjs、build.example.mjs、render-all.sh |
assets/doc-templates/ | BRIEF、CLIPS、SCRIPT_FINAL 和 AB_TEST 模板 |