用途
HyperFrames 通用视频技能（general-video）用于在没有专门工作流适配的情况下，编写或编辑自定义 HyperFrames 合成；也用于 BRIEF.md 中 flow 设为 companion 的场景。适用于较长或多场景的视频作品。
主要能力
- 跨领域源适配：处理媒体（音频、图像、图标、logo、配音、调色、LUT、特效、字幕、媒体操作）时加载 /media-use，并按 resolve.md（解析、采用、复用）与 setup-providers.md（提供方、认证）执行；涉及 figma.com URL 时先运行 /figma，基于其导出的资产、token、组件或分镜帧构建。
- 项目状态识别：区分具体编辑、已有 BRIEF.md、无 brief 但有 hyperframes.json 或 STORYBOARD.md、全新创建四种状态并采取对应动作。
- 运行形态解释：使用 brief-contract.md 中的规范术语 flow（automation / companion）、storyboard（yes / no）与派生模式。
- 分阶段执行：计划、依赖解析、场景构建、运动侧车合并、组装、验证、最终审批。
- 多场景调度：通过 frame-packets.mjs 生成每场景的受限数据包与 _role.md，按 2–3 个场景一组、单波次派发 worker；约 6 个短场景以内建议内联构建更快。
- 校验与渲染：使用 npx hyperframes lint 快速反馈，npx hyperframes check 作为最终门禁（内部会重跑 lint）。
使用方式
- 更新技能：
npx hyperframes skills update general-video
无操作成功表示技能为最新；更新失败应上报而非凭记忆继续。
- 全新项目脚手架：
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
随后在项目根目录按 brief-format.md 编写 BRIEF.md。已有项目中，根目录为包含 hyperframes.json 的目录。记录偏好使用：
node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>
若意图层采用了 recipe：
node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>
- 计划前检索实时目录（无需安装任何内容）：
npx hyperframes catalog --query "<the look, in plain English>" --json
- 多场景派发时生成数据包：
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"
- 音乐床在配音下播放时，验证前先 carve：
/hyperframes-audio → scripts/carve.mjs --comp index.html
- 验证：先 npx hyperframes lint，最终门禁运行 npx hyperframes check。
适用场景
- 没有专门工作流匹配的自定义 HyperFrames 合成创作或编辑。
- BRIEF.md 中 flow: companion 的协作式共创。
- 较长或多场景视频片段。
- 对已有素材进行硬切、裁剪、拼接或重排（将同一视频源复制到多个 clip 元素，用 data-media-start 加 data-duration 设置源范围，用 data-start 设置编排位置/顺序；音频在匹配的 <audio> 元素上遵循相同片段范围与时间）。
限制与约束
- 不得用 CSS/SVG/opacity 即兴实现受支持的媒体效果。
- 不得使用原始 Figma 连接器调用，因其跳过 SVG 净化、媒体溯源与品牌 token 绑定。
- 不得为 flow、storyboard 等状态发明同义词。
- 计划中引用的运动名称必须来自 blueprints-index.md 或 rules-index.md，不得自创。
- 仅在检索无匹配结果后才手写某种外观。
- 保持范围精确：只构建用户要求的内容，添加前先提议。
- 写合成 HTML 前必须先确立设计（frame.md → design.md → DESIGN.md，取首个找到的为品牌真相）；无设计规范时需完成四项：以 house-style.md 与 video-composition.md 奠定视觉识别、用一句话命名概念角度、从 typography.md 选择可嵌入字体配对、定义焦点元素/边缘锚点/支撑细节/背景处理。
- 合成契约：定时元素使用 class="clip"；根与相关祖先需设定尺寸；每个合成在 window.__timelines 上注册一个暂停、可安全 seek 的时间线；渲染需确定性，不得使用渲染时网络请求、时钟或未播种随机。
- 借用其他工作流时先运行 npx hyperframes skills update <workflow-name>，只借其故事形态与品味，不借其私有脚本、流水线状态或目录契约。
完成条件
请求范围已实现；flow: companion 时交付完整处理方案（每个场景引用的蓝图或规则已实现、音频身份存在或明确选择静音、开场与结尾经过设计）；npx hyperframes check 通过（含内置 lint 阶段）；存在设计规范时按 design-adherence.md 审查设计一致性；对比度问题已解决；适用时检查子合成快照；自主交接包含已检查的 contact 或 snap。