使用指南

Google Antigravity

在 Google Antigravity 中设置 HyperFrames——安装 skills、创作合成并从 agent 优先的 IDE 渲染视频。

Google Antigravity 是 Google 基于 VS Code 构建的 agent 优先 IDE。它的 agent 会根据你的提示自动发现和加载 HyperFrames skills,因此你无需记住框架内部结构即可获得正确的合成。

安装 skills

将 HyperFrames skill 包安装到你的项目中:

npx skills add heygen-com/hyperframes

这会将 skill 目录放置在工作区根目录的 .agents/skills/ 中——Antigravity 扫描工作区范围 skills 的位置。

💡 Tip

如果你希望 skills 在所有 Antigravity 项目中可用,请改为安装到全局范围:

npx skills add heygen-com/hyperframes --agent antigravity --global

全局 skills 位于 ~/.gemini/antigravity/skills/ 中,在每个工作区中加载。

验证 skills 是否已安装:

ls .agents/skills/

你应该看到类似 hyperframes/hyperframes-cli/gsap/tailwind/ 等目录——每个目录包含一个 agent 按需读取的 SKILL.md

Skills 在 Antigravity 中的工作方式

Antigravity 使用语义匹配——当你输入提示时,agent 会将其与每个可用 skill 的 description 字段进行比较,并加载相关的 skill。你不需要通过斜杠命令调用 skill(尽管你可以通过名称来精确引用)。

你说Agent 加载
"创建一个 10 秒的产品介绍视频,带字幕"hyperframeshyperframes-cli
"给标题添加 GSAP 缩放弹出效果"gsap
"使用 Tailwind 进行样式设置"tailwind
"转录这段音频并添加字幕"hyperframes-media
"添加闪烁扫过过渡效果"hyperframes-registry

Skill 只在匹配时才注入 agent 的上下文窗口——这保持了上下文的整洁和专注。

ℹ️ Note

为了获得最佳结果,请在提示中提及 "HyperFrames" 或 "composition",以便 agent 立即匹配正确的 skills,而不是猜测通用的网络视频约定。

创建和预览视频

创建项目脚手架

打开 Antigravity 的集成终端并运行:

npx hyperframes init my-video
cd my-video

向导会引导你完成示例选择和媒体导入。Skills 会自动安装在新项目中。

启动预览服务器

npx hyperframes preview

这会在你的浏览器中启动 HyperFrames Studio 并支持热重载——对 index.html 的编辑会立即显示。

给 agent 发出提示

在 Antigravity 的 agent 侧边栏中,描述你想要的视频:

为我的 SaaS 应用创建一个 15 秒的深色主题产品介绍视频,带淡入标题、嗨风格字幕和闪现过渡到 CTA。

agent 读取 HyperFrames skill,编写带有 data-* 属性和 GSAP 时间线的有效 HTML,并将其保存到你的项目文件中。预览会自动更新。

迭代

像视频编辑器一样与 agent 对话——不要从头重新提示:

把标题放大 2 倍并将过渡改为甩镜。

在 0:03 添加一个下方三分之一字幕条,显示我的名字。

将背景替换为 assets/hero.mp4。

渲染

npx hyperframes render --output output.mp4

在 Manager 视图中使用多个 agent

Antigravity 的 Manager 视图 让你并行协调多个 agent。对于复杂的多场景视频,你可以分配工作:

  • Agent 1: 创作介绍场景和过渡
  • Agent 2: 生成 TTS 旁白和字幕时间
  • Agent 3: 构建数据可视化场景

每个 agent 独立获取相关的 HyperFrames skills。当所有 agent 完成后,使用 data-composition-src 引用将输出合并为单个 index.html

MCP 替代方案

如果你偏好零安装的云端创作,Antigravity 支持远程 MCP 服务器。添加 HyperFrames MCP 连接器,无需 CLI 即可创作和渲染合成——请参阅 Antigravity 的 MCP 文档了解你版本中的确切设置步骤,然后使用服务器 URL:

https://mcp.heygen.com/mcp/hyperframes

在提示时通过 OAuth 使用你的 HeyGen 账户授权。请参阅 HyperFrames MCP 指南了解工具和提示的完整详情。MCP 在云端处理渲染;CLI 提供本地控制。

Agent 指令文件

使用 npx hyperframes init 创建的 HyperFrames 项目会自动生成 CLAUDE.mdAGENTS.md——这些文件为 agent 提供 skills 之外的额外合成上下文。

  • AGENTS.md — 跨 agent 约定。无论你选择哪个模型(Gemini、Claude 或其他),Antigravity 都会读取此文件。
  • CLAUDE.md — 当 Antigravity 的 agent 使用 Claude 模型(Sonnet 或 Opus)时读取,提供 Claude 特定的项目指令。

提示

  • 当精度很重要时,按名称提及 skill。 "使用 hyperframes skill 添加颗粒叠加"比"添加颗粒叠加"更可靠,尤其当 agent 加载了许多 skills 时。
  • 渲染前使用 npx hyperframes lint 检查器会捕获结构性问题(缺少 class="clip"、未注册的时间线、静音视频违规),这些在复杂编辑中 agent 可能会遗漏。
  • 安装 registry blocks 以获得高级效果。 运行 npx hyperframes add shimmer-sweep 安装预构建 blocks,然后让 agent 将它们接入你的合成。
  • 保持预览服务器运行。 Antigravity 的文件监视器 + HyperFrames 的热重载意味着你可以实时看到每次 agent 编辑。

下一步

  • 提示指南 生成更好合成的词汇和模式。
  • 目录 50+ 可直接使用的 blocks,agent 可以安装和连接。
  • GSAP 动画 运动原理和时间线创作。
  • 管线指南 agent 用于多节拍视频的 7 步结构。