全部技能 / 文档与知识 / hyperframes
文档与知识 · heygen-com/hyperframes

hyperframes

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

风险提醒：蓝色 · 知晓即可AI 侦查报告
作者 heygen-comGitHub heygen-com/hyperframes ↗Stars 48297许可 Apache-2.0（仓库根 LICENSE；GitHub API spdx Apache-2.0）commit b8328f9573
agent 宿主通常会约束 skill 执行权限；风险提醒为 AI 侦查观点，不构成质量或安全保证。第三方 skill 仅作拆解与展示，安装使用风险自负，版权归原作者。

1实现原理 · 为什么它能做到

这是整个 20+ skill 生态的『强制入口』路由层：SKILL.md 用一个『从项目状态出发』的表驱动决策——先看现有状态（port/具体操作/编辑/BRIEF.md/hyperframes.json/全新创建），命中首行即止，而不是每次重跑意图访谈。

skills/hyperframes/SKILL.md
Apply the first matching row; do not evaluate lower state rows:
注：状态表 6 行（Remotion port → 具体操作 → 具体编辑 → BRIEF.md 存在 → 有项目文件 resume → Fresh creation run intent layer）；'If a fresh request does not identify the subject or input, ask what the video is about before routing.'

全新创建走一个专门的意图访谈层（references/intent-interview.md 八步：记忆→triage→选路由→pitch→must-haves→run-shape→写 BRIEF.md→收尾），访谈结论固化成 BRIEF.md——『brief 是唯一路由工件』，之后不再回读本 skill。

skills/hyperframes/SKILL.md
For fresh creation the intent layer (`references/intent-interview.md`) runs the full conversation — memory, triage, pitch round, must-haves, run-shape, hand-off — and **ends by writing `BRIEF.md`. The brief is the only routing artifact the workflow reads**
注：intent-interview.md 实测含八步：1 memory before questions（跑 media-use 的 prefs/recipe 脚本读用户记忆）、2 triage、3 pick route、4 pitch round（unformed 请求先给 5 个概念）、5 must-haves、6 两个 run-shape 问题（storyboard? / automation vs companion）、7 brief、8 收尾。

分发路由表按『交付物』而非关键词匹配：10 行 workflow（remotion port → slideshow → embedded-captions → talking-head-recut → music-to-video → motion-graphics → pr-to-video → product-launch-video → faceless-explainer → general-video），并附 7 条歧义消解规则。

skills/hyperframes/SKILL.md
Use the first matching row. Match the requested **deliverable**, not a word or file type mentioned in passing.
注：路由前须读 references/routes/<workflow>.md（每路由一个 ~1KB 小文件：I/O/触发契约 + 该路由的访谈入口），候选不满足契约就继续路由而不是硬套。

进入工作流前强制刷新/安装目标 workflow 与核心域技能：`npx hyperframes skills update <workflow-name>`；失败就报错、禁止凭记忆重构 workflow——依赖 CLI 为事实源。

skills/hyperframes/SKILL.md
Before reading the selected workflow, install or refresh it and the core domain skills: ```bash npx hyperframes skills update <workflow-name> ``` Use the bare name without `/`. If the command fails, surface the error; do not reconstruct the workflow from memory.
注：安装机制细节（core-vs-lazy 拆分、init 刷新、CI opt-out、无 CLI 回退）在 references/skill-lifecycle.md——本 skill 负责『选对 workflow 并保证其在场』。

域技能按需加载表（composition 结构→core、motion→animation、keyframes、creative、media-use、audio、cli、registry、figma），且『Creator edit phrases』类跨域请求有精确的『加载哪些技能』矩阵；域技能从不接管端到端交付。

skills/hyperframes/SKILL.md
| zoom in here, punch-in / punch-out, smooth multi-state zoom or reframe, Ken Burns, or camera move | `/general-video` + `/hyperframes-core` + `/hyperframes-keyframes`; animate the inner visual/crop wrapper, not the timed clip. |
注：矩阵按创作动词（cut/zoom/transition/fade/mix/组合）精确到‘加载 A+B+C’，避免要么漏技能要么全加载；'Domain skills never take ownership of the end-to-end deliverable.'

版本纪律内建：恢复项目时先探测 pin 落后与否（`npx hyperframes@latest upgrade --project . --check` 只读探测），落后再升级并 `npx hyperframes check` 验证——CLI 版本 pin 由项目 package.json scripts 持有、不会自走。

skills/hyperframes/SKILL.md
A scaffolded project pins `hyperframes@<version>` in its `package.json` scripts so renders stay reproducible; the pin never advances on its own, and a pinned run of an older CLI prints no warning about it.
注：探测命令注明 keep the explicit `.`（老版本 CLI 会把裸 --project 后跟的 flag 当目录值吞掉）——这类坑位级指引说明本 skill 由大量真实使用经验写成。

2核心能力

01项目状态感知的会话恢复（resume/编辑/单操作不重跑访谈）
02意图捕获：八步访谈把『make me a video』收敛成可执行 BRIEF.md（记忆优先、pitch 轮、must-haves、run-shape）
0310 路工作流路由 + 歧义消解（beat-synced vs 音乐铺底、标题卡 vs motion-graphics、storyboard 是流程不是工作流等）
04工作流按需安装/刷新（skills update）与失败上抛
05域技能按需加载矩阵（含 creator 编辑短语的跨域组合）
06CLI 版本 pin 探测与升级验证（upgrade --check + check）

