动效图形 — 调度入口
在步骤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 — media-use 解析(如果 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: [] 属性,会直接从规划跳到设计。
类别 — 按搜索决策划分
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。
可选密钥(未设置时使用本地回退)——仅被那些通过 media-use 获取/生成资产的类别需要:
| 密钥 | 用途 | 回退 |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | 图片生成(media-use 解析) | 跳过生成 / 仅搜索 |
| (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 上的最新版本一致,并更新全局集合(如有任何技能已过时)。
约束: 永远不要在工区根目录下执行 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:media-use,条件执行)
如果 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:快照 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都倚赖 media-use 搜索(新闻/网页/推文/图片),这是 media-use 有文档记录的 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 # media-use 输出(如果已获取) compositions/index.html # 构建器输出 renders/video.mp4 - 注册: 在
hyperframes路由中 — 添加“以设计为主导的短动效图形”意图 + 工作流描述;从/general-video中划分出动效图形触发器;添加反向的“请勿使用”边缘。参见motion-graphics-genre.md§5-7。