Communitygithub.com

动效渲染

渲染、交付和重新品牌化动效镜头——支持预设、输出版本、动效交付(验证、冻结、复制最终文件)以及为已交付项目应用品牌变更。

动效渲染 是什么?

这是一个专注于动效图形(MG)镜头渲染与交付流程的AI代理技能。它通过命令行工具`pnpm mg`提供了一系列高效的工作流:包括一键渲染镜头、预设管理(如覆盖层、交付格式、WebM Alpha)、交付(验证、冻结、复制最终文件)以及重新品牌化(应用客户品牌变更)。其核心优势在于自动化验证(帧大小、Alpha通道、FPS)和版本控制,确保每次渲染都会为更改像素的镜头递增版本号,而未更改的镜头则被跳过。该技能适用于任何使用动效图形的开发团队或工作室,支持基于项目的配置文件(如project.json、tokens.json),并可通过`motion-qa`工具进行质量检查。它极大地简化了从渲染到交付的繁琐流程,并确保品牌变更安全、可追溯地应用到项目中。

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

在你喜欢的 AI 中提问

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

文档

渲染与交付

运行 pnpm mg check <client>/<project> 作为第一步;只有当它报告无问题时才进行渲染。

渲染

pnpm mg render <client>/<project>            所有镜头
pnpm mg render <client>/<project> lt-ceo     单个镜头
pnpm mg render <client>/<project> --force    即使未更改也重新渲染

输出:renders/<shot>_v<NNN>.<ext>。每次像素发生变化的渲染都会获得下一个版本号;旧版本会保留。renders/manifest.json 记录了所有影响像素的因素的哈希值(属性、解析后的令牌、字体/Logo/资源内容、预设、工具箱版本、客户端模板代码)。未更改的镜头会被跳过。

预设

预设文件用途
overlay(默认)带Alpha通道的ProRes 4444 .mov在Resolve/Premiere/FCP中覆盖在素材上的下三分之一和标题
deliveryH.264 .mp4,透明区域为黑色审阅链接、全帧图形
webm-alpha带Alpha通道的VP9 .webmWeb播放器;大多数编辑器忽略WebM的Alpha通道

通过每个镜头设置 ("preset")、每个项目设置 (project.json) 或每次运行设置 (--preset) 来指定。

交付

当用户完成项目交接(或确认图形为最终版)时:

pnpm mg deliver <client>/<project> [shot…]

它会渲染已更改的内容,验证每个文件(overlay/webm-alpha预设的Alpha通道、帧大小、帧率),冻结项目,并将最终文件复制到 deliver/<YYYY-MM-DD>/<shot>.<ext>。如果验证失败,不会冻结或复制任何内容;修复报告的问题后重新运行。告知用户 deliver/ 文件夹的路径。

冻结意味着:后续的室内修改、客户修改或变体编辑不会更改此项目的渲染结果。

应用品牌变更

在用户更改客户或变体令牌(新颜色、字体、Logo)之后:

  1. 预览:pnpm mg rebrand <client>(或 pnpm mg rebrand <client>/<project> 用于单个项目)。它不会更改任何内容,而是按项目列出当前品牌将更改的内容。设置 "extends": "none" 的项目会被跳过。
  2. 向用户展示列表,并询问要更新哪些:全部、部分项目,或都不改(仅新项目使用新品牌)。
  3. 应用用户选择的更改:pnpm mg rebrand <client> --apply 或针对单个项目的 pnpm mg rebrand <client>/<project> --apply。冻结的项目会重新锁定到当前品牌;每个列出的项目都会重新渲染为新版本。旧版本保留在 renders/ 中。
  4. 对新渲染结果运行 motion-qa。对于需要再次交付的项目,运行 pnpm mg deliver 以刷新 deliver/。

不运行重新品牌化也是一个有效的选项:冻结的项目保持其已交付的外观,只有未冻结的项目在下次渲染时遵循品牌。

其他品牌命令:

  • pnpm mg diff <client>/<project>:显示单个项目与其锁定版本(冻结)或上次渲染(未冻结)之间的差异。
  • 如果未冻结项目自上次渲染以来品牌已更改,其渲染过程会打印警告并列出更改内容。
  • 对冻结项目仅编辑项目级令牌:编辑 tokens.json,然后运行 pnpm mg rebrand <client>/<project> --apply。

故障处理

  • 错误信息中提及属性、令牌、字体或文本宽度的错误来自验证;请修正 JSON,而不是模板。pnpm mg check 会一次性列出所有此类问题。
  • 浏览器启动、缺少库、编解码器或路径错误:运行 pnpm mg doctor。

Individual skills in this repo

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

相关技能