媒体使用:在获取音频/图片之前,请调用
/media-use以从 HeyGen 目录中获取 BGM/SFX/图片。先运行--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 步)——每拍的结构化证据块
- 完工定义(DoD)清单(第 6 步)——包括动画映射、每警告的 WCAG 验证、音频/动作回放
- 诚实披露部分(第 6 步)——“我没有验证的内容”必须出现在你的最终摘要中
如果你发现自己这样推理:“自动模式说偏向于行动,所以我会跳过 X”——而 X 是一个验证门,而不是一个偏好问题——这个推理是错误的。偏向于行动适用于决定要构建什么,而不是决定是否要验证。
第 0 步:捕获并理解品牌
阅读: references/step-0-capture.md
捕获网站,然后阅读提取的数据以理解品牌和产品——它是做什么的,目标用户是谁,说话的语气如何,处于怎样的情感基调。捕获的素材是供以后使用的品牌工具包,而不是视频的构建块。
在简报前显示登录状态——运行 npx hyperframes auth status 并逐字输出其结果(不要转述或重写它)。 它会报告配音/BGM 将使用 HeyGen 还是本地引擎,以及当未登录时,如何登录。如果未登录,请停止并等待用户选择——登录,或者说“继续”/“离线”以使用本地引擎继续——然后再询问简报或其他任何事情。 将其视为一个真实的决策点,而不是一个附注;不要将此选择合并到简报问题中,也不要将密钥写入每个仓库的 .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。
门控项: 主控代理已根据 DESIGN.md 和 STORYBOARD.md 从头到尾阅读了每个 compositions/beat-N.html。逐拍检查清单位于 step-5-build.md。
第 6 步:验证与交付
阅读: references/step-6-validate.md
运行 lint、验证、拍摄按视频长度缩放数量的截图(公式:max(beats × 3, ceil(duration_seconds / 2))),并审查每一张截图。在交付前修复问题。交付 localhost Studio 项目 URL——仅在用户明确要求时才渲染为 MP4。仅在交接时提供该 Studio URL——它是最终、稳定的预览;构建阶段的截图是无头的,所以不要在构建过程中弹出预览。
交付一个你引以为豪的作品。 在交接前,问自己:我会把这个发到社交媒体上并署上自己的名字吗?如果不会,就修复问题。
门控项: npx hyperframes lint 和 npx hyperframes validate 通过,零错误,并且最终响应中包含活跃的 Studio 项目 URL。
快速参考
视频类型
按视频类型划分的典型约束——用作起点,而非公式。节拍数量应来自内容和旁白,而不是来自目标范围。
| 类型 | 典型时长 | 时长驱动因素 | 旁白 |
|---|---|---|---|
| 社交广告 (IG/TikTok) | 10–15s | 平台限制 | 可选 |
| 产品演示 | 30–60s | 脚本长度 | 完整旁白 |
| 功能公告 | 15–30s | 功能复杂度 | 完整旁白 |
| 品牌混剪 | 20–45s | 音乐曲目 | 可选,注重音乐 |
| 发布预告 | 10–20s | 引子能量 | 最少 |
节拍数故意不在此表中——它应来自故事板,而不是来自“社交广告 = 3-4 拍”。复杂产品的社交广告可能需要 5 个节奏良好的节拍。一个只有一个强视觉主题的品牌混剪可能只需 3 拍。
格式
- 横屏:1920x1080(默认)
- 竖屏:1080x1920(Instagram Stories、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 步——用于 HTML-in-Canvas 效果的完整代码模式(位于 hyperframes 技能中) |