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.
1实现原理 · 为什么它能做到
这是整个 20+ skill 生态的『强制入口』路由层：SKILL.md 用一个『从项目状态出发』的表驱动决策——先看现有状态（port/具体操作/编辑/BRIEF.md/hyperframes.json/全新创建），命中首行即止，而不是每次重跑意图访谈。
Apply the first matching row; do not evaluate lower state rows:
全新创建走一个专门的意图访谈层（references/intent-interview.md 八步：记忆→triage→选路由→pitch→must-haves→run-shape→写 BRIEF.md→收尾），访谈结论固化成 BRIEF.md——『brief 是唯一路由工件』，之后不再回读本 skill。
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**
分发路由表按『交付物』而非关键词匹配：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 条歧义消解规则。
Use the first matching row. Match the requested **deliverable**, not a word or file type mentioned in passing.
进入工作流前强制刷新/安装目标 workflow 与核心域技能：`npx hyperframes skills update <workflow-name>`；失败就报错、禁止凭记忆重构 workflow——依赖 CLI 为事实源。
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.
域技能按需加载表（composition 结构→core、motion→animation、keyframes、creative、media-use、audio、cli、registry、figma），且『Creator edit phrases』类跨域请求有精确的『加载哪些技能』矩阵；域技能从不接管端到端交付。
| 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. |
版本纪律内建：恢复项目时先探测 pin 落后与否（`npx hyperframes@latest upgrade --project . --check` 只读探测），落后再升级并 `npx hyperframes check` 验证——CLI 版本 pin 由项目 package.json scripts 持有、不会自走。
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.
2核心能力
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管控建议与判定依据
- 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（访谈产物，工作流唯一路由工件）
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结论
90b6328fc5285f0f…