插件安装： 在执行 setup 或 freshness 命令之前，当此技能位于 HyperFrames 插件内部时，请遵循插件执行规则。独立安装则遵循下面的更新说明。
通用视频 是做什么的？
在开始工作时（除非工作流刚读取过），运行 npx hyperframes usage --json，然后在关键节点（如草稿完成、渲染前）再次检查。读取可用的运行窗口和重置时间。如果用量状态未知，直接说明，不要猜测额度；与用户一起确认范围和 workflow 选择。
在依赖本工作流之前，请运行：
npx hyperframes skills update general-video
如果输出表示无需更新，则说明当前技能是最新的。如果更新失败，请在继续之前展示该失败信息，而不是依赖内存中的版本。
1. 应用跨领域源适配器
- 媒体： 对于音频、图像、图标、标志、配音、色彩校正、LUT、效果/处理、字幕或媒体操作等需求，请加载
/media-use并遵循../media-use/references/resolve.md（解析、采用、复用）和../media-use/references/setup-providers.md（提供商、认证）。对于模糊的素材反馈和命名样式，在编辑之前请使用../media-use/references/media-treatments.md；不要用 CSS/SVG/透明度来即兴创作支持的媒体效果。在执行第一个需要认证的提供商操作之前，请运行npx hyperframes auth status并原样输出其结果。如果显示未登录，请应用../hyperframes/references/brief-contract.md中的门控逻辑：协作模式下等待用户登录或明确选择离线模式；自主模式下则声明状态并继续寻找可用的离线提供商。当没有离线提供商能满足一个必需的能力时，请报告阻碍。仅使用本地资源不需要执行登录门控。 - Figma： 如果输入包含
figma.com链接，请先运行/figma技能。从其导出的资源、设计令牌、组件或故事板页面开始构建。不要直接调用 Figma 的原始连接器，因为它们会绕过 SVG 清理、媒体来源追踪和品牌令牌绑定。
这些适配器不会改变 /hyperframes 所选定的工作流。
2. 从项目状态开始
应用第一个匹配的状态行，不要评估后续状态行：
| 状态 | 操作 |
|---|---|
| 特定编辑 | 执行该编辑，保留现有项目决策，然后重新运行受影响的检查。不要重新开始探索阶段。 |
BRIEF.md 已存在 | 读取它。如果 workflow 字段指定了另一个 workflow 且 flow 不是 companion，则移交。不要询问任何 brief 相关问题。 |
没有 brief，但 hyperframes.json 或 STORYBOARD.md 已存在 | 从文件和已记录的偏好中恢复。仅基于已知事实回填 BRIEF.md。 |
| 全新创作 | 运行 /hyperframes 及其意图层。只有当 workflow: general-video 或 flow: companion 时才回到此处。 |
对于新项目，根据 brief 选择一个 kebab-case 格式的目录名，并在编写 brief 之前创建脚手架：
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
然后使用 ../hyperframes/references/brief-format.md 在项目根目录编写 BRIEF.md。在已有项目中，根目录是包含 hyperframes.json 的目录。仅记录由 brief 格式命名的、已确认的偏好支持字段，使用命令 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>；切勿记录推断出的默认值。其中 <MEDIA_DIR> 是已安装的 /media-use 技能目录，<PROJECT_ROOT> 是包含 hyperframes.json 的目录。如果意图层采纳了一个配方，请立即应用：node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>，且不要再次询问。
3. 解析运行形态
仅使用 ../hyperframes/references/brief-contract.md 中的规范术语：
| 字段 | 含义 | 效果 |
|---|---|---|
flow | 谁驱动 | automation：选择并执行路线。 companion：通过对话协作创作。 |
storyboard | 在构建之前先规划、草图和审查 | yes：执行计划和草图审查（storyboard.html）。 no：直接构建，跳过此步骤。 |
派生 mode | 检查点门控如何运作 | 遵循 brief contract。绝不要求用户指定一个模式名称。 |
不要为这些状态创造同义词。持续的“直接做”信号由意图层处理，表现为 flow: automation、storyboard: no。
- 对于
flow: automation，选择路线并在第一次进度更新中用一行文字说明。 - 对于特定编辑，直接进行编辑，不要创造新的路线。
对于现有素材的硬切、修剪、拼接或重新排序，将同一视频源复制成多个剪辑元素。在每个副本上，使用 data-media-start 加 data-duration 设置源范围，然后用 data-start 设置创作者的放置/顺序。每个视频片段保留其声音：声音保留在剪辑上（data-has-audio="true"），所以剪切视频也会剪切其声音。 /hyperframes-core 负责这种时间线编辑；/hyperframes-keyframes 仅用于视觉属性动画，例如缩放、推拉、平移、裁切、蒙版或内部包装器上的 clip-path。从 ../hyperframes-core/references/creator-editing-recipes.md 复制完整的约定。
协作流程
当 flow: companion 时：
- 读取
BRIEF.md，并将已接受的## Assets和## Customizations与项目制品进行比对。完成仍在等待处理的、已被接受的工作；已完成的工作保持不变；不要将已接受的能力当作新功能再次提供。 - 以导演的身份介入，而不是承包方的身份。 选择协作的用户选择了参与度和质量；诚实的回应是你能够设计出的最佳版本，而不是最省事的版本。第一个计划应该是“天花板级别的处理方案”：故事弧线（借用最近的类型视角 —— 菜单 § 类型视角）、设计规格、每个场景按名称引用的动效处理（§ 5节中的计划规范）、转场、音频标识 —— 音乐和音效标记，或刻意安排的静音 —— 放置用户的素材，以及精心设计的开头和结尾。用一句话说明每一层增加了什么；在命名时指出代价高昂的层（渲染时间、登录、计费）。由用户来削减处理方案；他们绝不应该一个批准一个批准地自己组装一个方案。
- 这个天花板属于概念，而不是工具箱。 每一层都必须服务于 brief 的信息 —— 一个可以不加区分地装饰任何视频的处理方案仅仅是装饰。工艺应追求天花板；内容绝不超出要求（§ 6）。
- 在检查点之间，
../hyperframes/references/capability-menu.md以两种方式工作。作为触发列表：当用户提到某个能力的输入或构建流程到达其需求时，提供相关能力。作为每次迭代的升级通道：一个计划、草图或构建检查点可以携带一两个定向提议，指向用户正在关注的材料（“场景三的静态画面需要计数组件特效”）。在提供之前阅读它；绝不倾泻整个目录。 - 在用户接受一个能力后，立即生成其制品，并将该决策记录在相应的
BRIEF.md主体部分。仅当用户明确更改时，才重写 frontmatter 字段并记录确认后的偏好。 - 保持相同的故事板、验证、最终预览和渲染批准门控。协作模式改变的是谁在掌舵，而不是质量要求什么。
4. 在每个阶段前加载必需知识
当条件匹配时，这些读取是强制性的：
| 条件 | 在采取行动前需读取的内容 |
|---|---|
| 任何 HTML 合成或场景布局 | /hyperframes-core；使用 references/determinism-rules.md 了解其布局约定 |
| 任何非平凡的创建或视觉处理 | /hyperframes-creative → references/house-style.md 和 references/video-composition.md |
| 任何动效、动画或场景转场 | /hyperframes-animation；遵循其路由到对应的规则、适配器、蓝图或转场参考 |
storyboard: yes | ../hyperframes/references/storyboard-format.md 和 ../hyperframes/references/review-loop.md |
| 任何媒体资产或操作，包括旁白、背景音乐、音效、字幕、调色或变换 | /media-use（宿主应用自身的音乐和音效工具优先用于这些方面）；对于框架内的播放和放置，还需阅读 /hyperframes-core → references/variables-and-media.md |
| 多场景组装 | ../hyperframes/references/production-loop.md |
flow: companion，在第一个计划之前 | /hyperframes-creative → references/story-spine.md 和 references/house-style.md；最近的类型视角以及完整的 ../hyperframes/references/capability-menu.md —— 天花板级别的处理方案正是根据这些进行设计的，而非凭记忆调用 |
| 协作者能力提供、捕获、节拍网格、生成式视频、地图、发布或跨工作流能力 | ../hyperframes/references/capability-menu.md |
| 存在设计规格，在最终批准之前 | /hyperframes-creative → references/design-adherence.md |
不要用记忆代替这些读取。渐进式披露仅在匹配的参考文件确实被加载时才节省上下文。
5. 执行作品
使用此依赖顺序。仅当输入缺失时才跳过某个阶段。
- 计划。陈述观众弧线、结构、节奏和持续时间驱动因素。对于短的单场景，使用一个文件；对于三个及以上硬场景切或任何重用的场景，使用子合成。阅读
/hyperframes-creative→references/story-spine.md了解有旁白的弧线，references/beat-direction.md了解节奏，以及/hyperframes-core→references/composition-patterns.md了解结构。对于开放式的多场景 brief，通过/hyperframes-creative→references/prompt-expansion.md扩展提示。一个多场景计划需要引用每个场景的形态：当/hyperframes-animation→blueprints-index.md中有匹配的蓝图 ID 时引用它，若没有则引用它从rules-index.md中组合的命名规则 —— 动效名称必须来自这些索引，绝不能凭空创造。故事的真实性决定了哪些场景存在；引用则为它们配装。在你计划自己动手构建任何命名外观之前，先搜索在线目录：对于 brief 中提到的每一个外观、效果、处理或转场 —— 例如“CRT 扫描线”、“故障特效”、“胶片颗粒”、“闪光扫过”、“五彩纸屑爆炸” —— 运行npx hyperframes catalog --query "<用普通英语描述的外观>" --json并阅读排名靠前的结果，然后再在计划中指定如何构建该外观。此搜索无需安装任何内容：不需要项目、不需要先执行add、不需要账户。它从任何目录中搜索整个托管注册表（约 400 个块和组件），因此也适用于用户在构建过程中要求的外观。计划中提及的块在阶段 3 安装；仅当搜索后没有找到合适的组件时，才手动创作一个外观。一个多场景计划也作为分派制品被记录下来：STORYBOARD.md中每个场景对应一个## Frame N块 —— 包含status: outline、声明的src:、蓝图/规则引用、