Communitygithub.com

Video Director - 视频导演技能

作为导演和编辑,使用 HyperFrames 端到端地指导、剪辑和交付专业视频,涵盖故事构思、拍摄脚本、音乐同步剪辑、动态文字、音效设计、调色和多种格式输出。

Video Director - 视频导演技能 是什么?

本技能将 AI Agent 定位为视频项目的导演与剪辑师,使用 HyperFrames 工具链完成从创意到交付的全流程。它通过分阶段工作流(创意采集、编排、音乐与网格、构建、检查、混音母带、渲染矩阵、交付)确保每个环节都有据可依。支持包括 Steam、itch.io、App Store、YouTube、TikTok、Reels 等主流平台,可直接处理屏幕录制或脚本化实机演示。技能内置导演默认原则(如以最强画面开场、按音乐节奏剪辑、文字动态设计、保持本地运行等),并提供了大量参考文件(音效、格式、分发规范等)和自动化脚本(节拍检测、字体适配、混音模拟、母带处理等),避免常见渲染错误。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DotanVG/video-director-skill/tree/HEAD/video-director

在你喜欢的 AI 中提问

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

文档

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 工具链能顺畅地继续执行。如果用户安装了个人风格套件技能(例如带有风格块和音效的动态图形工具包),请使用它的字体、风格块和音效。

工作流程

请按顺序完成以下阶段。每个阶段都有一个参考文件;到达该阶段时再读取,不要提前。

  1. 需求采集(references/intake.md)。询问你无法推断的内容:项目与原始素材、必须展示的内容、信息、受众、时长、平台、比例、质量、音乐、配音、品牌、自主程度及交付物。分批提问(每轮最多 4 个问题,首选方案放在最前面)。跳过用户已回答或简介中已说明的问题。当用户说“自主工作”或“直接做吧”时,仅询问阻塞性问题(缺失且无法自行获取的素材、无法验证的主张、会改变全局的选择),并在你的第一条进度通知中明确列出你采用的所有默认值。
  2. 发现。阅读用户提供的每一份简介、脚本和片段索引。使用 ffprobe 和时间戳联系单(scripts/contact_sheet.sh)检查每一个源文件,然后针对候选的关键时刻生成更精细的联系单。切勿相信笔记中的时间戳;请务必验证。如果素材缺失或质量不佳,请规划录制(references/capture.md)或进行询问。
  3. 编排(references/director.md,如果是游戏相关则还要看 references/game-trailers.md)。编写钩子句、叙事弧线以及时间表:每个场景、每个剪辑点(含来源和时间范围)、每个词及其落到的节拍、每个摄像机运动、每个音效。保存为 SCRIPT_FINAL.md(模板位于 assets/doc-templates/)。仅使用用户素材中的事实:绝不编造奖项、数字、日期或功能特性。
  4. 音乐与网格(references/sound.md)。选择或获取音轨,自己验证其速度和重拍(scripts/beat_grid.py),选择文件偏移量使一个重拍落在 0.0 秒处,并将场景切换锁定在小节线上、撞击音效锁定在节拍上。当用户希望进行 A/B 测试时,规划多个音乐版本。
  5. 构建(references/editing.md、references/kinetic-type.md、references/look.md、references/formats.md)。基于数据生成一次画面剪辑:为每个画面比例创建共享场景子合成,以及每个音乐版本的薄根文件。从 assets/template/(一个经过验证的生成器)开始。使用真实字体度量来调整文字大小(scripts/font_fit.py)。
  6. 检查与调色(references/qa-delivery.md)。执行 npx hyperframes lint,然后 check,接着在每个画面比例的关键时间点生成快照。亲自查看画面。修复、重新构建、再次检查。切勿相信第一次结果。
  7. 混音与母带(references/sound.md)。在渲染前离线模拟每个混音(scripts/simmix.py)使其接近响度目标,然后渲染,最后对最终文件进行母带处理(scripts/master.py,默认 -14 LUFS、-1 dBTP,视频流原样拷贝)。
  8. 渲染矩阵与验证(references/qa-delivery.md)。渲染每个版本×画面比例的组合,验证每个文件(ffprobe:大小、帧率、时长、编码格式;响度;联系单;在音乐切换点使用 scripts/audio_window.py 生成波形图)。
  9. 交付。最终文件、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.md16:9、9:16、1:1、4:5 的重构框和安全区域
references/sound.md节拍网格、音乐版本、音效、电平、模拟、母带、验证
references/platforms.mdSteam、itch、应用商店、YouTube、TikTok、Reels、Shorts、X、LinkedIn、即时通讯的交付规格
references/qa-delivery.mdQA 循环、渲染矩阵、文件命名、文档、分享副本、常见陷阱
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 模板

相关技能