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外部依赖

Kind	Dependency / Endpoint
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管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: node scripts/frame-packets.mjs --project … --storyboard …（本地 Node 脚本；经 hype
网络端点: 声明外部网络访问: npx hyperframes skills update general-video（命令语义即从远端拉取 skill 集；本 skill 自己的脚
本地工作目录: 文件读写与工件输出: .hyperframes/frame-packets/*（每场景 packet）与 _role.md（由 hyperframes-core 的 fra

审计说明： 。行为面为：本地 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 意图层，本 skill 只在无专门流程或 companion 时接手

状态机式续做判定，避免对半成品项目重复盘问，也避免对具体编辑重开发现流程

架构上坚持单一所有权：唯一脚本是薄壳，共享逻辑只在 hyperframes-core，杜绝 workflow 内分叉实现

派发经济学有实测依据，并给出反直觉结论（短片内联更快、单波派发、每 worker 2–3 场景）

companion 模式有明确质量立场：给上限方案让用户删减，而不是逐项挤牙膏式审批

适合： 适合已经有 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。

Install Agent-Ready

① Verified Mirror 2026-09-15

Option A · Direct DownloadDownload general-video.tar.gz

sha256: 4d140e0c0bd3b0ae…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit b8328f9573.