1实现原理 · 为什么它能做到
纯指令型 skill：目录内只有 3 个文件（SKILL.md + agents/openai.yaml + references/keyframe-patterns.md），没有任何可执行脚本、二进制或数据资产；它靠把「关键帧=姿态契约」写成硬规则，再由宿主 agent 写出合成 HTML/GSAP。
skills/hyperframes-keyframes/agents/openai.yaml
interface: display_name: "HyperFrames Keyframes" short_description: "Author seek-safe video keyframes" default_prompt: "Use $hyperframes-keyframes to author seek-safe 2D/3D keyframes and verify them with the CLI."
注：这里在做什么：openai.yaml 是 Codex/OpenAI 宿主的 interface 清单（display_name/short_description/default_prompt），与 SKILL.md 的 frontmatter 配对，让同一 skill 在 Claude Code 与 Codex 两侧都能被识别；它不携带任何执行逻辑。全目录 3 文件由全量文件清单复核确认（无 scripts/）。
把 keyframe 定义为「姿态契约」而非补间参数：可见状态、主体身份连续、可 seek 运行时、像素可验，四条构成验收口径。
skills/hyperframes-keyframes/SKILL.md
Keyframes are a pose contract: visible states, continuous subject identity, seek-safe runtime, verified pixels.
注：这里在做什么：一句话给定本 skill 的判据。后文的 Procedure 五步（识别主体/选最小机制/写 seek-safe 关键帧/CLI 验证/失败回最小诊断）与 Error Handling 表（endpoint-only、identity break、fake 3D、wrong final、unseekable runtime、unreadable text）都是这句话的展开。
seek-safe 是硬约束，不是建议：只允许「同步构建 + 注册时间线」的确定性运行时，逐条点名禁止时钟、未播种随机、事件触发与异步时间线。
skills/hyperframes-keyframes/SKILL.md
Never use for render-critical motion: - `Date.now()` - `performance.now()` - unseeded `Math.random()` - hover/scroll triggers - timers - async-created timelines - unregistered `requestAnimationFrame` - infinite loops
注：这里在做什么：视频渲染器按帧号 seek 播放，任何依赖真实时间/随机/交互的动画在渲染时不可复现。配套的 GSAP 骨架要求 `gsap.timeline({ paused: true })` 并 `window.__timelines[compositionId] = tl` 注册、且不得调用 `tl.play()`——把「播放」交给渲染器的时间轴。
能力边界被显式切成三份并逐行标注归属：视觉运动归本 skill，片段时序（trim/splice/reorder/source range）归 hyperframes-core，声音（fade/crossfade/ducking）归 hyperframes-audio；跨域请求以表格给出「真话机制」。
skills/hyperframes-keyframes/SKILL.md
Keyframes own visual motion, not clip assembly. Source-range hard cuts, trim, splice, and reorder belong to `/hyperframes-core`: author one media element per kept range, place it with `data-start` and `data-duration`, and select its source offset with `data-media-start`.
注：这里在做什么：用「Creator request → Truthful mechanism」表把用户的常见口语需求（punch-in、Ken Burns、match cut、speed ramp、freeze）一一映射到机制或明确拒绝（如 'Source speed ramps | Not supported: there is no time-varying playback-rate envelope.'、'Arbitrary mid-source freeze is not supported'）。这防止模型用假动作（例如 scale 冒充 3D）糊过去。
验证闭环落在 hyperframes CLI 上：lint → check → keyframes 诊断 → 聚焦 --shot → snapshot，按「证明什么」分工；并规定诊断失败时的取证顺序。
skills/hyperframes-keyframes/SKILL.md
npx hyperframes lint npx hyperframes check npx hyperframes keyframes . npx hyperframes keyframes . --json npx hyperframes keyframes . --runtime all npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
注：这里在做什么：表格把每个工具的证明力写明（keyframes=靶点/显式中停/轨迹/CSS 停靠/Anime 注册；--shot=ghost、路径形状、时间分布、DOM 3D 投影；--layout strip=原地运动与重叠；--ghost=canvas/WebGL；snapshot --at=遮罩、可读性、末帧锁版）。失败时先 `--json` 找真实运动对象，再拍它，再 snapshot 全帧，最后 'trust painted pixels over logs'。
运行时按引擎分别给出可复现约束，并把「文本表面未列 WAAPI」这类文档缺口显式标记为需自证。
skills/hyperframes-keyframes/SKILL.md
WAAPI: - finite `duration` - `fill: "both"` - deterministic construction - the text surface does not list WAAPI; verify with `--shot` (it seeks WAAPI) and snapshots
注：这里在做什么：GSAP / CSS keyframes / Anime.js / WAAPI 四套骨架各有硬约束（GSAP 同步构建 + paused + 注册；CSS 有限时长/迭代 + deterministic delay + fill-mode both；Anime.js autoplay:false + 有限循环 + push 到 window.__hfAnime）。对未在 CLI 帮助文本中列出的 WAAPI 明确要求额外自证，而不是默认它一定被支持。
2核心能力
01推拉/缩放类镜头（punch-in、punch-out、zoom、reframe）的关键帧编排
02相机位移类（pan / Ken Burns / 多段变焦）——并明确它是「手写几何」而非自动跟踪
03机制选择表：FLIP/共享元素、路径行进、描边生长、形状插值、遮罩/裁剪边界、stagger、文本细分、父子反向变换、状态机、3D 深度
04四套运行时骨架 + 各自的可复现约束（GSAP / CSS keyframes / Anime.js / WAAPI）
05CLI 诊断读数：flat / keyframes / motionPath / trace / composed with 与 ghost 间距语义
063D 深度与 Canvas/WebGL 的证明方法（拒绝「缩放=深度」的假 3D）
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | hyperframes CLI（npx，本 skill 唯一的执行面） |
| cli | hyperframes lint / check（合规模拟门禁） |
| package | GSAP（被写进合成 HTML 的运行时，含 MotionPathPlugin / Flip / DrawSVGPlugin / MorphSVGPlugin） |
| package | Anime.js / WAAPI / CSS @keyframes / Three.js / WebGL（可选运行时家族） |
| network | 官方文档外链（仅阅读参考清单，无代码调用） |
| network | sibling skill 引用（同仓本地路径，非网络） |
4风险提醒 风险提醒：绿色 · 放心使用
风险提醒：绿色 · 放心使用
- 验证能力完全外置，缺 CLI 时纪律无法落地 — lint/check/keyframes/--shot/snapshot 全部是 hyperframes CLI 子命令；宿主未安装或未构建 hyperframes 时，SKILL.md 要求的验收步骤无从执行，rules 退化为「只能靠模型自觉」。本 skill 自身不提供任何兜底校验脚本。
- CLI 版本漂移 — 本 skill 没有 `skills update` 自刷新入口（组内唯一缺失），诊断输出字段（flat/keyframes/motionPath/trace/composed with）与 `keyframes` 子命令参数随 CLI 演进可能失配；升级 hyperframes 后需人工核对 CLI Proof 段的命令是否仍有效。
- 无自动化反例检查，正确性依赖人/模型看图 — SKILL.md 要求 'trust painted pixels over logs'，即最终判据是渲染像素；CI 里无法自动判定 identity break、fake 3D、wrong final 这类语义失败，需人工或视觉模型介入。
- 文档内示例数值存在被误抄的残留风险 — GSAP 骨架里带具体数值（x: 120、duration 0.2/0.4）；SKILL.md 明确要求 'Do not copy numeric distances or timing from examples'，属于纪律性约束而非技术防呆，模型仍可能照搬。
风险提醒：绿色，放心使用。整目录 3 个文件全部是 markdown/yaml（SKILL.md、references/keyframe-patterns.md、agents/openai.yaml），零脚本、零网络调用、零环境变量/凭证读取、零文件写入指令；全文件 token 扫描中 URL 命中 21 处全部是参考文献的官方文档链接。能力完全由「确定性关键帧规则 + CLI 取证循环」构成，不产生额外攻击面。注意点仅为：所有验证依赖宿主安装并执行 `hyperframes` CLI（写盘/渲染发生在 CLI 侧），以及模型被要求「不得抄袭示例数值」这类品味约束需人工判断。
5第二遍独立确认
- [ok] 是否含可执行脚本 / 隐藏代码 — 全量枚举 3 文件，无 .sh/.mjs/.cjs/.py/.js；隐藏文件 0 个；与 skills-manifest.json 的 files=3 交叉一致。
- [ok] 网络外发与凭证读取 — `fetch(`、`http.request`、`XMLHttpRequest`、`urllib`、`process.env`、`child_process`、`API_KEY/TOKEN/SECRET/.env/Authorization` 全部 0 命中；21 处 URL 全为文档链接（gsap.com、animejs.com、developer.mozilla.org、threejs.org），无端点调用。
- [ok] 实现原理是否成立（纯指令 vs 有无隐藏执行体） — SKILL.md 的每条硬规则都能在正文找到对应的验收动作（Procedure 5 步 + Done 段 6 项确认），且所有验证都外派给 hyperframes CLI；无隐藏执行体，结论『纯 prompt 编排』成立。
- [discrepancy] 与同仓其它 skill 的组内一致性（自刷新提示） — hyperframes-keyframes 的 SKILL.md **没有** `npx hyperframes skills update hyperframes-keyframes` 前置刷新段；同仓 embedded-captions / faceless-explainer / general-video / motion-graphics / product-launch-video / remotion-to-hyperframes / talking-head-recut 七个 workflow skill 均在正文首段带该提示（'First, keep this skill fresh'）。这不是第一遍看错，而是一处真实的组内不一致：本 skill 只能随 hyperframes CLI 的版本一起更新，无独立自刷新入口。
- [ok] 『外部资源』逐条回查调用点 — hyperframes CLI 的每类命令（keyframes/--shot/--layout strip/--ghost/snapshot --at）在 SKILL.md 的 CLI Proof 段与工具证明表中均有真实出现；GSAP 骨架与 Anime.js 骨架在 references/keyframe-patterns.md 中原文存在，非推测。
6结论
适合：适合已经在用 HyperFrames 的视频构建流程：需要给镜头加推拉/变焦/重构图/Ken Burns/多段相机运动，或需要做 SVG 描边生长、形状插值、遮罩揭示、逐项 stagger、真 3D 纵深等「可见机构」时；也适合要排查「动画渲染出来是静止的/末帧不对/假 3D」这类渲染确定性问题的人——它的诊断表与 CLI 证明路径是现成的排查手册。
不适合：不适合：① 需要剪辑语义（硬切、trim、拼接、重排、变速）的请求——那些归 hyperframes-core，本 skill 只会给你 wrapper 上的视觉关键帧；② 想要自动人脸跟踪/语义重构图的场景（SKILL.md 明确这是手写几何）；③ 想要变速斜坡或任意中段定格（明确 Not supported，需先预处理出派生素材）；④ 没有 hyperframes CLI 的环境——本 skill 的验收步骤全部依赖它；⑤ 视觉风格/品牌设计/素材采购/字幕——description 直接把这些划出范围。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 hyperframes-keyframes.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent78ffadd495cffe9c…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库heygen-com / heygen-com/hyperframes
原始 GitHubheygen-com/hyperframes ↗
Stars44283
最近推送2026-09-06
本 skill commit
b8328f9573许可Apache-2.0（仓库根 LICENSE 为 Apache License Version 2.0；池内值亦为 Apache-2.0）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。