首先，保持该技能最新——静默运行，无需询问： npx hyperframes skills update website-to-video。当所有内容均已为最新时，此命令为快速空操作；否则，它将在你依赖该技能前，刷新本技能及其所依赖的核心领域技能。

media-use：在引入音频/图片/Logo 前，请先调用 /media-use，以从 HeyGen 目录中解析背景音乐（BGM）/音效（SFX）/图片，并从其官方来源获取品牌 Logo。首次运行前请先执行 --adopt 以注册现有资源。详见 /media-use 技能文档。

figma source：若输入 URL 为 figma.com 链接（而非线上产品站点），请先运行 /figma —— 执行资源导出、品牌标记（brand tokens）提取，并在必要时重建组件或分镜脚本（storyboard reconstruction）—— 然后基于其输出构建本工作流。请勿直接通过原始 MCP 工具驱动 Figma：这将跳过 SVG 清洗、.media/manifest.jsonl 来源追溯，以及品牌标记的 var() 绑定机制，导致后续品牌变更无法自动传播，必须重新完整导入。

网站转 HyperFrames

抓取一个网站，然后据此生成专业视频。

在第 0 步开始前，请确认路由路径是否正确。 本技能用于制作一段关于/源自通用网站的视频。若用户实际意图是营销 / 上线 / 推广某款产品（即使 URL 指向该产品页，或表述为“为我们网站做推广”）→ 请使用 /product-launch-video。若为无出镜讲解型主题说明视频（faceless explainer）且不涉及网站 → /faceless-explainer；若面向GitHub PR → /pr-to-video；若需对已有视频文件进行剪辑重排 / 调色 / 顺序调整 → 不在本技能覆盖范围内。仅当用户模糊表达为“制作一段视频”，或对“上线推广”与“通用网站展示”难以区分时，才路由至此。此时请先阅读 /hyperframes（含完整路由表 + § HyperFrames 无法实现的功能）。

用户常会这样说：

• “把该网站转成一段 15 秒 Instagram 社交短视频”
• “基于 https://... 制作一段 30 秒的网站导览 / 展示视频”
• “抓取我们首页，并完全基于其自身视觉元素构建视频”

本工作流共含 7 个步骤。每步产出一项成果物，作为下一步的准入门控（gate）。默认为协作模式 —— 标有 💬 的门控将暂停并主动向用户提问。模式语义（信号机制、传播规则、门控分类）在 ../hyperframes-core/references/brief-contract.md 中定义为规范；当用户明确启用自主模式（如说“替我决定”、“给我惊喜”），则标有 💬 的用户偏好类门控将被跳过 —— 具体传播逻辑见 step-2-brief.md。

自主模式 ≠ “跳过所有门控”（简报合约 §1）。它仅覆盖用户偏好类问题（如 TTS 提供商、语音选择、色彩强调、节拍数、是否启用音乐、是否启用字幕等，由智能体代用户决策）。它不覆盖质量验证类门控。以下门控在自主模式下仍为强制不可跳过：

• 资源审计（Step 3）—— 查看联系表（contact sheets），并对每一项资源明确说明 USE/SKIP 理据
• 逐节拍 HTML 审阅（Step 5）—— 每一节拍均需提供结构化证据块
• 完成定义（DoD）检查清单（Step 6）—— 包括动画映射图（animation-map）、逐警告项 WCAG 合规性验证、音画同步播放测试
• 诚实披露章节（Step 6）—— 最终总结中必须包含“我未验证的内容”（What I did NOT verify）

若你发现自己在推理：“自主模式倾向快速行动，因此我跳过 X”——而 X 实为一项验证门控（非偏好类问题），则该推理错误。“倾向快速行动”适用于决定构建什么，而非决定是否验证。

第 0 步：抓取与理解品牌

阅读： references/step-0-capture.md

抓取网站，然后研读提取的数据，以理解品牌与产品——其功能定位、目标用户、语言风格、情绪基调。所抓取的资源构成后续可用的品牌工具包（brand toolkit），但并非视频本身的直接构建模块。

在简报前展示登录状态 —— 运行 npx hyperframes auth status 并原样转述其输出（不得意译、改写或摘要）。 该命令报告语音/BGM 将使用 HeyGen 引擎还是本地引擎；若未登录，则提示登录方式。若未登录，请立即暂停，等待用户做出明确选择 —— 登录，或声明“继续”/“离线”以启用本地引擎 —— 在此之前，不得发起简报或其他任何提问。 请将其视为真实决策节点，而非附带备注；不得将该选择揉入简报提问中，亦不得将密钥写入仓库级 .env 文件。（在自主模式下，记录状态并默认以离线方式继续。）详见 ../media-use → Preflight 获取标准指引。

门控： 已打印网站摘要 —— 采用策略优先顺序（先说明产品功能、目标用户、品牌语调），再列出资源 / 色彩 / 字体清单；且已展示登录状态（已登录，或确认离线继续）。

