插件安装: 在执行设置或更新命令之前,当此技能位于 HyperFrames 插件内部时,请遵循插件执行规则。独立安装则保留下面的更新说明。
首先,保持此技能为最新——在运行前请与用户确认:
npx hyperframes skills update motion-graphics。如果一切最新则快速无操作;否则,在您依赖之前,它会刷新此技能及其依赖的核心领域技能。
figma 源文件:如果 Logo/资源/动画来自 figma.com URL,请先运行
/figma——资源导出、品牌令牌以及 Motion→GSAP 转换(如果图形是 Figma Motion 导入)——然后根据其输出进行构建。不要直接通过原始 MCP 工具驱动 Figma:那样会跳过 SVG 清理、.media/manifest.jsonl溯源以及品牌令牌var()绑定,因此后续品牌更改无法传播,除非完全重新导入。
motion-graphics — 调度入口
入口是
/hyperframes。 此技能制作一个简短、设计驱动、无旁白的动态图形(以运动传达信息;约 10 秒以内,无配音)。任何更长、带旁白或多场景的内容——或任何不确定性——请先阅读/hyperframes:意图层负责所有路径决策。
此工作流设计为自主运行——最多一个澄清性问题(agents/director.md),然后直接构建到验证阶段,无需中间审查。意图层(/hyperframes → references/intent-interview.md)直接路由至此,无需询问运行形态问题;对于如此简短的作品,故事板和会话伙伴帮助不大。渲染仍由用户控制:在检查和验证快照通过后,打开 Studio 预览并询问规范的“立即渲染,还是有什么更改?”问题(来自 ../hyperframes/references/brief-contract.md)。当存在 BRIEF.md 时,请在导演提问之前阅读它。
一个简短的设计驱动的动态图形。资源优先:在设计镜头之前确定资源策略并获取真实素材,然后根据拥有的资源设计镜头,最后通过重用目录能力进行合成。所有工件存放于 PROJECT_DIR = videos/<project-name>/(在第 0 步创建);以下所有路径均相对于此目录。
| 阶段 | 执行方式 | 主要工件 | 详细流程 |
|---|---|---|---|
| 初始化 | Bash | hyperframes.json | 第 0 步 |
| 计划 | 子代理 — 决定是否搜索? + 分类 + 资源策略 | shot-plan.json(草稿:类别、asset_needs 查询、简介) | agents/director.md(第 1 部分) |
| 资源 ◇ | Bash — media-use 解析(如果 asset_needs 为空则跳过) | assets/ + assets/index.md | phases/source/guide.md |
| 设计 | 子代理 — 基于已解析资源设计镜头 | shot-plan.json(最终版:区块 + 布局 + 运动 + 位置) | agents/director.md(第 2 部分) |
| 构建 | 子代理 — 优先重用合成 | compositions/index.html | agents/builder.md |
| 验证 | Bash — lint、check、验证快照;失败时修复 | snapshots/contact-sheet.jpg | 第 5 步 |
| 批准 | 打开预览;询问渲染或更改;等待回答 | 明确的渲染批准 | 第 6 步 |
| 渲染 | Bash — hyperframes render(MP4 或 --format webm/mov 用于叠加) | renders/video.mp4 或透明叠加视频 | 第 6 步 |
◇ 资源 仅在所选类别声明有资源时运行。纯代码/文本类别(例如 kinetic-type、大多数 charts/stat)的 asset_needs: [],直接从计划跳到设计。
类别 — 根据搜索决策划分
计划的首要决策是:是否需要搜索? 这一分支将类别分为两组;然后选择具体类别——对于搜索驱动型,根据搜索返回的内容类型决定。每个类别是一个 categories/<id>/module.md(包含其计划和构建规则);共享的运动词汇存放于 references/motion-vocabulary.md(→ hyperframes-animation 规则/蓝图 + 注册表块)。
表单类别 — 无需搜索;用户提供内容:
| 类别 | 意图 | 依赖 |
|---|---|---|
kinetic-type | 有力的一句话/引言/标题,运动优先的文字 | caption-* 块 + 动画规则 |
stat | 单个英雄数字/计数动画 + 圆环 | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | 来自数据的柱状图/折线图/饼图/竞赛图/百分比 | data-chart 块 |
logo-reveal | Logo 揭示/品牌锁屏(用户 Logo) | logo-outro / rules/svg-path-draw |
lower-thirds | 姓名/标题栏、标注、社交媒体叠加 | caption-* + 注册表叠加块 |
maps | 地理运动 — 高亮区域、连接地点、缩放至位置(矢量路径或烘焙底图层) | us-map / world-map 系列 + bake-basemap.mjs |
搜索驱动类别 — 先搜索,然后根据内容类型制作动画(RWA 路径):
| 返回内容 | 类别 | 动画 |
|---|---|---|
| 网页/链接 | webpage | 网页/UI 动画(滚动、揭示、光标、标注) |
| 新闻文章 | news | 标题揭示 + 来源卡片 + 关键事实标注 |
| 推文 | tweet | 动画推文卡片 |
| 图像/实体 | asset-fusion | 资产的几何形状_变成_图表(RWA 融合效果) |
构建顺序:一次一个,优先覆盖(粗略即可)。kinetic-type 从原型移植;其余后续。
先决条件
macOS Apple Silicon 或 Linux x64。系统工具:brew install node ffmpeg。运行 npx hyperframes doctor 一次。macOS GPU 渲染:export PRODUCER_BROWSER_GPU_MODE=hardware。
可选密钥(未设置时使用本地回退)——仅由那些通过 media-use 获取/生成资源的类别需要:
| 密钥 | 用途 | 回退 |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | 图像生成(media-use 解析) | 跳过生成 / 仅搜索 |
| (asset_scout / 搜索提供商) | webpage/news/tweet + asset-fusion 真实资产搜索 | 类别降级为无资产 |
流程
第 0 步 — 初始化
当前工作目录是代理工作区根目录;所有工件写入 PROJECT_DIR = videos/<project-name>/。<project-name>:使用用户提供的目录名,否则从意图中取一个简短的连字符命名(<subject>-motion)。不使用工作区基名或时间戳。
仅当 $PROJECT_DIR/hyperframes.json 不存在时:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics
init 检查已安装的技能是否与 GitHub 上的最新版本一致,并更新全局集(如果有任何过时)。
约束: 绝不在工作区根目录执行 hyperframes init;绝不在 PROJECT_DIR 内嵌套另一个 hyperframes/;每个 Bash 命令(主代理 + 子代理)都是一个 (cd "$PROJECT_DIR" && ...) 子 shell — 绝不使用裸 cd。
第 1 步 — 计划(子代理:导演第 1 部分)
调度一个子代理。提示 = 完整的 agents/director.md + ## 调度上下文(SKILL_DIR / PROJECT_DIR / 用户请求 / Schema: <SKILL_DIR>/references/shot-plan-ir.md)。它必须:
- 决定:是否需要搜索?(第一个分支)
- 否 → 选择一个表单类别(kinetic-type / stat / charts / logo-reveal / lower-thirds / maps);内容由用户提供;
asset_needs: []。 - 是 → 将搜索计划输出到
asset_needs[](新闻/网页/推文/图像;双极查询)。具体的搜索驱动类别(webpage / news / tweet / asset-fusion)由第 2 步返回的内容类型确认,并在第 3 步最终确定。
- 否 → 选择一个表单类别(kinetic-type / stat / charts / logo-reveal / lower-thirds / maps);内容由用户提供;
- 编写草稿
shot-plan.json(信封 + 所选表单类别 或 搜索意图 +asset_needs+ 一段镜头简介)。模式:references/shot-plan-ir.md。
验证:[ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing。
第 2 步 — 资源 ◇(Bash:media-use,有条件)
如果 shot-plan.json.asset_needs 非空,则解析资源(搜索/生成/获取 → 冻结的项目本地路径 + 账本)。参见 phases/source/guide.md(封装了 media-use resolve;搜索驱动类别使用新闻/网页/推文/图像搜索)。如果 asset_needs 为空,则跳到第 3 步。
优雅降级:如果搜索/提供者不可用,类别回退到无资源(在 context.log 中注明)。
第 3 步 — 设计(子代理:导演第 2 部分)
调度一个子代理(提示 = agents/director.md 第 2 部分 + 调度上下文,包括已解析的 assets/index.md(如果第 2 步运行过)+ catalog-map.md)。它围绕可用资源设计镜头:选择目录块 + hyperframes-animation 规则/蓝图、布局、运动、节奏,以及(对于 asset-fusion)element_positions + 取色板。最终确定 shot-plan.json(content.block + content.customize + 每个类别的内容)。
第 4 步 — 构建(子代理:构建器,优先重用)
在构建器的调度上下文中包含共享的运动原则。对于 charts 和 stat,还要包含数据运动。构建器在编写时间线之前阅读这些指南。
调度一个子代理。提示 = 完整的 agents/builder.md + 调度上下文(shot-plan.json、catalog-map.md、类别的 module.md、references/motion-vocabulary.md、references/builder-contract.md)。优先重用:npx hyperframes add <block> + 就地定制;仅手动编写空白及 asset-fusion 功能。输出 compositions/index.html,遵守 HF 契约(暂停的 GSAP 时间线在 window.__timelines 上、class="clip" + 稳定的 ID、tl.seek(0)、确定性)。
第 5 步 — 验证(Bash → 失败时修复子代理)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)
选择能够展示起始状态、招牌动作和最终保持的验证时间点。在继续之前检查生成的联系表或快照。在 lint、check 或快照失败时,调度修复子代理(agents/finalize.md)进行一轮就地修复,然后重新运行失败的关口。绝不要仅仅为了隐藏缺陷而更改固定时长。
第 6 步 — 批准和渲染(Bash)
打开 Studio,然后问一个问题:“立即渲染,还是有什么更改?” 经过修订后,返回到同一关口:
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
仅在获得明确渲染答案后才渲染:
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# 透明叠加变体:--format webm(或 mov)
验证输出文件存在、非空且具有预期的时长。最终交接应指明工件名称、实际时长、合成或帧 ID、验证时间点以及检查过的联系表或快照。标志位于 /hyperframes-cli → references/preview-render.md。
恢复表
| 状态 | 从中继续 |
|---|---|
无 shot-plan.json | 第 1 步(计划) |
shot-plan.json 有 asset_needs,无 assets/ | 第 2 步(资源) |
shot-plan.json 最终版,无 compositions/index.html | 第 3/4 步(设计+构建) |
compositions/index.html 存在,验证快照缺失 | 第 5 步(验证) |
| 检查和验证快照通过,无批准的渲染 | 第 6 步(批准) |
| 批准的渲染存在 | 验证输出,然后报告 |
设计说明(维护者 — 执行时不读取此项)
- 资源优先原则
…[为翻译而截断]