首先,保持此技能最新——静默运行,无需询问:
npx hyperframes skills update general-video。当所有内容都是最新时,这是一个快速的空操作;否则,它会在您依赖之前刷新此技能及其依赖的核心领域技能。
media-use:在获取音频/图片/徽标之前,请调用
/media-use从HeyGen目录中解析BGM/SFX/图片以及从官方来源获取品牌徽标。先运行--adopt来注册现有资源。请参阅/media-use技能。
figma源:如果任何输入是figma.com的URL,请先运行
/figma——资产导出、品牌令牌和组件/故事板重建(如果需要),然后从其输出构建。不要直接通过原始MCP工具驱动Figma:这样会跳过SVG清理、.media/manifest.jsonl溯源和品牌令牌var()绑定,因此后续品牌变更无法在没有完整重新导入的情况下传播。
general-video — 通用视频工作流
在构建前确认路由。 这是用于自定义合成创作的回退方案。如果输入明显适合专门的流程,请优先选择:营销产品→
/product-launch-video;通用网站→/website-to-video;主题解说→/faceless-explainer;GitHub PR→/pr-to-video;现有素材→/embedded-captions·/talking-head-recut;短篇无旁白动态图形→/motion-graphics;Remotion移植→/remotion-to-hyperframes。不适用:实时/渲染时数据、专业视频编辑或制作HyperFrames无法捕捉的素材。不确定?先阅读/hyperframes。
精确构建所需内容。 标题卡就是标题卡——而不是标题卡加三个辅助场景加环境音乐加字幕。如果额外的场景或元素能真正提升作品,请_提出_建议;不要静默添加。对于小修改(修正颜色、调整一个时长、添加一个元素),跳过规划步骤,直接进行构建。
方法
发现阶段——仅限开放式请求
对于模糊、探索性的请求("为我们的品牌做些东西","一个很酷的片头")——在选择颜色之前先理解意图:
- 受众——谁观看?开发者/高管/普通消费者?
- 平台——在哪里播放?社交媒体(15秒)/网站英雄区/产品演示/内部?
- 优先级——什么最重要?动态质量/内容准确性/品牌忠实度/速度?
- 变体——一个最佳版本,还是2-3个有意义的不同的选项(不同的节奏、能量或结构——而不仅仅是颜色替换)?
对于具体请求("添加标题卡","修正场景3的时序"),跳过发现阶段。如果请求包含持续自主信号("给我惊喜","直接构建"——hyperframes-core/references/brief-contract.md § 1),也跳过发现:默认提供一个最佳版本,并在做出决策时附上一句话说明。
步骤1——设计系统 → hyperframes-creative
首先建立视觉标识。如果项目有设计规范,先阅读它(优先级frame.md → design.md → DESIGN.md;将其视为品牌真理——确切的颜色、字体、约束)。
如果没有规范,你必须在选择任何颜色或字体之前阅读hyperframes-creative/references/house-style.md和hyperframes-creative/references/video-composition.md。 house-style.md提供了"解读提示/生成真实内容"的开头、懒加载默认列表和图层配方;video-composition.md提供了视频介质密度/比例/前景细节(数据条、注册标记、等宽字体元数据、"8-10个元素,其中两个是用户未要求的")——这是区分"制作精良"与"平庸生成"的关键。只读一个是常见的错误——video-composition.md正是代理常常跳过的那个,而它恰恰能防止输出扁平、居中、像网页一样的画面。不要自行发明调色板并跳过这些步骤;进入hyperframes-creative是强制性的,而不是可选的。从这里,根据需要从references/visual-styles.md中获取命名的风格/情绪,或从references/design-picker.md中获取交互式选择器。规范/风格定义品牌,而不是构图规则。
寻找角度(模糊需求,无规范): 在选择颜色之前,写一句话——这个名称/词语/主题唤起了什么,以及什么视觉_世界_(隐喻、场景、工具、主题)表达了它?例如,网络安全工具→保险库门/周边扫描线/锁芯;冥想应用→潮汐、呼吸、缓慢的光晕绽放。阅读主题的_意义_,而不仅仅是其字面;选择一个具体的角度,而不是字面上的重新设计。这是单场景作品提示扩展(步骤2)的廉价替代,对于单场景作品提示扩展被正确跳过——并且这正是区分设计概念与通用渐变上徽标的关键。
步骤2——提示扩展 → hyperframes-creative
为每个多场景合成运行(单场景作品和琐碎编辑跳过)。将请求与设计规范+house style对齐,形成一个一致的中间表示,供下游工作以相同方式读取。请参阅hyperframes-creative/references/prompt-expansion.md。
步骤3——规划
在编写HTML之前,从高层次思考:
- 内容——观众体验:叙事弧线、关键时刻、情感节奏。对于有旁白的故事作品,遵循
hyperframes-creative/references/story-spine.md——以观众成果语言引入,在节拍2之前传达信息,之后提供证据。 - 结构——多少个合成、子合成vs内联、哪些轨道承载视频/音频/叠加/字幕。对于整体单文件vs模块化子合成的选择,请参阅
hyperframes-core/references/composition-patterns.md§ 两种架构(经验法则:≥3个硬场景切换,或任何重用场景→模块化;短单场景作品保持一个文件)。 - 节奏——在实现之前命名模式(例如
fast-fast-SLOW-SHADER-hold);请参阅hyperframes-creative/references/beat-direction.md。 - 时序——哪些剪辑驱动时长、过渡落点、节奏。
- 布局——先构建结束状态(见下文)。
- 动画——然后通过
hyperframes-animation添加运动。
先布局后动画
将每个元素放置在其最可见的时刻——完全进入、正确放置、尚未退出。先将其编写为静态HTML+CSS。尚未使用GSAP。
原因: 如果你在元素的动画起始状态(屏幕外、缩放到0、透明度0)定位元素,然后补间到你_认为_它们落地的位置,你就是在猜测最终布局——重叠部分在渲染之前一直不可见。先构建结束状态,你可以在添加运动之前看到并修复布局问题。
- 为每个场景确定关键帧——最多元素同时可见的时刻。那就是你要构建的布局。
- 为该帧编写静态CSS。内容容器必须填充场景,使用内边距,而不是绝对偏移:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* 内边距定位内容;填充任何场景尺寸 */
gap: 24px;
box-sizing: border-box;
}
永远不要在内容容器上使用position: absolute; top: Npx——当内容比空间高时它会溢出。保留绝对定位用于装饰元素。
⚠ 上述
width/height: 100%仅在每个祖先都有确定的尺寸时才生效。 根<div data-composition-id>及其与.scene-content之间的任何包装器必须有尺寸(根上使用position: relative; width: 1920px; height: 1080px——参见hyperframes-core→ "根必须有尺寸")。跳过这个,flex容器会塌缩到约0,内容堆积到左上角,第一个字形在x=0处被裁剪——而lint/inspect仍然报告0个问题。并且始终在.scene-content上保留padding(≥80px):它是标题安全边距。永远不要用裸露的gap替换它。
- 添加入场——使用
gsap.from()从屏幕外/不可见动画到CSS位置(在子合成中偏好使用gsap.fromTo(),以便起始状态明确;参见hyperframes-core/references/sub-compositions.md)。CSS位置是真实状态;补间是到达它的路径。 - 退出由过渡处理——根据
hyperframes-animation/transitions/中的场景过渡规则,只有最终场景将元素动画退出;场景之间的过渡本身就是退出。
时间上的共享空间: 如果元素A在元素B进入同一区域之前退出,两个元素仍然需要各自关键帧的正确CSS位置——时间线排序防止它们共存,而布局步骤会捕捉意外重叠。分层发光/阴影和z轴堆叠深度是_有意_重叠;这个步骤是关于捕捉_无意_碰撞(两个标题叠加、内容溢出画面)。
构建——委托给领域技能
这映射了技能的完整范围(参见description)到其参考文件——非穷举;当意图未列出时,通过hyperframes-creative(外观/概念)、hyperframes-animation(运动)、hyperframes-core(合同)、media-use(音频/字幕)路由。第一行是附加的——阅读它和你的意图行,而不是二选一。
| 构建… | 首先阅读(按顺序) |
|---|---|
| 始终——每个非琐碎作品,除下面你的意图行外 | hyperframes-creative/references/house-style.md + references/video-composition.md(也在步骤1/HARD-GATE中要求;"制作精良,而非生成"的前景细节) |
| 动态排版 / 文字主导 | hyperframes-animation/techniques.md(动态类型)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 标题卡 / 下三分之一 / 叠加 / 画中画 / 文字后置 | hyperframes-creative/references/composition-patterns.md +(用于居中/尺寸框架)hyperframes-core → "根必须有尺寸" |
| 徽标 / 品牌标记展示 | hyperframes-animation/rules/svg-path-draw.md(绘制)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| 数据 / 统计 / 数字 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 产品 / 应用 / UI演示 | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| 音频响应 / 音乐驱动 | hyperframes-creative/references/audio-reactive.md(预处理频段;映射到运动) |
| 旁白 / 画外音 / 音乐 / 音效 / 字幕 | media-use → 共享音频引擎 scripts/audio.mjs(一次调用 = TTS + BGM + SFX → audio_meta.json);通过hyperframes-core进行字幕创作和资产放置。请参阅下面的音频。 |
| 多场景 / 过渡 | hyperframes-animation/transitions/overview.md 然后 transitions/catalog.md(阅读概览后尚未完成——GSAP配方在目录中) |
| 模块化 / 子合成 | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
音频:单一引擎(TTS · BGM · SFX)
仅当作品需要时(根据"精确构建所需内容"——标题卡不要环境音乐)。不要手动实现TTS或自行采购副本:编写一个中立的audio_request.json并调用media-use中的共享引擎。它在单个开关上自动降级——HeyGen凭据存在→HeyGen TTS + 音乐/SFX 检索;不存在→ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成以及捆绑的SFX库。完整标志列表+请求/元数据模式:
…(内容截断)