motion-graphics — 路由入口
在步骤0之前确认路由。 此技能用于制作短小精悍、以设计为主导、无旁白叙述的动态图形(动效即信息;约10秒以内,无画外音)。较长、多场景或有旁白的需求 →
/general-video;网站解说视频 →/website-to-video;主题讲解 →/faceless-explainer;产品宣传 →/product-launch-video;在现有素材上添加字幕 →/embedded-captions。超出范围:实时/渲染时数据,或无法捕获的素材。不确定是动效优先还是叙述优先?请先阅读/hyperframes。
一种短小精悍、以设计为主导的动态图形。资产优先:在设计镜头之前确定资产策略并获取真实素材,然后根据已有内容设计镜头,最后通过复用目录能力进行合成。所有工件位于 PROJECT_DIR = videos/<project-name>/(在步骤0创建);以下所有路径均相对于此目录。
| 阶段 | 执行方式 | 主要工件 | 详细流程 |
|---|---|---|---|
| init | Bash | hyperframes.json | 步骤0 |
| plan | 子智能体 — 决定是否搜索? + 分类 + 资产策略 | shot-plan.json(草稿:类别、asset_needs 查询、简报) | agents/director.md(第1部分) |
| source ◇ | Bash — 媒体用途解析(如果 asset_needs 为空则跳过) | assets/ + assets/index.md | phases/source/guide.md |
| design | 子智能体 — 围绕已解析资产进行镜头设计 | shot-plan.json(最终版:区块 + 布局 + 动效 + 位置) | agents/director.md(第2部分) |
| build | 子智能体 — 复用优先的组合 | compositions/index.html | agents/builder.md |
| render | Bash — hyperframes render(MP4,或 --format webm/mov 用于叠加) | renders/video.mp4 | 步骤5 |
| verify | Bash — lint / inspect -> 失败时调修复子智能体 | (原地修复) | agents/finalize.md |
◇ 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-* + 注册表覆盖层块 |
搜索驱动型类别 — 先搜索,然后按内容类型制作动画(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
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> + 原地自定义;仅手工编写缺口 + asset-fusion 功能。输出 compositions/index.html,遵守 HF 约定(暂停的 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:快照质量检测 + 一轮原地修复 + 重新渲染)。修复过程中绝不改变固定时长。
报告 + 可选预览
报告最终输出(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。