Communitygithub.com

motion

motion 工作空间的入口点,用于管理mg.json所在根目录下的所有动态图形工作——包括底部字幕、标题、动画文本、品牌变更和渲染输出。请先阅读此技能;它会将你引导至其他 motion-* 技能。

motion 是什么?

此技能(motion)作为 Remotion 动态图形工作空间的核心路由和编排层,通过 `mg` CLI 实现工作流程管理。它定义了一种严格的关注点分离架构:所有设计逻辑(动画、布局)与数据(颜色、文本、字体、时间)完全分离。用户只需编辑 JSON 文件并运行 `pnpm mg render` 即可更改任何可见属性,无需修改代码。技能管理一个层级化的令牌链(从工具包到项目镜头),并强制执行诸如“无硬编码值”和“将数据保留在最低适当层级”等规则,以确保可重用性和一致性。支持的任务包括创建客户端、项目、镜头、模板,以及执行检查、渲染、审查、交付和品牌焕新操作;对于不直接属于这些领域的操作,它会将用户引导至专门的子技能(如 motion-brand、motion-project)。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ryodeushii/motion-graphics/tree/HEAD/skills/motion

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Motion 工作空间

该工作空间通过 mg CLI(pnpm mg <command>)使用 Remotion 渲染可复用的动态图形。设计即代码,以模板形式存在;每个作业特定的值都存放在 JSON 中。更改文本、颜色或字体只需编辑 JSON 并运行 pnpm mg render,无需修改代码。

目录结构

mg.json                         工作区视频默认值(fps、尺寸)
brand/house.tokens.json         基础令牌:基础颜色、字体、缓动函数、持续时间、安全区域
brand/fonts/  brand/logos/      基础令牌引用的文件
clients/<client>/
  client.json                   显示名称、可选的视频覆盖
  brand/tokens.json             客户端覆盖(深度合并到基础令牌之上)
  brand/fonts/ brand/logos/
  brand/variants/<variant>/     命名的备选外观,可被多个项目复用:tokens.json、fonts/、logos/
  templates/<name>/index.tsx    仅限客户端的模板,id 为 "<client>/<name>"
  projects/<project>/
    project.json                 { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
    tokens.json                 仅限项目的覆盖(可选)
    tokens.lock.json            冻结时存在:渲染会忽略实时链
    fonts/ logos/ assets/       项目文件;道具引用资源为 "asset:<path>"
    shots/<shot>.props.json      { template, props, durationSeconds?, preset?, video? }
    renders/                    输出目录,已被 git 忽略;manifest.json 追踪版本

工具包代码(引擎、基础模板、这些技能)位于 node_modules/motion-toolkit 中,由 package.json 固定版本。请勿在此处编辑;基础模板的变更应提交到工具包仓库。

基础模板

每个基础模板都有一个 look 道具:minimal(简洁、轻量字体、模糊上升、无面板)、bold(粗体大写、纯色块、弹性弹出)、corporate(面板、强调条、遮罩揭示)。默认值 "brand" 使用 look 令牌,因此客户端只需在 brand/tokens.json 中设置一次风格("look": "minimal")。

Id用途
lower-third名称和标题条,可选标志
title-card章节或小节标题,可选的引子文字和副标题;叠加或全屏
callout从画面中的点(x、y 作为帧坐标)到标签的连线
end-card结束卡片:标志、标题、行动号召、URL、0–2 个 YouTube 结束画面插槽
kinetic-text逐词揭示的引述或陈述;*word* 可强调
logo-sting短的动画标志揭示(片头/片尾)
counter数字向上计数(value、prefix、suffix、decimals),带标签
social-handle平台图标加 @账号,位于角落(YouTube、Instagram、TikTok、X、LinkedIn 等)
typewriter逐键输入的文本,渲染的音频中包含打字机或键盘音效
corner-branding在任意角落持续显示的水印标志,可附带诸如 LIVE 等标签

pnpm mg new-shot … --template <id> 会用所有默认值写出每个道具。每个道具的含义在其 node_modules/motion-toolkit/templates/<id>/index.tsx 中的 .describe() 文本中有说明。

令牌链

工具包 → 基础 → 客户端 → 变体(如果 project.json 中设置了 "brand") → 项目 tokens.json → 镜头道具。工具包层仅提供默认值(look、mono 字体、打字 sounds)。对象按键逐层合并,null 用于删除继承的键,最具体的层获胜。"extends": "none" 会跳过客户端和变体。字体、标志和声音文件会在包含它们的最具体层的 fonts/、logos/ 或 sounds/ 文件夹中查找。

规则

  1. 每个可见值都来自镜头道具或令牌。模板中不得硬编码颜色、字体、以 px 为单位的尺寸或时间。
  2. 项目存放数据,不存放代码。新设计是模板;新作业是包含镜头文件的项目。
  3. 将值放在拥有它的最低层:单个镜头 → 镜头道具;单个项目 → 项目 tokens.json;客户端的多个项目 → 变体;整个客户端 → 客户端令牌。
  4. 请勿手动编辑 tokens.lock.json。已交付的项目会被冻结;它们只能通过 mg rebrand 更改(参见 motion-render)。
  5. 每次编辑 JSON 或模板后,在渲染前运行 pnpm mg check 并修复其报告的问题。
  6. 每次视觉更改完成后,先执行 motion-qa 程序,然后再报告完成。
  7. 在 mg rebrand --apply 之前,以及在编辑被冻结项目使用的客户端或变体令牌之前,先询问用户。
  8. 如果渲染或检查失败,请在更改代码前运行 pnpm mg doctor。

路由

任务请阅读
新客户端、变体、标志、字体、调色板motion-brand
根据简报创建新项目或镜头;更改现有镜头上的文本/颜色motion-project
新模板或对模板动画方式的更改motion-template,然后阅读 motion-style
动感感觉:缓动、时间、错开、安全区域motion-style
渲染、预设、版本管理、交付、应用品牌变更motion-render
交付前检查输出motion-qa

命令

pnpm mg templates                                 列出模板 id
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<project> <shot> --template <id>   创建包含所有默认道具的镜头文件
pnpm mg new-template <client> <name>              启动模板
pnpm mg check [<client> | <client>/<project>]     验证一切,无需渲染
pnpm mg render <client>/<project> [shot…]         跳过未更改的镜头;--force、--preset
pnpm mg still <client>/<project> [shot…]          在棋盘格背景上查看 PNG(默认查看所有镜头)
pnpm mg studio <client>/<project>                 实时预览;工作室中的“保存”会写入镜头文件
pnpm mg deliver <client>/<project>                渲染、验证、冻结、将最终文件复制到 deliver/<date>/
pnpm mg rebrand <client | client/project> [--apply]   对已交付的作品应用品牌变更
pnpm mg freeze|unfreeze|diff <client>/<project>
pnpm mg doctor                                    环境、mg check、冒烟测试渲染

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能