它能做什么

中文摘要

HyperFrames CLI 的 Agent 使用技能，覆盖完整开发闭环：init 脚手架、catalog 检索动作原语、add 安装、编写、lint 快检、check 终检、snapshot 子合成抽检、preview 预览、按质量分级渲染、publish 发布，以及 doctor、timeline、history、clean 等辅助命令。渲染支持本地、HeyGen 托管云、AWS Lambda 与 Google Cloud Run 四种路径，运行需要 Node.js 22+ 与 FFmpeg。文中强调以 --json 输出供 Agent/CI 调用、check 取代已废弃的 validate/inspect/layout 别名、渲染前必须取得用户明确批准，并给出 catalog 本地检索与可选离线语义检索（约 33 MB 下载）的完整约定。

为什么推荐

适用场景

用 HyperFrames 从零搭建项目并按 lint、check、preview、render 顺序推进视频制作
在动手编写动效前，通过 catalog 检索是否已有现成动作原语再决定是否手写
在本地、HeyGen 云、AWS Lambda 或 Google Cloud Run 之间选择并执行渲染
对含子合成的项目做中间帧快照抽检，排查挂载失败类缺陷
在 Agent 多轮编辑中通过 history begin/end/undo 保留并叠加用户的手动改动
将渲染与校验命令接入 CI，使用 --json、--strict 系列参数做门禁
诊断构建或渲染失败，并用 feedback 提交可复现的反馈包
在视频工作流开始与里程碑节点读取 hyperframes usage --json 查看用量额度

使用前先看

主要亮点

01
开发闭环共 10 步，从 init 脚手架到验证输出，渲染门槛明确分为 --quality draft / looks / delivery 三档
02
check 会先运行 lint，再用单次浏览器会话和一次 seek 审计运行时错误、失败请求、布局、*.motion.json 断言与 WCAG 对比度；validate、inspect、layout 为已废弃别名
03
渲染路径支持本地、HeyGen 托管云、AWS Lambda、Google Cloud Run，要求 Node.js 22 或更新版本及 FFmpeg
04
catalog 检索完全本地，不发送查询内容；默认按词面排序，--on-device 可用约 33 MB 的一次性下载切换到按语义排序，需经用户同意
05
提供 history begin/end/undo 的回合制项目历史，可撤销 Agent 最近的改动而不影响用户编辑，冲突时退出码为 2 并打印两个选项
06
Agent 约定建议优先使用 --json，doctor --json 始终退出码为 0，需通过其 .ok 字段判断状态
07
渲染进程随启动它的进程终止而停止；可用 HYPERFRAMES_RENDER_DETACHED=1 在独立进程组中启动长时间渲染
08
完成一次成功渲染后可提交带 --rating 0-10 的反馈；缺失功能与宿主应用问题则用不带评分的 --comment 报告
09
hyperframes usage --json 可读取 Claude Code、Codex、Grok 的用量窗口（usedPercent、remainingPercent、resetsAt），读取凭据但不刷新或重写

原始文档

原文摘录

**Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin. Standalone installs keep the update instructions below. HyperFrames CLI Run commands as `npx hyperframes ...` unless project instructions provide a wrapper. Obey the wrapper when present. The CLI requires Node.js 22 or newer and FFmpeg.

hyperframes-cli

中文摘要

推荐理由

适用场景

主要亮点

原文摘录