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

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

建议配套管控措施

面向 Agent

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

面向管理者

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

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

scripts/: 执行本地脚本或命令: node <MEDIA_DIR>/scripts/prefs.mjs get / recipe.mjs list（读用户偏好/配方，只读）
外部 API: 向外部平台执行发帖、资源创建或修改写入
环境变量 / API Key: 读取厂商服务密钥: 意图层读用户记忆：prefs.mjs/recipe.mjs 读取项目 .media/preferences.json、recipes/ 与 ~/.me
本地工作目录: 文件读写与工件输出: 写 BRIEF.md（访谈产物，工作流唯一路由工件）

审计说明： 。本 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'）。

Install Agent-Ready

① Verified Mirror 2026-09-09

Option A · Direct DownloadDownload hyperframes.tar.gz

sha256: 90b6328fc5285f0f…

Option B · Copy Guide for Agent

install.json

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

② Upstream GitHub

GitHub Repo ↗

Pinned to commit b8328f9573.