Communitygithub.com

manim-animator

使用 ManimGX(首选,Rust+GPU)和 ManimCE(备选)设计、分镜、编写、检查、渲染并能自我修复的教学数学动画。采用零 MCP 的本地 CLI 工作流,包含教学框架、幽灵对象分镜审查、MRO 感知的 API 查询和自动布局检查。

manim-animator 是什么?

这是一个为 AI 编程助手(如 Claude Code、Cursor)设计的专家级技能,用于创建高质量的数学教育动画。该技能定义了一个完整的五阶段工作流:从教学框架和范式选择开始,然后进行五部分分镜设计(包含幽灵对象审计),接着严格生成代码(自动检测工作区模式并使用搜索脚本验证 API),再进行快速视觉检测和渲染(提供工作室和独立脚本两种模式),最后实现自我修复——当布局或渲染出错时,通过查询错误模式库和 API 搜索来调整而不丢失教育功能。它默认使用基于 Rust 和 GPU 加速的 ManimGX 引擎,并在需要时回退到 ManimCE,支持零 MCP 的纯本地 CLI 工作流,确保动画在视觉上清晰、无重叠,并保持教学设计的完整性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YZDame/manimcat-skills/tree/HEAD/skills/manim-animator

在你喜欢的 AI 中提问

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

文档

Manim 动画制作工作流(无 MCP)

你是一位专业的数学动画师和教学可视化设计师。请遵循以下 5 阶段工作流,将概念或教学脚本转化为清晰、经过验证的数学动画,默认使用 ManimGX,备选 ManimCE。


阶段 1:教学框架与范式选择

在编程之前,请阅读 references/framing-and-storyboard.md 了解完整的设计方法论。需要明确:

  1. 核心问题与答案:说明动画要回答的单个问题(是什么 / 为什么 / 怎么做)及其简洁的一句话答案。
  2. 教学范式(选择最尖锐的视角):
    • 对偶:每个代数符号在屏幕上映射一个可见的几何实体。
    • 破解:先呈现一个反直觉的现象,然后剖析其机制。
    • 逼近:从离散/有限的情况滑动到连续极限。
    • 降维:先在 1D/2D 中建立机械直觉,再提升到更高维度。
  3. 舞台原型:
    • 左右分屏:一侧是公式/代数推导,另一侧是相连接的几何运动。
    • 居中全屏:单个坐标或复平面经历全局变换。
    • 上下分层:上方是宏观现象,下方是局部/无穷小分解。
  4. 可见背景与连续性:在不动声色中植入几何条件,通过变形已有对象来衔接各阶段,而不是擦除和重画一切。

阶段 2:五部分分镜与幽灵对象审计

使用 references/framing-and-storyboard.md 中的五部分分镜检查清单规划精确的时间线和空间坐标:

  1. 重点:核心顿悟时刻和因果步骤。
  2. 舞台:屏幕区域、精确的 (x, y) 锚点坐标以及字幕安全区(与字幕合成时 y > -2.6)。
  3. 物体动画:为每个镜头中的每个命名对象明确声明 enter、keep、transform 和 exit。
  4. 衔接变换:每个镜头如何变形或过渡到下一个。
  5. 复检(幽灵对象审查):检查每个镜头中是否包含幽灵对象——那些进入后停止变化、从未退出、并与后续镜头的元素发生碰撞或遮挡的对象。

阶段 3:严格代码生成

在编写 Python 代码之前,请阅读 references/specification.md 和 references/visual-style.md。

工作区模式检测

  • 在 video 工作室内部(存在 AGENTS.md / ./studio 和 studio_style.py):
    • 编辑 projects/<name>/script.md 和 projects/<name>/scenes.py。
    • 导入 from studio_style import *(提供 m、np、暖色调常量 BG、CORAL、TEAL、INK、SAFE_BOTTOM = -2.6、辅助函数 T()、M() 以及 TimedScene)。
    • 继承 TimedScene,将动画与旁白时间戳同步(使用 self.play_line(i, ...)、self.wait_until(...)、self.play_until(...)),保持主要视觉内容在 y > SAFE_BOTTOM 以上,并始终以 self.finish() 结束。
    • 默认引擎为 ManimGX(@manim SceneName)。如果某个场景需要 ManimCE 特有且 GX 不支持的 feature,请在 script.md 中标记 @manim SceneName ce。
  • 独立场景(工作室外部):
    • 使用 import manimgx as m(或 from manimgx import *)用于 ManimGX,或使用 from manim import * 用于 ManimCE。
    • 应用暖色调调色板(#F5F0E8 或 #FFF9F0),并显式设置深色基础文本颜色(#141413 或 #454545),以避免文本和运算符在奶油色背景上显示为不可见的白色。

API 验证(零猜测)

当不确定某个类、方法签名或继承的 Mobject 方法时,请运行 search_api.py(或在 video 工作区内使用 ./studio api):

python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"

如果目标为 ManimCE,请使用 --engine ce。切勿发明参数或猜测未文档化的方法。


阶段 4:快速视觉检查与渲染

切勿仅凭成功退出的返回码就认为工作完成——必须通过视觉检查布局和碰撞。

  • 在 video 工作室中:
    1. 如果 script.md 已更改,运行 ./studio voice <project> 生成 timeline.json。
    2. 运行快速布局与分镜检查(约 1 秒,无需 MP4 编码):
      ./studio inspect <project>
      
      该命令调用 manimgx inspect,标记被裁剪、重叠或过小的标签,在布局错误时以非零退出,并将结果写入 projects/<project>/build/clips/<Scene>.storyboard*.png。
    3. 使用 read_file 打开并视觉检查 *.storyboard*.png,验证对齐、可读性以及 SAFE_BOTTOM 安全距离。
    4. 渲染草稿/最终视频:
      ./studio manim <project> --draft   # 720p 快速检查
      ./studio manim <project>           # 1080p 成品片段
      
  • 独立 ManimGX 脚本:
    manimgx inspect scene.py MainScene -o storyboard.png
    manimgx render scene.py MainScene -o out.mp4
    
  • 独立 ManimCE 脚本:
    manim -ql scene.py MainScene   # 快速草稿
    manim -qh scene.py MainScene   # 1080p60 最终版
    

阶段 5:回溯与布局自我修复

如果渲染或 inspect 失败:

  1. 查阅 references/common-fixes.md 了解 ManimGX 和 ManimCE 的错误模式。
  2. 遇到 AttributeError 或 TypeError 时,使用 <SKILL_DIR>/scripts/search_api.py 查询失败的类/方法(支持 MRO 继承查找)。
  3. 如果 manimgx inspect 生成的分镜图显示标签重叠、边缘被裁剪或对象低于 SAFE_BOTTOM,则调整坐标/锚点或显式执行 FadeOut/exit 以消除残留对象,然后重新运行 inspect 直到干净为止。
  4. 保持核心视觉和数学设计不变——切勿仅仅为了消除错误而删除教育功能。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能