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外部依赖
| 类型 | 依赖 |
|---|---|
| cli | hyperframes CLI（skills update / upgrade --check / 项目内 npx hyperframes） |
| cli | media-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结论
适合：适合任何 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:
方式 B · JSON 格式安装指南，复制给 agent90b6328fc5285f0f…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库heygen-com / heygen-com/hyperframes
原始 GitHubheygen-com/hyperframes ↗
Stars48297
最近推送2026-09-09
本 skill commit
b8328f9573许可Apache-2.0（仓库根 LICENSE；GitHub API spdx Apache-2.0）
本站信息
收录日期2026-09-06
分类文档与知识
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。