Communitygithub.com

Gertie

将您编写的小型场景文件编译为经过质检的 Lottie JSON 和动画 SVG,并可导出为 GIF、视频以及带字幕和音乐的多场景影片,适用于图标、加载动画、Logo 动态、贴纸和短循环动画。

Gertie 是什么?

Gertie 是一个专为 AI 代理设计的动画制作与质量保障工具,支持将用户编写的场景文件(.gertie.json)编译生成 Lottie JSON 和动画 SVG 两种矢量输出。它具备编译、校验、浏览器渲染对比及导出功能,能够生成 GIF、APNG、WebP、WebM、ProRes、HEVC、MP4 以及 .lottie 归档,并可直接适配 Telegram、Discord、Slack、WhatsApp 等平台的限制。此外,Gertie 还支持从故事板构建带字幕、转场和音乐的多场景影片,以及文本字符(ASCII)动画。该工具内置严格的 QA 流程:编译后自动验证输出、在浏览器中逐帧渲染并对比 Lottie 与 SVG 的一致性,若发现任何错误则拒绝交付。它还提供质量分级(icon/character/scene)和性能分析功能,帮助用户将动画调整至专业水准。Gertie 适用于 Claude Code、Cursor、Codex 等 AI 代理环境,但需要 Node.js、浏览器环境和 ffmpeg 以实现完整功能。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ajithonmain/gertie/tree/HEAD/skills/gertie

在你喜欢的 AI 中提问

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

文档

Gertie 是做什么的?

Gertie 将您编写的一个小型场景文件转换为完成的动画,输出为 Lottie JSON 和动画 SVG。您决定绘制什么以及如何运动。Gertie 负责编译、检查和渲染。

此版本涵盖编写、编译、验证和质量检查场景,提供两种输出格式,并可导出到 GIF、APNG、WebP、WebM、ProRes、HEVC、MP4 和 .lottie 归档,或直接导出到带有平台限制的目标平台(Telegram、Discord、Slack、WhatsApp 等),以及从故事板构建带字幕、转场和音乐的多场景视频,并制作文本字符(ASCII)动画。在导出前请阅读 references/export.md,制作视频前阅读 references/video.md,制作 ASCII 动画前阅读 references/ascii.md。

规则

  1. 切勿手动编写 Lottie JSON。请编写场景文件并编译它。
  2. 切勿呈现未通过 qa 且零错误的成果。
  3. 在编写第一个场景前,请阅读 references/scene.md。跳过此步骤的模型会发明不存在的字段。
  4. 如果用户提供了 SVG,请导入它而非重新绘制:阅读 references/import.md。
  5. 如果用户提供了 Lottie 文件,请阅读 references/lottie.md。不要手动重写。
  6. 如果用户提供了 PNG 或 JPEG 徽标、图标或扁平插图,请进行描摹:阅读 references/trace.md。如果是一幅有纹理的绘画或照片,且用户希望它有一点动态(如眨眼、头部倾斜、飘动的背景),请阅读 references/cutout.md。
  7. 如果用户展示了一个视频或 GIF 并希望“像这样运动的东西”,请阅读 references/motion-reference.md。
  8. 如果用户想要一个包含多个场景(如开场、作品集、讲解、广告)且带字幕、转场或音乐的视频,请阅读 references/video.md。每个场景单独写一个文件,然后编写 .story.json,并运行 story。
  9. 如果用户想要 ASCII 或文本字符动画(README 横幅、终端加载动画、复古风格、密集色彩丰富的字符或点阵片段),或展示了一个 ASCII 片段来模仿,请阅读 references/ascii.md。这是一个独立的引擎,有自己的场景文件(.ascii.json)和命令。简单主题:在文本文件中编写帧或生成它们。密集或流畅的东西:构建一个矢量场景,通过 qa,然后将其作为配方进行转换。多个移动物体:使用图层。要模仿一个片段:使用 ascii probe 获取其网格和颜色。切勿用字符绘制大图形。
  10. 在绘制超出几个形状(如角色、插图、场景)的任何内容之前,请阅读 references/artwork.md:构建顺序、曲线路径、着色、调色板、画布大小。仅由基本图形或纯色构成的场景会引发 W-ART-PRIMITIVE 和 W-ART-FLAT 警告。
  11. 在编写超出简单旋转或滑动的任何内容的关键帧之前,请阅读 references/motion.md,并且对于角色,始终阅读。使用运动预设和骨骼预设而非手动放置的关键帧:它们能为动画提供缓动、预期、过冲和挤压效果。

工作流程

  1. 理解需求。 确定主题、运动、尺寸以及是否循环。仅当缺少答案会改变结果时才提问。否则使用默认值:512×512 画布、30 fps、2 秒、循环、透明背景。

  2. 编写场景 为 <name>.gertie.json。如果用户提供了 SVG,请先运行 node scripts/gertie.mjs import <file.svg> --json 并包含结果(参见 references/import.md)。时间以秒为单位。后面的节点绘制在前面的节点之上。在合适的地方为物体指定 motion 预设。对于角色,构建骨骼并使用骨骼预设(references/motion.md)。

  3. 检查它。 在此技能文件夹内运行脚本 scripts/gertie.mjs:

    node scripts/gertie.mjs qa <name>.gertie.json --json
    

    这将编译场景、验证输出、在浏览器中渲染采样帧并运行渲染检查。文件输出到场景旁边的 out/ 目录:<name>.lottie.json、<name>.svg 和 <name>.sheet.png。该检查分别渲染 Lottie 和 SVG 并逐帧比较。

  4. 修复每个诊断结果。 每个诊断结果包含一个 code、指向场景中位置的 path、一条 message 和一个 fix。应用修复,编辑场景,然后再次运行 qa。先修复错误,然后阅读警告。W-LOOP-JUMP 和 W-R-LOOP 表示循环明显跳跃;W-R-CLIPPED 表示某些内容被画布边缘裁剪。W-SYNC 表示某个组的三个或更多子元素以相同的相位同步运行相同的循环,看起来机械:请为该组指定一个带 phase 的 stagger,或为每个条目指定自己的 phase。E-R-PARITY 表示 Lottie 和 SVG 看起来不同,因此两个输出中有一个是错误的:它会指出帧、节点和差异图像(outputs.parity)。简化该节点的动画以查找原因,并告知用户是否是 Gertie 中的错误。

  5. 查看它。 打开在 outputs.sheet 中命名的联系片图像。它按顺序显示八个帧,每个帧都标有帧编号和时间,绘制在棋盘格上以便透明度可见。检查是否正确的内容存在、颜色正确、帧之间的运动合理、没有任何内容被裁剪或重叠。如果不正确,请编辑场景并返回步骤 3。三次视觉修订后停止。在调试时序时,使用 --sheet-frames 16 以获取更多细节。

  6. 对照质量标准衡量 对于超出快速图标的任何内容。将场景的顶级 `

相关技能