motion-graphics — 分发条目
在步骤0之前确认路由。 此技能制作简短、设计主导、无旁白的动态图形(运动即信息;约10秒以内,无配音)。更长、多场景或有旁白的作品 →
/general-video;网站的旁白视频 →/website-to-video;主题讲解 →/faceless-explainer;产品推广 →/product-launch-video;现有素材的字幕 →/embedded-captions。超出范围:实时/渲染时数据,或无法捕获的素材。不确定是运动优先还是有旁白?请先阅读/hyperframes。
一个简短的设计主导动态图形。资产优先:在设计镜头之前决定资产策略并获取真实材料,然后围绕已有资产设计镜头,并通过复用目录能力进行合成。所有工件都放在 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 — hyperframes render(MP4,或 --format webm/mov 用于叠加) | renders/video.mp4 | 步骤5 |
| 验证 | Bash — lint / inspect -> 失败时修复子代理 | (就地修复) | agents/finalize.md |
◇ 素材获取 只在所选类别声明需要资产时运行。纯代码/文本类别(例如 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-* + 注册表叠加块 |
搜索驱动类别 — 先搜索,然后根据内容类型动画化(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/<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
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+ 一段镜头简报)。模式: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> + 就地自定义;仅手动编写缺口 + 资产融合机制。输出符合 HF 规范的 compositions/index.html(暂停的 GSAP 时间线在 window.__timelines 上、class="clip" + 稳定 ID、tl.seek(0)、确定性的)。
步骤5 — 渲染(Bash)
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# 透明叠加变体:--format webm(或 mov)
步骤6 — 验证(Bash → 失败时修复子代理)
(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)
exit 0 → 完成。出现 lint/inspect 错误时,分发修复子代理(agents/finalize.md:快照 QA + 一次就地修复 + 重新渲染)。修复过程中永远不要更改固定时长。
报告 + 可选预览
报告最终输出(renders/video.mp4,或 .webm / .mov 叠加变体)+ 时长。运行期间不要打开预览。 仅在请求时提供,且在渲染之后启动,以便提供最终文件:
(cd "$PROJECT_DIR" && npx hyperframes preview) # Studio UI;或 `npx hyperframes play` 获取可共享链接
标志位于 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 存在,没有 renders/video.mp4 | 步骤5(渲染)+ 步骤6 |
renders/video.mp4 存在 | 报告 + 停止 |
设计说明(维护者——执行时不读取此内容)
- 资产优先的理由: 素材获取提前进行,并指导镜头设计(RWA 流程:分析 → 搜索 → 审查 → 合成)。搜索驱动类别(
webpage/news/tweet)和asset-fusion都依赖于媒体使用的搜索(新闻/网页/推文/图片),这是媒体使用记录的 RWA 血统。 - 复用优先: 生态系统中 LLM 生成模板的类比是“组合目录块 +
hyperframes-animation规则”。HF 的暂停 GSAP 时间线相当于 Remotion 的useCurrentFrame。 - 类别模块约定: 一个
categories/<id>/module.md(规划 + 构建),共享references/motion-vocabulary.md(+ 可选评估)。添加一个类别 = 放下文件夹 + 在agents/director.md中注册其分类器行 + 在catalog-map.md中注册其行;阶段流程保持不变。 - 目录结构:
videos/<project-name>/ hyperframes.json context.log shot-plan.json # IR(导演输出) assets/ assets/index.md # 媒体使用输出(如果已获取) compositions/index.html # 构建器输出 renders/video.mp4 - 注册: 在
hyperframes路由器中——添加“设计主导的短动态图形”意图 + 工作流描述;从/general-video中切出 motion-graphics 触发器;添加反向禁止使用的边。参见motion-graphics-genre.md§5-7。