插件安装: 在设置或更新命令之前,如果此技能位于 HyperFrames 插件中,请遵循插件执行规则。独立安装则保留下方的更新说明。
首先,保持技能最新 —— 先与用户确认后再运行:
npx hyperframes skills update motion-graphics。如果一切已是最新,则快速无操作;否则,它将刷新此技能及其依赖的核心领域技能,然后再使用它们。
Figma 源:如果要构建的 Logo/素材/动画来自 figma.com URL,请先运行
/figma—— 导出素材、品牌令牌,以及如果图形是 Figma Motion 导入则进行 Motion→GSAP 转换 —— 然后从其输出进行构建。不要直接通过原始 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/<项目名称>/ 中(在第0步创建);以下所有路径都相对于此目录。
| 阶段 | 执行 | 主要产物 | 详细流程 |
|---|---|---|---|
| init | Bash | hyperframes.json | 第0步 |
| plan | 子代理——决定搜索? + 分类 + 资产策略 | shot-plan.json(草稿:类别、asset_needs 查询、摘要) | agents/director.md(第一部分) |
| source ◇ | Bash —— 媒体使用解析(如果 asset_needs 为空则跳过) | assets/ + assets/index.md | phases/source/guide.md |
| design | 子代理——围绕已解析资产进行镜头设计 | shot-plan.json(最终版:块+布局+动效+位置) | agents/director.md(第二部分) |
| build | 子代理——优先复用进行组合 | compositions/index.html | agents/builder.md |
| verify | Bash——lint、check、预览截图;失败时修复 | snapshots/contact-sheet.jpg | 第5步 |
| approve | 打开预览;询问渲染或修改;等待回答 | 明确的渲染批准 | 第6步 |
| render | Bash——hyperframes render(MP4,或 --format webm/mov 用于叠加层) | renders/video.mp4 或透明叠加层 | 第6步 |
◇ source 仅在所选类别声明有资产时运行。纯代码/文本类别(例如 kinetic-type、大多数 charts/stat)的 asset_needs: [] 会直接从规划跳到设计。
类别 —— 由搜索决定拆分
plan 的第一个决策是:是否需要搜索? 这个分支将类别分成两组;然后选择具体类别 —— 对于搜索驱动的,根据搜索返回的内容类型。每个类别对应一个 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。
可选密钥(如果未设置则使用本地回退)—— 仅由通过媒体使用解析生成/获取资产的类别需要:
| 密钥 | 用途 | 回退 |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | 图片生成(媒体使用解析) | 跳过生成/仅搜索 |
| (asset_scout / 搜索提供者) | webpage/news/tweet + asset-fusion 真实资产搜索 | 类别降级为无资产 |
流程
第0步 —— 初始化
当前工作目录是代理工作区的根目录;将所有产物写入 PROJECT_DIR = videos/<项目名称>/ 下。<项目名称>:使用用户指定的目录名,否则从意图中取一个短横线分隔的简短名称(<主题>-motion)。不要使用工作区的基本名称或时间戳。
仅当 $PROJECT_DIR/hyperframes.json 不存在时:
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<项目名称>}"
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步 —— 规划(子代理:导演第一部分)
调度一个子代理。提示 = 完整的 agents/director.md + ## Dispatch context(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:媒体使用,条件性)
如果 shot-plan.json.asset_needs 非空,则解析资产(搜索/生成/获取 → 冻结的项目本地路径 + 账本)。参见 phases/source/guide.md(包装了 media-use resolve;搜索驱动类别使用新闻/网页/推特/图片搜索)。如果 asset_needs 为空,则跳到第3步。
优雅降级:如果搜索/提供者不可用,类别回退为无资产(在 context.log 中记录)。
第3步 —— 设计(子代理:导演第二部分)
调度一个子代理(提示 = agents/director.md 第二部分 + 调度上下文,包括已解析的 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 <证明时间点>)
选择能展示初始状态、关键动作和最终保持状态的证明时间点。在继续之前检查生成的联系表或截图。在 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步(批准) |
| 已批准渲染存在 | 验证输出,然后报告 |
设计说明(维护者——执行时不阅读此部分)
- 资产优先原则:始终在开始设计之前获取/生成真实素材,确保设计围绕实际内容展开,而非理想化假设。
- 所有动效应遵循
references/motion-vocabulary.md中定义的共享动效词汇,确保一致性和可复用性。 asset-fusion类别需要特别注意:资产几何形状与数据图表的对齐应基于实际像素位置,而非近似估算。- 渲染参数(
-q high)和格式选项(--format webm/mov)应始终根据使用场景选择,透明叠加层通常需要 WebM 或 MOV 格式。
(原文其余部分已截断,未完整提供。以上翻译基于提供的完整内容。)