1实现原理 · 为什么它能做到
定位是「兜底工作流」：只有当没有专门 workflow 匹配、或 BRIEF.md 写明 flow: companion 时才用；新创作一律先过 /hyperframes 意图层做路由。
skills/general-video/SKILL.md
Route fresh creation through hyperframes before using this skill.
注：这里在做什么：本 skill 是 HyperFrames 路由器（/hyperframes）之下的一张牌，自己不承担「选哪个 workflow」的决策。刻意收窄触发面，避免模型见到「做个视频」就直奔兜底流程。
开工先做状态机判定：按「具体编辑 / 有 BRIEF / 有 hyperframes.json 或 STORYBOARD / 全新」四行优先级取第一条命中，且不再往下评估。
skills/general-video/SKILL.md
Apply the first matching row; do not evaluate lower state rows:
注：这里在做什么：把「续做」与「重做」的歧义消掉——具体编辑不做发现访谈；已有 BRIEF 不再追问；只有真·从零才回意图层。表格里每行都给了动作与禁止项（'Do not reopen discovery.'、'Ask no brief questions.'）。
跨切面能力（媒体、Figma）不自己实现，全部通过 adapter 转发给兄弟 skill：任何音频/图像/图标/logo/配音/调色/LUT/特效/字幕先读 /media-use 的 resolve + setup-providers。
skills/general-video/SKILL.md
**Media:** For any audio, image, icon, logo, voice, grade, LUT, treatment/effect, caption, or media-operation need, load `/media-use` and follow `../media-use/references/resolve.md` (resolve, adopt, reuse) and `../media-use/references/setup-providers.md` (providers, auth).
注：这里在做什么：素材采购/授权/品牌资产这类问题有唯一归属（/media-use），本 skill 只负责「什么时候去调」。Figma 输入同理强制走 /figma，理由写在正文：跳过 SVG 消毒、媒体溯源、品牌 token 绑定。
运行形态由 BRIEF.md 的 flow/storyboard 两个字段派生（automation/companion × yes/no），并明令不许自造同义词。
skills/general-video/SKILL.md
Do not invent synonyms for these states. An ongoing “just build it” signal is handled by the intent layer and arrives as `flow: automation`, `storyboard: no`.
注：这里在做什么：gate 行为（要不要开看板、要不要停下来问）由 mode 决定，mode 由 brief 派生而不是由模型当场发挥——这是整个 HyperFrames 家族「受控自动化」的核心机制。
合成契约是硬约束（class="clip" + 单条 paused seek-safe 时间线 + 渲染期确定性），与 keyframes 家族共享同一套确定性纪律。
skills/general-video/SKILL.md
Timed elements use `class="clip"`; the root and relevant ancestors are sized; each composition registers one paused, seek-safe timeline on `window.__timelines`; rendering is deterministic. Do not use render-time network fetches, clocks, or unseeded randomness.
注：这里在做什么：渲染器按帧 seek，因此禁止渲染期网络请求（会因网络时序产生不确定输出）、时钟与未播种随机。这条契约同时是 8 个 workflow skill 的公共约束。
唯一自带脚本是 packet builder 的薄壳：只钉住本 workflow 的路径与一处行为差异（设计真值解析顺序 frame.md → design.md → DESIGN.md），其余逻辑全部复用 hyperframes-core 的共享实现。
skills/general-video/scripts/frame-packets.mjs
// Thin wrapper over the shared packet builder in hyperframes-core — this file pins // this workflow's paths plus its one behavioral difference: design truth resolves // frame.md → design.md → DESIGN.md (general-video § 6 order). Everything else has // one owner: ../../hyperframes-core/scripts/lib/frame-packets-core.mjs
注：这里在做什么：显式的「单一所有权」约定——共享构建逻辑不许在 workflow 内分叉。实际写盘（mkdirSync + writeFileSync 每帧 packet 与 _role.md）发生在 core 实现里，由它按 outDir 生成 `.hyperframes/frame-packets/`。
子代理派发有经济学门槛与量化依据：小片内联更快，只有规模大才 fan out，并且一次派发全部 worker。
skills/general-video/SKILL.md
**Dispatch pays for itself only at scale.** Authoring packets and warming fresh worker contexts costs real minutes and tokens: a film of up to ~6 short scenes builds FASTER inline, in this context, one scene after another (measured: 5 short scenes ≈ 9 min inline vs ≈ 21 min packetized).
注：这里在做什么：把「并行一定更快」的直觉用实测数字推翻（组包与预热上下文有固定成本），并要求给每个 worker 2–3 个场景、单波派发（第二波几乎翻倍窗口）。这是本 skill 相对通用「一帧一 agent」设计的差异点。
2核心能力
01无专门流程时的自由创作与编辑（多场景片、品牌片、蒙太奇、静态循环、标题卡、素材混剪）
02companion（陪跑）模式：以「导演而非承建商」的姿态给出上限方案，再让用户删减
03时间线级剪辑指导（硬切/trim/拼接/重排）——同一素材多实例 + data-media-start/data-start/data-duration
04帧包构建器：为被派发的 worker 生成有界 packet（场景块 + blueprint 正文 + 引用规则）与完整角色文件 _role.md
05frame-worker 输出的次产物契约：HTML 之外还必须交 motion.json（时长 + 进出场向量），供上层缝合场景接缝
06自刷新与借用纪律：先 `skills update` 再依赖；借用其它 workflow 时只借故事形状与品味，不借其私有脚本与目录契约
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | hyperframes CLI（init / check / lint / snapshot / preview / render / skills update） |
| cli | hyperframes skills update（自刷新，需网络拉取最新 skill 集） |
| cli | media-use 的 prefs.mjs / recipe.mjs（偏好记录与配方应用，本地写盘） |
| package | hyperframes-core 共享库（frame-packets-core.mjs，本 skill 脚本的唯一实现来源） |
| package | 兄弟 skill 依赖（/hyperframes 路由、/hyperframes-core、/hyperframes-creative、/hyperframes-animation、/hyperframes-keyframes、/media-use、/figma） |
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 门槛高：真正跑起来依赖整套 HyperFrames 生态 — 需要已安装并可执行的 hyperframes CLI、/media-use（含 prefs.mjs/recipe.mjs）、以及 hyperframes-core/animation/creative 等兄弟 skill 目录同时存在；缺任一项，SKILL.md 的必读表与命令都会失效。本 skill 不提供降级路径。
- 子代理派发把宿主权限引入构建链 — 流程要求把 _role.md 与 packet 全文交给 worker（或给路径让它先读），worker 具备宿主工具权限；packet 内容来自 BRIEF/STORYBOARD/素材描述，属于可由用户输入影响的自然语言。宿主需自行约束 worker 的工具范围与写盘范围。
- 自刷新即网络行为，且失败处理依赖模型自觉 — 正文要求先 `npx hyperframes skills update general-video`，并在失败时『显式上报而不是凭记忆继续』——这属于纪律性要求，模型跳过或静默降级时无技术拦截。
- 『借兄弟 workflow 的品味』可能引入隐性不一致 — SKILL.md 允许借用其它 workflow 的类型参考作为示例（先跑该 workflow 的 skills update），只禁止借私有脚本/流水线状态/目录契约；边界靠文字约定，若模型借多了不易自动检出。
- 成本对照是历史测量值 — 『5 场景 9 分钟 vs 21 分钟』是文中记录的实测，随模型/宿主变化会漂移；照搬阈值而非重测可能导致派发决策次优。
风险提醒：蓝色，知晓即可。行为面为：本地 Node 脚本 + 外部 hyperframes CLI，只做本地读写（生成 packet、偏好记录、项目文件），无凭证读取（无 .env / API key / keychain / token 访问），无数据外发（脚本内零 fetch/网络 API）。唯一网络行为是流程要求的 `npx hyperframes skills update` 与后续 render/capture 类 CLI（在其它 skill 中触发），外发对象为官方 CLI 自身。注意点：派发子代理时要求把完整角色文件与 packet 交给 worker，等于把宿主子代理权限引入构建流程——读取范围与写盘范围由宿主约束。
5第二遍独立确认
- [ok] 唯一脚本是否真的『薄』（有无隐藏功能/网络） — frame-packets.mjs 全文 37 行，仅 import existsSync/path/url 与 core；导出两个函数并透传 CONFIG；无 fs 写操作、无 fetch、无 env 读取。写盘与模板拼装在 core 中，符合注释自述。
- [ok] 网络 / 凭证 / 注入面 — skill 内 0 处 URL、0 处 fetch、0 处 process.env、0 处凭证关键词；grep 'heygen' 命中的两行是 Figma 段把 figma.com 当输入 URL 的说明与派发成本段，不是 API 调用。第二遍未发现漏掉的网络或凭证路径。
- [ok] 『外部资源』条目逐条回查调用点 — npx hyperframes init/lint/check/snapshot/preview/render/skills update 均在 SKILL.md 正文出现；prefs.mjs/recipe.mjs 路径在 §2 明确定义 <MEDIA_DIR> 为已安装的 /media-use skill 目录；frame-packets-core.mjs import 在脚本原文可验。
- [ok] frame-worker 输出契约与编排者所有权是否自相矛盾 — frame-worker.md 要求 worker 写两个文件（html + motion.json）并禁止写 <audio>、禁止碰邻居场景文件；SKILL.md §5 第 5 步要求编排者收集 motion.json 并在装配时把时长/进出场向量带入缝合。两侧互补、无冲突。
- [ok] 组内一致性（packet 构建路径与自刷新提示） — 与 product-launch-video / faceless-explainer 对比：三者都调 `node <SKILL_DIR>/scripts/frame-packets.mjs`，但 general-video 的 worker 拿到的是『2–3 场景』而另两者是『一帧一 worker』——这是有意的差异（本 skill 面向长片），已在 traits 注明而非记为出入。
6结论
适合：适合已经有 HyperFrames 环境、要产出「没有专门模板」的长片或多场景作品的人：品牌/sizzle 片、蒙太奇、素材混剪、静态循环与标题卡、自由构建；也适合明确选择 companion（陪跑共创）模式的用户——该模式下本 skill 会先给出完整上限方案（故事弧、设计规格、逐场运动、转场、音频身份、开合场设计）再由用户删减。
不适合：不适合：① 有专门 workflow 匹配的任务——门面产品推广走 /product-launch-video、纯文本解说走 /faceless-explainer、短无旁白动效走 /motion-graphics（description 直接点名）；② 新创作直接从本 skill 起手（应先过 /hyperframes 意图层）；③ 没有 hyperframes CLI 与 /media-use 等兄弟 skill 的环境；④ 期望零交互直接出片的用户——即便 automation 模式，仍有 check/preview 门禁与渲染审批；⑤ 需要素材采购/配音/调色本身能力的场景——那些归 /media-use。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 general-video.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent4d140e0c0bd3b0ae…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库heygen-com / heygen-com/hyperframes
原始 GitHubheygen-com/hyperframes ↗
Stars44283
最近推送2026-09-06
本 skill commit
b8328f9573许可Apache-2.0（仓库根 LICENSE 为 Apache License Version 2.0；池内值亦为 Apache-2.0）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。