Skip to main content
GitHub Copilot CLI 为您的终端带来人工智能驱动的编码帮助。 HyperFrames 技能教它如何编写正确的合成、GSAP 时间线和特定于框架的模式 - 因此您无需亲自阅读文档即可获得有效的视频 HTML。

先决条件

  • GitHub Copilot 订阅 — 免费版、专业版、专业版+、商业版或企业版均包含 CLI 访问权限
  • 已安装 Copilot CLInpm install -g @github/copilot (或通过 安装脚本
  • Node.js 22+FFmpeg 用于 HyperFrames CLI

安装技巧

将 HyperFrames 技能包安装到您的项目中:
npx skills add heygen-com/hyperframes
这会将技能目录写入项目中的 .agents/skills/ — Copilot CLI 自动扫描工作区范围技能的路径。
要使技能在您的所有项目中可用,请全局安装它们:
npx skills add heygen-com/hyperframes --agent github-copilot --global
全局技能位于 ~/.copilot/skills/ 中,并加载到每个 Copilot CLI 会话中。
如果您在活动会话期间安装技能,请运行 /skills 打开技能选择器并验证它们是否显示。安装到项目目录的新技能将在下一个提示时自动选​​取。

使用技巧

Copilot CLI 支持通过斜杠命令进行显式调用,也支持根据提示进行自动检测

斜杠命令

在技​​能名称前面加上 / 前缀以显式加载它:
/hyperframes Create a 10-second product intro with a fade-in title and dark background.
/gsap Add a scale-pop animation to the title element.
/hyperframes-cli How do I render at 60fps with Docker?

自动检测

Copilot 还根据每个 SKILL.md 中的 description 字段来匹配技能。如果您的提示提到构图、时间线或视频渲染,代理会加载正确的技能,而无需您指定它们:
Create a 9:16 TikTok hook video about AI productivity with bouncy captions.
当您安装了许多技能时,显式调用会更可靠 - 对于大型技能集,代理的令牌预算可能不适合每个技能描述,因此直接命名技能可以保证其加载。

技能管理

命令它的作用
/skills打开交互式技能选择器 - 浏览、启用或禁用技能
/skills add <path>将附加技能目录添加到当前会话

创建并预览视频

1

搭建一个项目

npx hyperframes init my-video
cd my-video
技能会自动安装在新项目中。
2

启动预览服务器

npx hyperframes preview
在浏览器中打开 HyperFrames Studio。编辑自动重新加载。
3

在项目目录中启动 Copilot CLI

在第二个终端中:
copilot
4

用技能提示

/hyperframes Create a 15-second dark-themed product intro with hype-style
captions and a flash transition to the CTA.
代理在定时元素上写入有效的 HyperFrames HTML — data-* 属性、class="clip",在 window.__timelines 上注册的暂停 GSAP 时间线。保存文件时预览会更新。
5

迭代

继续提示而不重新指定完整上下文:
Make the title 2x bigger and add a lower third at 0:03.
Swap the transition to a whip pan.
6

使成为

npx hyperframes render --output output.mp4
或者询问代理:
/hyperframes-cli Render this composition to output.mp4 at high quality.

代理模式

Copilot CLI 的代理模式可以自主处理多步骤任务 - 搭建项目、编写组合、安装注册表块以及按顺序渲染:
/hyperframes Scaffold a new project called "launch-video", create a 30-second
product launch video with 5 scenes, install the flash-through-white transition
block, and render to mp4.
在代理模式下,Copilot 代表您运行终端命令(例如 npx hyperframes initnpx hyperframes render)。在批准命令之前检查命令 - 特别是如果技能在其 allowed-tools 中预先批准 shell
仅针对您信任的技能预先批准技能 allowed-tools 中的 shellbash。 HyperFrames 技能不会预先批准 shell 访问 - 代理将在运行终端命令之前要求确认。

MCP 替代方案

Copilot CLI 还支持 MCP 服务器进行基于云的创作,无需本地 CLI。使用 --additional-mcp-config 标志将 HyperFrames MCP 服务器添加到您的会话中:
copilot --additional-mcp-config '{"mcpServers":{"hyperframes":{"url":"https://mcp.heygen.com/mcp/hyperframes"}}}'
或者将配置保存到文件并引用它:
copilot --additional-mcp-config @mcp-config.json
出现提示时通过 OAuth 授权。有关完整详细信息,请参阅 MCP 指南

尖端

  • 始终以 /hyperframes 开始进行合成工作。 这会加载通用 Web 知识未涵盖的完整技能上下文 - 合成规则、数据属性、GSAP 模式、标题格式。
  • 使用 /skills 检查技能状态。 如果输出看起来错误,请打开技能选择器以验证 HyperFrames 技能是否已启用。
  • 在渲染之前运行 npx hyperframes lint linter 捕获代理在复杂的多场景编辑中可能错过的结构问题。
  • 让预览服务器在单独的终端中运行。 在 Copilot CLI 中进行提示时,您会看到实时反映的每个编辑。
  • 安装用于过渡和效果的注册表块。 npx hyperframes add shimmer-sweep 安装预构建的块,然后提示代理将它们连接起来。

后续步骤

提示指南

产生更好作品的词汇和模式。

目录

代理可以安装和连接 50 多个即用型块。

GSAP动画

运动原理和时间轴创作。

管道指南

对于多节拍视频,遵循 7 步结构代理。