general-video

用途

general-video 是 HyperFrames 体系中的通用视频创作技能，用于在没有更专门的制作流程可用时，自主编写或编辑一套自定义 HyperFrames 视频合成；如果 BRIEF.md 将 flow 设为 companion，也由它来处理。它适合较长的作品或多场景拼接的视频。

主要能力

• 项目状态处理：遇到具体编辑时，在原项目上直接修改；存在 BRIEF.md 时读取并按其流程指示处理；只有 hyperframes.json 或 STORYBOARD.md 时，从文件恢复进度；全新项目则先用 npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video 初始化，再写 BRIEF.md。
• 流程形态解释：依据 brief-contract 中的标准字段 flow（automation / companion）与 storyboard（yes / no）决定由谁主导、是否先做分镜规划与评审。
• 分阶段执行：按“规划 → 依赖准备 → 搭建场景 → 合并动效 → 装配 → 校验 → 最终审批”的顺序推进；多场景计划在 STORYBOARD.md 中以每场景一个 ## Frame N 块记录，并引用 blueprint 或规则名称。
• 跨流程适配：媒体需求统一走 /media-use 的解析、采用与提供商规则；Figma 输入须先走 /figma，避免直接调用连接器。
• 目录检索：在计划任何指定外观、效果或转场前，用 npx hyperframes catalog --query "<look>" --json 检索托管目录，找到合适块再安装；没有匹配时才自行实现。
• 校验与审批：先用 npx hyperframes lint 快速反馈，最终用 npx hyperframes check 把关，再打开 Studio 预览，获准后才渲染。

使用方式

1. 前置检查：运行 npx hyperframes usage --json 查看额度与重置时间；再运行 npx hyperframes skills update general-video 确认技能为最新，更新失败需如实告知而非凭记忆继续。
2. 媒体类操作先加载 /media-use 并按 resolve.md 与 setup-providers.md 处理；首次调用需认证的提供商前运行 npx hyperframes auth status 并原样转述结果。
3. 按项目状态执行对应动作，新项目脚手架完成后按 brief-format.md 写 BRIEF.md，并用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT> 记录已确认偏好。
4. 在匹配条件出现时，先加载对应参考文档（core、creative、animation、storyboard、media、production-loop 等）再动手。
5. 多场景超过约 6 个短场景或单个场景较重时，可用 node <SKILL_DIR>/scripts/frame-packets.mjs 生成场景包并分派 worker，每 worker 2–3 个场景，单波并行；无分派通道时串行处理。

适用场景

较长、多场景、需要自定义视觉与动效的视频制作；brief 指定 flow: companion 的协作式共创；需要组合媒体素材、配音、字幕、转场的成片；以及需要保留既有项目决策的增量修改。

限制与约定

• 必须保持范围精确，用户只要标题卡就不额外加场景、音乐或字幕；新增内容须先提议。
• 写合成 HTML 前必须先确定设计来源（frame.md → design.md → DESIGN.md）。
• 合成需遵守确定性规则：定时元素用 class="clip"，在 window.__timelines 上注册暂停且可 seek 的时间线，禁止渲染时网络请求、时钟或未播种随机。
• 不要用 CSS/SVG/透明度自行模拟受支持的媒体效果。
• 具体的收费、价格与平台支持信息暂未提供。