3外部依赖

类型依赖
clihyperframes CLI（skills update / upgrade --check / 项目内 npx hyperframes）
climedia-use 的 prefs.mjs/recipe.mjs（意图层 step 1 读用户记忆/配方；intent-interview.md 指引）
network（间接）npx 首次拉取 / skills update 与 GitHub 最新版比对

4风险提醒 风险提醒：蓝色 · 知晓即可

风险提醒：蓝色 · 知晓即可
  • 分发依赖 CLI/网络可用：skills update 失败则 workflow 不可达，SKILL 要求报错但不提供离线替代 — 有 references/skill-lifecycle.md 描述 no-CLI 回退，但主路径强依赖 npx hyperframes 在场与网络。
  • 既有 BRIEF.md 会被直接执行（workflow/flow 字段决定行为） — 多 agent 协作/克隆项目时若 BRIEF.md 被污染可改变执行路径；宿主应对项目文件来源把关。
  • 路由质量依赖模型对歧义消解规则的理解 — 如把音乐铺底误判为 beat-synced、把 title card 误判为 motion-graphics；SKILL 用规则表缓解但最终判断在 agent。
风险提醒：蓝色，知晓即可。本 skill 是纯编排/路由层：自身只写 BRIEF.md、读本地偏好文件（prefs/recipe，内容为创作偏好无密钥）、运行官方 hyperframes CLI 的 update/upgrade/check（经 npm 官方渠道拉包，不触碰用户配额或密钥——实际渲染/素材/凭证操作被分发到 workflow/域技能，由 media-use 等各自承担其凭证面）。无凭证读取、无第三方外发；skills update/upgrade 的网络面是官方发布渠道，与『本地 CLI 工作流』同级。拿不准处（npx 拉包算网络）按统一分档从宽解释为官方 CLI 常规使用，未升档。

5第二遍独立确认

  • [ok] 『入口/路由』定位与 README/生态描述一致 — README.md：'Read `/hyperframes` first — it's the router and capability map'；CLAUDE.md/AGENTS.md 亦把 hyperframes 列为入口（仓库级 grep 复核）。
  • [ok] 八步访谈与 step 1 读记忆脚本调用 — intent-interview.md 原文 'Run `node <MEDIA_DIR>/scripts/prefs.mjs get --hyperframes <MEMORY_ROOT> --json`' 复核一致；prefs.mjs/recipe.mjs 存在于 media-use/scripts/。
  • [ok] 是否有隐藏脚本/网络（纯文档声称） — find 实测 skills/hyperframes 仅 SKILL.md + references/（10 文件 + routes/ 9 文件），零可执行文件；URL 扫描零第三方域命中。
  • [discrepancy] BRIEF.md 指令载体风险是否遗漏 — 首轮未单列『BRIEF.md 作为可信指令』的注入视角；二轮补充进 injection_surface：项目内既有 BRIEF.md 会被直接执行其 workflow/flow，来源不可信时属项目文件信任面。
  • [ok] 工作流/域技能不越权承诺（end-to-end 归属） — SKILL.md 'Domain skills never take ownership of the end-to-end deliverable. Load only what the active workflow needs.' 与加载矩阵共存，职责边界自洽。

6结论

  • 把『入口』做成状态机+路由+意图三层，恢复旧项目不重跑访谈、新项目不多问——会话成本设计精细
  • BRIEF.md 单一事实源切断跨 skill 信息丢失，链路可审计
  • 跨域加载矩阵精确到创作动词，避免漏技能/全加载两极
  • CLI 版本 pin 与升级验证写进恢复流程，渲染可复现性成为默认
  • 零代码零凭证的纯编排实现，安全面小、可整目录移植
    • 适合：适合任何 HyperFrames 视频创作的入口会话（Claude Code/Cursor/Gemini CLI/Codex 等支持 skills 的宿主），以及任何想研究『多 skill 生态如何用路由层做状态恢复+意图捕获+按需安装+域分发』架构的读者。
    不适合：不适合直接创作细节（它只路由不实现——渲染/动画/素材请进对应域技能）；不适合与 hyperframes 无关的视频方案（它不是通用视频助手，只服务 HTML-to-video 框架，且明确 'HyperFrames is the default output framework unless the user explicitly chooses another'）。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-09
    方式 A · 人下载镜像包下载 hyperframes.tar.gz
    sha256: 90b6328fc5285f0f…
    方式 B · JSON 格式安装指南，复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub？直接去上游安装（实时版，可能已更新）GitHub 原始 ↗
    本页镜像锁定 commit b8328f9573；上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库heygen-com / heygen-com/hyperframes
    原始 GitHubheygen-com/hyperframes ↗
    Stars48297
    最近推送2026-09-09
    本 skill commitb8328f9573
    许可Apache-2.0（仓库根 LICENSE；GitHub API spdx Apache-2.0）
    本站信息
    收录日期2026-09-06
    分类文档与知识
    侦查报告2026-09-06 · 2 遍
    本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。