动态图形 — 调度入口
在步骤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(第一部分) |
| 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 |
| 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-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>:使用用户提供的目录名,否则从意图中取一个短的 kebab-case 名称(<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 上最新版本,并更新全局集合(如有过时)。
限制: 永远不要在 workspace 根目录运行 hyperframes init;永远不要将另一个 hyperframes/ 嵌套在 PROJECT_DIR 内;每个 Bash 命令(主代理 + 子代理)都是 (cd "$PROJECT_DIR" && ...) 子shell — 永远不要裸 cd。
步骤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 — 设计(子代理:导演第二部分)
分发一个子代理(提示词 = agents/director.md 第二部分 + 分发上下文,包括已解析的 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 支持入口。输出符合 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:快照质量检查 + 一轮就地修复 + 重新渲染)。修复过程中永远不要改变固定时长。
报告 + 可选预览
报告最终输出(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-genre.md§5-7。