插件安装： 在执行 setup 或 freshness 命令之前，当此技能位于 HyperFrames 插件内部时，请遵循插件执行规则。独立安装请保留下面的更新说明。
HyperFrames 入口点
HyperFrames 通过 HTML 渲染视频 —— 一个合成就是一个 HTML 文件，其 DOM 通过 data-* 属性声明时序，其动画运行时是可寻位的（seekable），其媒体播放由框架控制。完整的创作合约位于 /hyperframes-core 目录中；在编写合成 HTML 之前请先阅读它。简介、故事板、审查、制作、分发和帧工作者的合约位于此技能的 references/ 目录中。
1. 从项目状态开始
应用第一个匹配的行；不评估较低的状态行：
| 状态 | 操作 |
|---|---|
| 明确将现有的 Remotion 源码移植到 HyperFrames | 阅读 references/routes/remotion-to-hyperframes.md，然后直接路由到该工作流程。跳过意图层。 |
| 对现有 HyperFrames 项目执行特定操作：检查、诊断、验证、预览、渲染、发布或批量渲染 | 仅执行该操作。跳过意图和工作流程路由；加载 /hyperframes-cli 和任何必需的领域技能。 |
| 在现有项目中提出一个问题、一个暂停、一个没有具体变更的想法，或对已构建影片的感性笔记 | 遵循 /hyperframes-studio 第 0 节。 |
| 在现有项目中请求制作一部新影片 | 遵循 /hyperframes-studio 第 5 节。 |
| 对现有项目进行特定编辑 | 进行编辑。不要运行意图层。要知道项目时间线上有什么（轨道、剪辑、开始、结束、播放什么内容），请运行 npx hyperframes timeline [--json]，而不是读取 index.html 和每个子合成文件。 |
BRIEF.md 文件存在 | 读取 workflow 和 flow。执行该工作流程；flow: companion 始终在 /general-video 中执行。不询问任何简介问题。 |
没有简介，但存在 hyperframes.json 或 STORYBOARD.md 文件 | 从项目文件和记录的偏好中恢复。根据现有工件推断所属工作流程。如果无法唯一确定，则只问一个路由问题；不要运行意图面试。 |
| 全新创建 | 运行意图层 —— references/intent-interview.md —— 然后使用第 2 节的表格路由一次。 |
当您编辑现有项目时，请将您的编辑操作括在项目历史记录（/hyperframes-cli，项目历史记录）中。
如果新的请求未明确主体或输入，请在路由之前询问视频内容。在询问任何问题之前，请先检查偏好和配方（references/intent-interview.md，步骤 1）。figma.com 输入或命名的配方会改变接收方式，但不会改变路由 —— 面试的“适配正交输入”部分处理这两种情况。
保持项目的 CLI 更新
脚手架项目会在其 package.json 脚本中固定 hyperframes@<版本号>，以使渲染保持可重现性；固定版本不会自动更新，而使用旧版 CLI 的固定版本运行不会打印任何警告。当恢复其脚本带有固定版本的项目时，请在第一个影响渲染的命令之前执行一次探测：
npx hyperframes@latest upgrade --project . --check
该探测是只读的，它会报告固定版本与最新版本之间的差异；请保留明确的 . 符号 —— 在旧版 CLI 版本中，裸露的 --project 后跟另一个标志会将那个标志当作目录值。当它报告项目版本落后时 —— 或者任何 CLI 输出已经显示了这一点（stderr 通知 This project pins hyperframes@… (latest …)，或者在来自固定版本脚本的 --json 结果中显示 _meta.updateAvailable: true ）—— 请使用 npx hyperframes@latest upgrade --project . 应用更新，然后使用 npx hyperframes check 进行验证。如果验证通过，则确认项目的合成在新版本上仍然有效 —— 而不是渲染输出与旧固定版本的帧一致 —— 因此成功更新绝不是静默的：请在运行的摘要中注明新旧版本号。没有合成的项目不需要验证。如果检查失败，请还原 package.json 的更改，继续使用固定版本，并报告项目停留在哪个版本及其原因。根据信号采取行动而不是将其转达给用户；永远不要留下未验证的新固定版本。
2. 路由新创建
使用第一个匹配的行。匹配的是请求的交付物，而不是顺便提一下的单词或文件类型。
| 优先级 | 请求 | 工作流程 |
|---|---|---|
| 1 | 明确移植现有的 Remotion 源码 | /remotion-to-hyperframes |
| 2 | 编写演示文稿、宣传幻灯片或可导航的交互式演示文稿 | /slideshow |
| 3 | 为现有的谈话头部素材添加纯字幕或翻译，而不改变素材本身 | /embedded-captions |
| 4 | 为现有的谈话头部、采访或播客素材添加设计好的图形覆盖层，而不改变素材本身 | /talking-head-recut |
| 5 | 根据音轨构建一个节奏同步的视频，无需旁白或网站抓取 | /music-to-video |
| 6 | 创建明确的短小、无旁白、以运动为主的片段，通常低于 10 秒 | /motion-graphics |
| 7 | 根据 PR 引用解释 GitHub 拉取请求或代码变更 | /pr-to-video |
| 8 | 根据 URL 或特定网站的简介，营销或展示一个网站、产品站点、应用或公司 | /product-launch-video |
| 9 | 使用创造的视觉效果解释一个主题、文章或笔记，无需产品或网站抓取 | /faceless-explainer |
| 10 | 任何其他自定义视频或合成 | /general-video |
在最终确定路由之前，请阅读 references/routes/<工作流程.md> —— 每个路由一个文件：包含规范的输入/输出/触发合约（在延迟安装的工作流技能可用之前）以及该路由的面试入口。如果候选路由不满足其合约，请继续路由，而不是强制匹配。只读取匹配的路由文件。
解决常见的歧义
- 短动画标题、标志动画、统计数据冲击、图表冲击、地图冲击或独立的下三分之一片段，如果是无旁白且运动本身是信息的重点，则为
/motion-graphics。静态标题卡、有旁白的序列、较长的蒙太奇或自定义循环为/general-video。 - 明确较短的运动图形可以使用 URL、推文、文章或截图作为源材料。通用的“从这个网站制作一个视频”的请求为
/product-launch-video。 - 带字幕的现有素材路由到
/embedded-captions；带有设计的信息卡的素材路由到/talking-head-recut。对素材进行重新计时、重新排序、重新着色、重新构图或重混属于自定义编辑，并落入/general-video。 - 只有当节拍网格驱动整个作品时，音乐文件才选择
/music-to-video。作为背景音乐使用的音乐不会覆盖主题匹配的路由。 - “我想要一个故事板”会改变审查过程，而不是工作流程。如果没有其他路由信号，请使用
/general-video。确认的草图形式的storyboard.html本身可能就是所需的交付物；审查循环定义了那个停止点。 - 专门的叙事工作流程支持大约最多 3 分钟，并且在 30-90 秒左右时效果最佳。明显更长的片段会路由到
/general-video。长度永远不会覆盖明确的移植、演示文稿、字幕、覆盖层或音乐驱动的交付物。
3. 路由一次，然后离开
对于新创建，意图层（references/intent-interview.md）执行完整的对话 —— 记忆、分类、推介环节、必备条件、运行形态、交接 —— 并以编写 BRIEF.md 文件结束。简介是工作流程读取的唯一路由工件；之后不会再重新打开此技能或面试。所有后来的“路由要求什么？”的问题都从 BRIEF.md 文件中回答。
4. 安装并进入工作流程
在阅读所选工作流程之前，请安装或更新它以及核心领域技能：
npx hyperframes skills update <工作流程名称>
使用不带 / 的裸名称。如果命令失败，则显示错误；不要从记忆中重建工作流程。关于安装的所有其他事项 —— 核心与延迟加载的拆分、init 刷新什么、诊断、CI 退出选项以及无 CLI 的回退机制 —— 都在 references/skill-lifecycle.md 中。
5. 按需加载领域技能
| 需求 | 技能 |
|---|---|
| 合成结构、时序属性、轨道、变量、确定性 | /hyperframes-core |
| 运动规则、场景蓝图、过渡、运行时适配器 | /hyperframes-animation |
安全可寻位的 GSAP、CSS、Anime.js、WAAPI、FLIP、路径、遮罩、SVG、3D 关键帧或 hyperframes keyframes 诊断 | /hyperframes-keyframes |
| 设计规范、概念、调色板、排版、旁白、节拍规划 | /hyperframes-creative |
| 图像、图标、徽标、音频、字幕、分级、LUT、可重用媒体 | /media-use |
| 配音剪辑、音频效果链、自动化包络线，或跨多个轨道的单一链/推子（子混音总线） | /hyperframes-audio |
| 初始化、lint、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断 | /hyperframes-cli |
| 注册表块和组件 | /hyperframes-registry |
| 命名的外观、效果、处理或过渡 —— CRT 扫描线、故障、胶片颗粒、闪光扫掠、五彩纸屑爆发 —— 在手动构建之前 | /hyperframes-registry |
| Figma 资源、令牌、组件或作为重建运动的故事板帧 | /figma |
创作者编辑短语是跨领域的请求。加载匹配行中命名的每个技能：
| 创作者请求 | 所需领域 |
|---|---|
| “剪辑这段素材”、硬切、修剪、拼接、重新排序或使用源范围 |