制作视频 — 从初学者到完成 MP4 的技能
两个阶段,八个顺序关卡。每个关卡都生成下一个关卡所需的实际产物。不要跳过任何关卡。
何时使用此技能 — 以及何时转交
使用此技能当:
- 用户是 HyperFrames 新手,从一个概念、脚本或提纲开始
- 用户想要端到端的完整指导,而不是框架参考材料
- 用户尚未决定视频格式
转交当:
- 用户粘贴一个 URL 并希望从该网站制作视频 → 调用
/website-to-hyperframes - 用户明确想要 9:16 竖屏的头部出镜解说视频(包含面部摄像头和场景叠加层)→ 在此执行关卡 1–4,然后从关卡 5 起调用
/short-form-video - 用户询问的是框架规则,而不是视频 → 调用
/hyperframes
两个阶段
- **阶段 1 — 访谈(关卡 1–4):**在执行任何代码之前,通过一次对话式访谈收集所有信息。意图、格式、脚本、声音、风格、素材、节奏。综合生成
BRIEF.md并等待明确批准。 - **阶段 2 — 构建(关卡 5–8):**搭建脚手架 → 分镜板 → 合成 → 检查 → Studio 预览 → 草稿渲染 → 视觉验证 → MP4 预览 → 最终渲染。
关卡 1 · 意图与格式
通过 AskUserQuestion 一次问一个问题,尽可能提供多项选择。
- 这个视频的用途是什么?(宣传 · 社交媒体广告 · 发布预告 · 产品演示 · 教程 · 讲解 · 开头/结尾卡片 · 其他)
- 目标观众是谁?(自由回答)
- 目标时长?(10–20 秒短 · 20–45 秒宣传 · 45–90 秒讲解 · 1.5–3 分钟教学 · 自定义)
- 画面比例?(16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- 帧率?(30 默认 · 60 用于清晰 UI · 24 电影感)
- 平台/交付限制?(文件大小 · 截止日期 · 播放平台)
**关卡标记:**全部六个问题已捕获。如果答案是 9:16 + 面部摄像头,计划在关卡 5 转交给 /short-form-video。
完整问题库:Read: references/interview-questions.md
关卡 2 · 脚本与声音
- 脚本来源?(粘贴 · 大纲 → 我来起草 · 我录制 · 文本转语音 · 无旁白)
- 如果使用 TTS:声音偏好。提供
npx hyperframes tts --help中的选项。同时捕获语速。 - 如果使用面部摄像头:录制路径 · 全屏或角落放置 · 是否需要转录?(
npx hyperframes transcribe <file> --model small.en --json) - 字幕?(关闭 · 炫酷 · 企业 · 逐字卡拉OK · 极简)
**关卡标记:**脚本已捕获(或起草)、音频方案已捕获、字幕方案已捕获。
关卡 3 · 风格收集
**在向用户提问之前,先盘点现有素材。**检查 <workspace-root>/assets/ 和任何项目 assets/ 文件夹。不要询问已存在的文件。
然后逐步提问 — 用户不需要回答所有问题:
- 风格指南或品牌文档?(粘贴/路径 · 无)
- 调色板?(十六进制代码 · 无 — 使用 MOTION_PHILOSOPHY 默认值)
- 字体?(Google Fonts 名称 · 文件路径 · 无 — 使用默认的 Inter + JetBrains Mono)
- Logo 文件?(路径 · 无 — 改用文本文字标记)
- 参考视频以获得风格感?(URL/路径 · 无)
- 其他素材?(截图 · 产品照片 · 补充镜头 · 音乐 — 列出路径)
- MOTION_PHILOSOPHY 美学(黑色画布 · 铬金属文字 · 透视网格 · 挥鞭过渡)还是其他感觉?
- 节奏?(动感 1–2 秒 · 平衡 2–3 秒 · 轻松 3–5 秒)
- 音乐?(无 · 环境氛围 0.15 · 背景音乐 0.4 · 完整音量 0.8 — 如果用户已有文件则提供路径)
- 结尾/行动号召文字?
**切勿强加品牌风格给用户。**仅在用户明确拒绝提供风格时才回退到 MOTION_PHILOSOPHY 默认值。
完整风格流程 + MOTION_PHILOSOPHY 默认值:Read: references/style-intake.md
关卡 4 · 简报综合(构建前的硬关卡)
- 读取
MOTION_PHILOSOPHY.md(如果存在于工作区根目录)— 如果存在则必须读取。如果缺失,则使用references/style-intake.md中的默认值,并在简报中注明缺失。 - 询问项目存放位置(如果不明显):
- 如果
video-projects/存在 → 使用video-projects/<slug>/ - 否则 → 询问用户
- 如果
- 写入
<project-folder>/BRIEF.md:- 子弹 · 意图 · 观众 · 尺寸 · 帧率 · 时长
- 脚本(完整或大纲)
- 声音选择 · 字幕方案 · 面部摄像头方案
- 风格档案:调色板(十六进制)、字体、Logo 路径、参考视频
- 节奏
- 素材清单及路径
- 结尾 / CTA 文字
- **显示简报。等待明确批准。**在得到明确的“是,开始构建”之前,不要进入关卡 5。
关卡 5 · 搭建脚手架与分镜板
首先检查是否需要转交
如果简报描述的是 9:16 竖屏的头部出镜解说视频(面部摄像头 + 场景叠加层),立即调用 /short-form-video 并转交该简报。它的 4 层脚手架专为此格式设计。
否则继续:
脚手架
mkdir <project-folder>- 如果存在格式相似的兄弟项目,提供将其
hyperframes.json+meta.json复制为模板的选项。否则在文件夹内运行:npx hyperframes init - 编辑
meta.json,填入用户的子弹、尺寸和帧率。 - 将提供的素材复制到
<project-folder>/assets/。 - 从关卡 3 创建
<project-folder>/assets/style-profile.md— 调色板/字体/Logo 的单一事实来源。
分镜板
使用 references/storyboard-template.md 中的模板生成 <project-folder>/STORYBOARD.md。每个节拍包含:
节拍 N — 标题(开始–结束,时长)— 一句话概念
视觉元素:[每个元素,大小,动画,时机]
运动语言:[运动类型]
使用的缓动:[3–4 个不同的 GSAP 缓动]
退出:[过渡到下一个节拍]
音频:[VO 对白 / 音效 / 音乐层]
文件顶部:一个包含场景 · 开始 · 时长 · 合成文件的时机表。
提出三分结构建议:
- 第一幕(钩子)≈ 总时长的 20%
- 第二幕(主体)≈ 55%
- 第三幕(回报 + 结尾,保持 4–6 秒)≈ 25%
(MOTION_PHILOSOPHY §0 法则 9, §1。)
将用户意图映射到目录块:Read: references/catalog-intent-map.md
**关卡标记:**显示分镜板 + 时机表。反复迭代直至用户批准。
关卡 6 · 构建合成
调用 /hyperframes 以获取框架规则。此技能负责脚手架和纪律;/hyperframes 负责执行规则。
为每个子合成搭建脚手架
<div data-composition-id="scene-name" data-start="..." data-duration="...">
<style>[data-composition-id="scene-name"] { /* 作用域限制 */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... 补间动画 ...
tl.to({}, { duration: SLOT_DURATION }, 0); // 锚点 — MOTION_PHILOSOPHY 法则 11
window.__timelines["scene-name"] = tl;
})();
</script>
</div>
完整模板 + 字幕模式 + 环境背景模式:Read: references/composition-scaffold.md
构建规则
- 环境背景放在
data-track-index="0"上,持续整个合成的时长。 - **动感文字开场:**逐字交错 0.06–0.10 秒。
- 字幕作为根合成
index.html中 body 级别的同级元素放置,每个字幕带有data-track-index ≥ 20。切勿放在场景时间线内(MOTION_PHILOSOPHY §3.13)。 - 目录块通过
npx hyperframes add <name>安装。立即限定该块的 CSS 作用域到[data-composition-id="..."]— 目录块自带的html, body { ... }规则会渗透到父文档中,因为它们是作为子合成加载的。 - **竖屏 + 面部摄像头:**将原生 1920×1080 面部用变换(
translate+scale)包裹,用于下半部分或全屏模式。(如果你最终到达这里而不是/short-form-video,强烈考虑转交。) - 仅应用用户提供的内容。 用户提供的调色板、字体、Logo。不要注入其他任何东西。如果他们选择了 MOTION_PHILOSOPHY 默认值,则从
references/style-intake.md获取调色板 + 字体的默认组合。
确定性
不使用 Math.random()、Date.now() 或渲染时的 fetch()。使用种子化 PRNG 或正弦谐波哈希(MOTION_PHILOSOPHY §3.10)。
关卡 7 · 检查 → Studio 预览(预览关卡 1 — 强制)
npx hyperframes lint— 修复所有错误,分类警告。- 在后台运行
npx hyperframes preview。 - 等待“Studio running”出现在
http://localhost:3002。 - 将 URL 以及单个合成的 URL(
http://localhost:3002/?comp=<id>)交给用户。如果项目包含 WebGL 着色器块,首先提供单个 URL — 软件 WebGL 回退可能会拖慢主合成。 - 等待明确的“看起来不错,渲染一个草稿” 后再继续。沉默不等于批准。
热重载已启用 — 编辑内容会实时显示。
关卡 8 · 草稿渲染 → 视觉验证 → MP4 预览 → 最终版本
草稿渲染
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
视觉验证(交付前强制)
通过检查不意味着设计有效。提取帧并查看它们。
mkdir -p renders/frames- 对每个节拍的高光时刻以及每个过渡:
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - 在每张 PNG 上调用
Read工具。Read工具会将图像加载到上下文中 — 不要仅列出文件名。 - 逐帧确认:没有裁剪的面部、每张场景的面部模式正确、文字可读且符合调色板、没有溢出、过渡落在正确的词语上、没有空白帧。
- 如果发现问题:修复 → 重新渲染 → 重新验证。永远不要交付有问题的草稿。
MP4 预览(预览关卡 2 — 强制)
npx serve renders -p 8080 -n
请勿使用 Python 的 http.server — 它不支持 HTTP Range 请求,因此拖动进度条会出错。
将 http://localhost:8080/<slug>-draft.mp4 交给用户。等待明确的批准确认播放和音频同步。
最终渲染
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
报告输出路径。完成。
完整预检 + 交付前清单:Read: references/build-checklist.md
非协商规则(承重 — 请勿软化)
- **不要跳过预览关卡 1(Studio)或预览关卡 2(渲染后的 MP4)。**每个构建始终有两个关卡。
- 不要声称渲染已完成,直到帧已提取并通过
Read工具读取。 - **不要在任何专用项目文件夹之外构建。**切勿将
index.html放在工作区根目录。 - 在盘查用户工作区之前,不要向用户询问素材。
- **不要跳过每个子合成时间线末尾的
tl.to({}, { duration: SLOT_DURATION }, 0)锚点补间。**MOTION_PHILOSOPHY 法则 11。 - **不要在渲染逻辑中使用
Math.random()/Date.now()。**仅使用种子化哈希。 - **不要向
<video>标签添加class="clip"。**它会破坏视频播放。 - **不要强加品牌风格给用户。**先询问;仅在用户明确拒绝时才回退到 MOTION_PHILOSOPHY 默认值。
参考资料
references/interview-questions.md— 按关卡划分的完整问题库references/style-intake.md— 风格访谈 + MOTION_PHILOSOPHY 默认值references/catalog-intent-map.md— “用户说 X → 安装 Y”references/storyboard-template.md— 逐节拍模板 + 示例references/composition-scaffold.md— 作用域样式 + IIFE GSAP 模板references/build-checklist.md— 预检 + 交付前关卡
外部(工作区级别):
MOTION_PHILOSOPHY.md— 此技能假设存在的唯一外部参考。美学基线。如果文件缺失,则回退到references/style-intake.md。
相关技能
/hyperframes— 框架规则,在关卡 6 调用/hyperframes-cli— init · lint · preview · render · transcribe · tts/hyperframes-registry— 安装目录块/gsap— GSAP 动画参考/short-form-video— 在关卡 5 转交,用于 9:16 头部出镜格式/website-to-hyperframes— 如果起始输入是 URL,则在关卡 1 转交