媒体使用:在获取音频/图片素材前,请调用
/media-use从 HeyGen 目录中获取 BGM/音效/图片。先运行--adopt注册已有资产。详情见/media-use技能。
网站转 HyperFrames
捕获一个网站,并从中制作专业视频。
在第 0 步之前确认路径。 此技能制作的是 针对 / 来自一个通用站点 的视频。如果用户实际上是 营销 / 发布 / 推广一个产品(即使来自此 URL,即使是“我们网站的推广片”)→ 使用
/product-launch-video。无网站的话题解释 →/faceless-explainer;GitHub PR →/pr-to-video;重新剪辑 / 重新调色 / 重新排序现有视频文件 → 超出范围。如果用户模糊地说“做个视频”,或者不确定是发布视频还是通用网站视频?请先阅读/hyperframes(完整的路径选择表 + § HyperFrames 无法做到的事项)。
用户可能会说:
- “把这个网站变成一个 15 秒的 Instagram 社交媒体短片。”
- “从 https://... 制作一个 30 秒的站点导览/展示。”
- “捕获我们的首页,然后用它自己的视觉元素制作一个视频。”
工作流程包含 7 个步骤。每一步都会生成一个产物,作为下一步的入口。默认情况下是协作模式——标记为 💬 的关卡会停下来询问用户。如果用户表示自主模式(“你来决定吧”、“给我个惊喜”),则跳过 💬 用户偏好关卡;详情见 step-2-brief.md。
自主模式并非“跳过所有关卡”。 自主模式覆盖用户偏好问题(TTS 提供商、语音、色彩强调、节拍数、音乐是/否、字幕是/否——代理代表用户决定)。它不覆盖质量验证关卡。以下关卡在自主模式下不可跳过:
- 资产审计(第 3 步)——查看样张并为每个资产提供使用/跳过理由
- 逐节拍 HTML 读取(第 5 步)——每个节拍的结构化证据块
- 完成定义检查清单(第 6 步)——包括动画映射、逐警告 WCAG 验证、音频/动效回放
- 诚实声明部分(第 6 步)——“我未验证的内容”必须出现在你的最终总结中
如果你发现自己在推理“自主模式倾向于行动,所以我会跳过 X”——而 X 是一个验证关卡,而非偏好问题——那么这个推理是错误的。倾向于行动适用于决定 构建什么,而非决定 是否验证。
第 0 步:捕获并理解品牌
阅读: references/step-0-capture.md
捕获网站,然后读取提取的数据以理解 品牌和产品——它的功能、目标用户、语言风格、氛围。捕获的资产是后续使用的品牌工具包,而非视频的构建块。
在简报之前显示登录状态——运行 npx hyperframes auth status 并 逐字转述其输出(不要转述或重写)。 它会报告语音/BGM 将使用 HeyGen 还是本地引擎,并在未登录时告知如何登录。如果未登录,请停下来等待用户选择——登录,或者说“go”/“offline”以使用本地引擎继续——然后再询问简报或其他任何事情。 将其视为真正的决策点,而非简单的附注;不要将选择纳入简报问题中,也不要将密钥写入仓库的 .env 文件。(在自主模式下,记录状态并以离线模式继续。)参见 ../hyperframes-media → Preflight 以获取权威指导。
关卡: 打印站点摘要——战略优先(产品做什么、目标用户、品牌语调)在资产/颜色/字体清单之前;登录状态已显示(已登录,或已继续离线模式)。
第 1 步:品牌识别
阅读: references/step-1-design.md
编写 DESIGN.md——一份包含视觉识别信息的品牌备忘单:颜色、排版、组件样式、布局原则。使用 design-styles.json 获取精确的计算值。
快速选项: 对于快节奏视频(逐节拍展示牌),DESIGN.md 可以是一份 50 行的颜色+字体+注意事项摘要——而非 300 行的文档。第 5 步的子代理提示会直接粘贴品牌值,因此 DESIGN.md 的深度仅对复杂构图重要。
关卡: DESIGN.md 存在(任意长度),至少包含:色板、字体选择以及注意事项。
第 2 步:策略与信息传达
阅读: references/step-2-brief.md, references/capabilities.md(扫描目录——仅按需深入阅读相关章节)
在讨论视觉或资产之前,先与用户对齐 视频必须传达什么信息。解析用户的提示——他们很可能已经给出了视频类型和风格。仅询问缺失的信息:这个视频必须说的一个要点、叙事弧线以及目标受众。
关卡: 视频类型、时长、格式,以及——关键——信息和叙事弧线已确定。没有这些,第 3 步无法编写概念优先的故事板。
第 3 步:故事板 + 脚本 💬
阅读: references/step-3-storyboard.md
以概念优先的方式编写故事板:信息 → 叙事弧线 → 服务于弧线的节拍 → 每个节拍的技术 → 最后进行品牌色调调整。然后编写匹配的解说脚本。向用户展示两者,并附上逐节拍摘要。迭代直到他们批准。
关卡: STORYBOARD.md + SCRIPT.md 存在 并且 用户已批准计划。
第 4 步:配音、计时 + 字幕 💬
如果第 2 步确定无旁白——询问背景音乐,然后跳到第 5 步。否则:询问用户选择哪个 TTS 提供商(HeyGen TTS、ElevenLabs 或 Kokoro),生成音频,转录,将时间戳映射到节拍。然后询问字幕。
关卡: 要么 (a) 没有要求旁白并且故事板包含手动节拍时间,要么 (b) narration.wav + transcript.json 存在并且节拍时间已用实际时长更新。
第 5 步:构建合成
阅读: hyperframes 技能(加载它——每条规则都很重要)
阅读: references/step-5-build.md
按照故事板(第 3 步)中确定的架构和节奏构建 index.html 和合成文件。子代理在报告前对每个节拍运行 hyperframes lint 和 hyperframes snapshot。
关卡: 每个 compositions/beat-N.html 已被主代理根据 DESIGN.md 和 STORYBOARD.md 从头到尾阅读过。逐节拍检查清单位于 step-5-build.md 中。
第 6 步:验证与交付
阅读: references/step-6-validate.md
进行 lint 检查、验证、根据视频长度缩放拍摄快照(公式:max(节拍数 × 3, ceil(视频时长秒数 / 2))),并逐一检查。在交付前修复问题。交付 localhost Studio 项目 URL——仅根据用户明确请求渲染为 MP4。仅在 交付时 提供 Studio URL——它是最终的、稳定的预览;构建阶段的快照是无头的,因此不要在构建过程中弹出预览。
交付你引以为豪的作品。 在交付之前,问问自己:我会以我的名义把这个发布到社交媒体上吗?如果不会,修复问题。
关卡: npx hyperframes lint 和 npx hyperframes validate 通过且零错误,并且最终回复中包含活跃的 Studio 项目 URL。
快速参考
视频类型
各类视频的典型约束——作为起点,而非公式。节拍数应根据内容和旁白而定,而非目标范围。
| 类型 | 典型时长 | 时长驱动因素 | 旁白 |
|---|---|---|---|
| 社交媒体广告 (IG/TikTok) | 10–15 秒 | 平台限制 | 可选 |
| 产品演示 | 30–60 秒 | 脚本长度 | 完整旁白 |
| 功能发布公告 | 15–30 秒 | 功能复杂度 | 完整旁白 |
| 品牌展示片 | 20–45 秒 | 音乐轨道 | 可选,音乐主导 |
| 发布预告片 | 10–20 秒 | 钩子能量 | 极少 |
节拍数故意不在此表中——它应来自故事板,而非来自“社交媒体广告 = 3-4 个节拍”。一个复杂产品的社交媒体广告可能需要 5 个时机恰当的节拍。一个具有单一强视觉主题的品牌展示片可能只需要 3 个。
格式
- 横屏:1920x1080(默认)
- 竖屏:1080x1920(Instagram 故事、TikTok)
- 正方形:1080x1080(Instagram 信息流)
参考文件
| 文件 | 何时阅读 |
|---|---|
| step-0-capture.md | 第 0 步——捕获、理解品牌和产品,编写战略优先的站点摘要 |
| step-1-design.md | 第 1 步——编写 DESIGN.md 品牌备忘单(5 个部分,250-350 行;对于展示牌式社交媒体广告,可使用 50 行快速通道) |
| step-2-brief.md | 第 2 步——与用户对齐信息、叙事弧线和受众 |
| capabilities.md | 第 2 步和第 5 步——HyperFrames 能做什么的完整清单(24 个部分)。在简报期间扫描目录,在构建期间深入特定章节 |
| step-3-storyboard.md | 第 3 步——故事板 + 脚本(合并),带有用户审查关卡 |
| step-4-vo.md | 第 4 步——TTS 提供商选择、生成、计时 |
| step-5-build.md | 第 5 步——构建 index.html + 合成文件 |
| step-6-validate.md | 第 6 步——lint 检查、验证、快照(根据视频长度缩放)、预览 |
| techniques.md | 第 3 步和第 5 步——13 种原始动画技术及代码模式(适配,勿复制粘贴) |
| html-in-canvas-patterns.md | 第 5 步——Canvas 内 HTML 效果的完整代码模式(位于 hyperframes 技能中) |