首先,保持本技能最新——静默运行,无需询问:
npx hyperframes skills update motion-graphics。如果一切已是最新,则快速无操作;否则,它会刷新本技能以及其依赖的核心领域技能,然后你才能依赖它们。
figma 源:如果要构建的标志/资源/动画来自figma.com网址,请先运行
/figma——资产导出、品牌令牌和Motion→GSAP转换(如果图形是Figma Motion导入)——然后基于其输出进行构建。不要直接通过原始的MCP工具驱动Figma:这会跳过SVG消毒、.media/manifest.jsonl溯源以及品牌令牌var()绑定,因此后续的品牌变更无法在不完全重新导入的情况下传播。
动态图形——分发入口
前门是
/hyperframes。 本技能制作简短、设计主导、无旁白的动态图形(运动即信息;约10秒以内,无画外音)。任何更长、有旁白或多场景的内容——或任何不确定的情况→首先阅读/hyperframes:意图层拥有所有路由决策权。
此工作流程本质上是自主的——最多一个澄清问题(agents/director.md),然后通过验证进行构建,无需中间审查。意图层(/hyperframes → references/intent-interview.md)直接路由到这里,而无需询问运行形状问题;对于如此短小的作品,故事板和伴随会话几乎没有帮助。渲染仍然由用户把关:在检查和证明快照通过后,从../hyperframes-core/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——媒体引用解析(如果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: [],直接从规划跳转到设计。
类别——根据搜索决策划分
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-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 | 图像生成(媒体引用解析) | 跳过生成/仅搜索 |
| (资产侦察/搜索提供商) | webpage/news/tweet + asset-fusion真实资源搜索 | 类别降级为无资源 |
流程
第0步 — 初始化
当前工作目录为代理工作区根目录;所有产物写在PROJECT_DIR = videos/<project-name>/下。<project-name>:使用用户提供的目录名,否则从意图中取一个短的中划线连接格式的名称(<主题>-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);内容由用户提供;
asset_needs: []。 - 是 → 将搜索计划输出到
asset_needs[](新闻/网页/推文/图像;双极查询)。具体的搜索驱动类别(webpage / news / tweet / asset-fusion)由第2步返回的内容类型确定,并在第3步最终确定。
- 否 → 选择一个表单类别(kinetic-type / stat / charts / logo-reveal / lower-thirds);内容由用户提供;
- 写入一个草稿
shot-plan.json(信封 + 选择的表单类别 或 搜索意图 +asset_needs+ 一段镜头简介)。Schema: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步。
# 说明性——参见 phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
优雅降级:如果搜索/提供商不可用,类别回退到无资源(在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步 — 构建(子代理:构建器,优先复用)
派发一个子代理。提示词 = 完整的agents/builder.md + 派发上下文(shot-plan.json,catalog-map.md,该类别的module.md,references/motion-vocabulary.md,references/builder-contract.md)。优先复用:npx hyperframes add <block> + 就地定制;仅手动编写空白 + 资源融合支持。输出compositions/index.html,遵循HF合约(在window.__timelines上暂停的GSAP时间线,class="clip" + 稳定ID,tl.seek(0),确定性)。
第5步 — 验证(Bash → 失败时修复子代理)
(cd "$PROJECT_DIR" && npx hyperframes lint .)
(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)
仅在收到明确的渲染答案后才渲染:
(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步(审批) |
| 已批准渲染存在 | 验证输出,然后报告 |
设计说明(维护者——执行时不读取此内容)
- 资源优先的理由: 源获取在前期完成,并为镜头设计提供信息(RWA流程:分析 → 搜索 → 审查 → 组合)。搜索驱动类别(
webpage/news/tweet)和asset-fusion都依赖于媒体引用搜索(新闻/网页/推文/图像),这是媒体引用有记录的RWA谱系。 - 优先复用: 生态系统内对LLM生成模板的类比是“使用
npx hyperframes add组合已知质量块,然后就地定制少量代码”。