第 1 步：品牌识别体系

阅读： references/step-1-design.md

撰写 DESIGN.md —— 一份品牌速查手册，涵盖视觉识别体系：色彩、字体排印、组件样式、布局原则。精确数值请参考 design-styles.json。

提速选项： 对于快节奏视频（每节拍呈现一块广告牌式信息），DESIGN.md 可精简为一份约 50 行的摘要，仅涵盖主色系、字体选择及核心设计准则（do’s/don’ts）——无需长达 300 行的详尽文档。Step 5 的子智能体提示词将直接粘贴品牌值，因此 DESIGN.md 的深度仅在处理复杂构图时才具实质影响。

门控： DESIGN.md 文件存在（长度不限），且至少包含：色彩方案、字体选择、设计准则（do’s/don’ts）。

第 2 步：策略与信息传达

阅读： references/step-2-brief.md、references/capabilities.md（通读目录即可，仅按需深入查阅具体章节）

在讨论视觉设计或资源前，须先与用户对齐视频必须传达的核心信息。解析用户原始提示——他们很可能已明确告知视频类型与风格。仅就缺失项提问：本视频必须传递的唯一核心信息、叙事脉络（narrative arc）及目标受众。

门控： 视频类型、时长、格式，以及最关键的信息点与叙事脉络均已锁定。缺少这些要素，第 3 步将无法编写以信息传达为先导的分镜脚本。

第 3 步：分镜脚本 + 叙事文案 💬

阅读： references/step-3-storyboard.md

以信息传达为先导编写分镜脚本：核心信息 → 叙事脉络 → 支撑脉络的节拍 → 每节拍适用的技术手法 → 最终统一应用品牌修饰。随后撰写匹配的旁白文案。向用户提供分镜脚本与文案，并附带逐节拍摘要。持续迭代直至用户批准。

门控： STORYBOARD.md 与 SCRIPT.md 均已存在，且用户已批准该方案。

第 4 步：旁白（VO）、节奏校准 + 字幕 💬

阅读： references/step-4-vo.md

若第 2 步已确认无需旁白——则询问背景音乐偏好，随后直接进入第 5 步。否则：向用户确认 TTS 提供商（HeyGen TTS、ElevenLabs 或 Kokoro），生成音频，转录文本，并将时间戳映射至各节拍。随后询问字幕需求。

门控： 满足以下任一条件：(a) 用户明确无需旁白，且分镜脚本中已手动标注各节拍时长；或 (b) narration.wav 与 transcript.json 已生成，且节拍时长已根据真实音频时长更新。

第 5 步：构建画面构图

阅读： hyperframes 技能（务必加载 —— 每一条规则均至关重要）
阅读： references/step-5-build.md

依据分镜脚本（第 3 步）选定的架构与节奏，构建 index.html 及各画面构图（compositions）。各子智能体须在汇报前，对每个节拍分别执行 hyperframes lint 与 hyperframes snapshot。

门控： 主智能体已逐行审阅全部 compositions/beat-N.html，并与 DESIGN.md 和 STORYBOARD.md 严格比对。逐节拍检查清单详见 step-5-build.md。

第 6 步：验证与交付

阅读： references/step-6-validate.md

执行代码检查（lint）、合规性验证（validate），按视频总时长生成缩略图快照（公式：max(beats × 3, ceil(duration_seconds / 2))），并逐一审查。修复全部问题后方可交付。交付 localhost Studio 项目 URL —— 仅在用户明确要求时才渲染为 MP4。该 Studio URL 仅在最终交接时一次性呈现 —— 它是最终、稳定的预览地址；构建阶段的快照均为无头（headless）模式，切勿在构建中途弹出预览窗口。

交付你引以为豪的作品。 交接前请自问：我是否愿意以本人名义将此视频发布至社交媒体？若答案是否定的，请修正问题所在。

门控： npx hyperframes check 运行通过（零错误），且最终响应中包含当前有效的 Studio 项目 URL。

快速参考

视频类型

各视频类型的典型约束 —— 作为起点参考，而非硬性公式。节拍数应由内容与旁白自然决定，而非套用目标区间。

（若为产品演示、功能公告或上市预告片，且其核心目标是销售产品，则属于 /product-launch-video —— 请参阅顶部路由说明。）

本表有意未列出节拍数 —— 它应源于分镜脚本，而非“社交广告 = 3–4 节拍”之类的经验法则。一款复杂产品的社交广告可能需要 5 个精准卡点的节拍；而一个以单一强视觉主张为核心的品牌短片，3 个节拍即足够。

格式

• 横屏：1920×1080（默认）
• 竖屏：1080×1920（Instagram Stories、TikTok）
• 方屏：1080×1080（Instagram Feed）

参考文件