Communitygithub.com

MSP — Manim スタイル&プロトコル

AIエージェントが、Manimアニメーションの計画、構築、編集を行う際の手順を示します。出力はすぐに使えるコードまたはスクリプトになります。このスキルは、プロダクション品質のManimアニメーションを生成するための仕様に基づいています。新しいプロジェクトでこのスキルが必要な場合に使用します。

MSP — Manim スタイル&プロトコル とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が、Manim Community Edition (ManimCE) v0.18以上を使用して、プロフェッショナルなアニメーションスタジオ品質のManimアニメーションを生成するための包括的なプロトコルとスタイルガイドを提供します。主な特徴として、「0. PRIME DIRECTIVE」で常に意図的で洗練された選択をすることを徹底し、「4. モーフィング&トランスフォームプロトコル」でオブジェクトをカットなしにスムーズに変形させるテクニックを規定します。また、ファイル構造、テーマ管理、レイアウト、タイミング、イージング、カメラワーク、レンダリング設定に至るまで、プロダクション品質のアニメーション制作に必要なルールとベストプラクティスを詳細に定義しています。このスキルを参照することで、AIは単なるスニペットの生成ではなく、一貫性があり、視覚的に美しく、編集可能な本格的なアニメーション作品を生み出すことが可能になります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Frqme21/MSP-Manim-Style-protocol/tree/HEAD/v1

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

MSP — Manim スタイル&プロトコル は何をしますか?

AI生成Manimアニメーションのためのプロダクション品質スキル仕様

Version: 1.0
Target: Manim Community Edition (ManimCE) ≥ v0.18
Purpose: あらゆるAIシステムが、例外ではなくデフォルトで、クリーンで整理された、スムーズにモーフィングする、スタジオ/プロダクション品質のManimアニメーションを生成できるようにする。

0. 最優先指令

あなたが書くすべてのシーンは、学生のスクリプトではなく、プロのアニメーションスタジオから来たように見えなければなりません。選択に迷った場合は、最も滑らかで、クリーンで、意図的なオプションを選択してください。決して最も怠惰なデフォルトを選ばないでください。

コードを書く前に、静かにこのチェックリストを実行してください:

  1. このシーンが伝える1つのアイデアは何ですか?
  2. 視覚的階層は何ですか?(目が最初、次に、3番目に見るべきものは?)
  3. 使用しているカラーパレットとフォントは何ですか?プロジェクト全体で一貫していますか?
  4. 各オブジェクトはどのように登場し、変形し、退場しますか? — アニメーションフックなしに単に「出現」または「消滅」してはいけません。
  5. シーンのペーシング(合計run_time予算)はどのくらいですか?

1. 環境とバージョンロック

ユーザーが明示的に3b1bスタイルのManimGLを要求しない限り、常にManim Community Editionをデフォルトとし、ManimGLは使用しないでください。

from manim import *
  • CLIバイナリ: manim (manimgl ではありません)
  • 生成動詞: Create() (ShowCreation() ではありません)
  • 数式レンダリング: MathTex(r"...") (Tex(R"...") ではありません)

APIを混在させないでください。 スニペットが MovingCameraScene/ThreeDScene なしで self.camera.frame を使用している場合、それをフラグしてください — それはManimGLの構文が混入しています。


2. プロジェクトファイル構造

単一の些細なシーンを超えるものについては、この構造を強制します — すべてを1つのモノリシックファイルにダンプしないでください:

project/
├── manim.cfg              # レンダリング設定を固定(§9参照)
├── theme.py               # 色、フォント、定数(唯一の情報源)
├── helpers.py             # 再利用可能な mobject ビルダー / レイアウト関数
├── scenes/
│   ├── 01_intro.py
│   ├── 02_derivation.py
│   └── 03_outro.py
└── assets/                # svg, 画像, 音声

theme.py の例(マルチシーンプロジェクトでは常に作成してください):

from manim import *

# ---- パレット ----
BG_COLOR      = "#0E0E12"
PRIMARY       = "#58C4DD"   # manim デフォルトの青、またはブランドカラー
SECONDARY     = "#FFD166"
ACCENT        = "#EF476F"
TEXT_MAIN     = "#F5F5F5"
TEXT_MUTED    = "#8A8A8F"
SUCCESS       = "#06D6A0"

# ---- タイポグラフィ ----
FONT_MAIN = "Helvetica"      # またはプロジェクト固有のもの
FONT_MONO = "JetBrains Mono"

# ---- タイミング定数 ----
T_FAST   = 0.5
T_NORMAL = 1.0
T_SLOW   = 1.8
LAG      = 0.08   # グループ表示のデフォルト lag_ratio

config.background_color = BG_COLOR

すべてのシーンファイルは theme.py からインポートします。テーマファイルが存在する場合、インラインで16進数の色コードやマジックナンバーのrun_timeをハードコードしないでください — これはプロフェッショナルでなく一貫性のない出力を示す #1 の指標です。


3. ビジュアルデザイン標準

3.1 色のルール

  • プロジェクトあたり最大4~5色(背景1色、主要1~2色、アクセント1~2色)。それ以上はノイズが多くアマチュア的に見えます。
  • 色を意味的に使用してください: 同じ色は動画全体で同じ意味を持ちます(例: 「与えられたもの」には常に青、「未知のもの」には常に赤)。
  • 背景はほぼ純粋な黒 (#000000) や純粋な白にすべきではありません — 目の疲れを軽減し「スタジオ」感を出すために、ソフトなニアブラック (#0E0E12) またはソフトなオフホワイトを使用してください。

3.2 タイポグラフィのルール

  • UIラベル、タイトル、キャプションには Text() を使用 — 高速で、LaTeXの依存関係はありません。
  • すべての数学的表記には MathTex() を使用 — Text() で数学を偽装しないでください。
  • Tex() は、散文と数式が混在するLaTeXブロックにのみ使用します。
  • テーマ定数を介してグローバルに font= を1つ設定します。フォントの選択をシーンごとに変えさせないでください。
  • タイトルの規則: .to_edge(UP)、太字、すべてのシーンで一貫したフォントサイズ(例: 40pt)。

3.3 レイアウトのルール

  • 三分割法を尊重してください — デフォルトですべてを中央に配置するのは避け、.to_edge()、.shift()、.next_to() を意図的に使用します。
  • 一貫したマージン(buff値)を維持します — MARGIN = 0.75 定数を定義し、すべての .to_edge(..., buff=MARGIN) 呼び出しで再利用します。
  • 関連するオブジェクトを単一の VGroup にグループ化し、個々のmobjectではなくグループを配置/アニメーション化します — これにより、後で変換を行っても配置が正しく保たれます。
  • 座標を手動で計算する代わりに、グループに対して常に .arrange() または .arrange_in_grid() を呼び出します — 手動の座標計算は脆弱であり、後で編集したときにレイアウトが壊れる原因の第1位です。

4. モーフィング&トランスフォームプロトコル

これは「スムーズでモーフィングする」アニメーションの核心です — ハイエンドの説明ビデオの特徴的な外観です。

4.1 ルール: 決してカットせず、常にトランスフォームする

あるオブジェクトが概念的に別のオブジェクトになる場合(数式が再構成される、図形が別の図形になる、ラベルが更新される)、別々の無関係なmobjectとして FadeOut + FadeIn を決して行わないでください — これはジャンプカットのように見えます。常にトランスフォームファミリーを使用してください:

状況正しいツール
数式が再構成され、項が残るTransformMatchingTex(old, new)
図形が別の図形にモーフィングするTransform(old, new) または ReplacementTransform(old, new)
mobjectのグループが再構成される(例: 箇条書き → 図)TransformMatchingShapes(old_group, new_group)
あるオブジェクトがシーングラフ内で別のオブジェクトを明示的に置き換えるReplacementTransform (self.mobjects 内の古いものを新しいものと交換する)
連続性を暗示しながらフェードする(例: ゴースト/オーバーレイ)FadeTransform(old, new)

TransformMatchingTex のプロトコル詳細: 常に両方の MathTex mobjectを一貫したサブ文字列グループ(別々の {} グループとして同じLaTeXフラグメント)で構築し、Manimが同一のシンボルをマッチできるようにします — これにより、項がクロスフェードではなく新しい位置に視覚的に「スライド」します。

eq1 = MathTex("a", "+", "b", "=", "c")
eq2 = MathTex("c", "=", "a", "+", "b")
self.play(TransformMatchingTex(eq1, eq2), run_time=1.2)

4.2 ルール: 単純なプロパティモーフには .animate を使用する

1つのmobjectに対する単一の連続的なプロパティ変更(位置、スケール、色、回転)には、.animate 構文を優先します — よりクリーンで、Manimが自動的に正味のトランスフォームを補間します:

self.play(square.animate.shift(RIGHT * 2).scale(1.5).set_color(ACCENT), run_time=1.0)

注意(重要、AIの幻覚バグを回避するため): チェーンされた .animate 呼び出しは、各中間ステップを順次補間するのではなく、最終的な正味の状態を補間します。中間結果に依存する .animate 呼び出しをチェーンしないでください(例: .animate.move_to(X).rotate(angle_depending_on_position)) — 代わりに個別の self.play() 呼び出しに分割してください。

4.3 ルール: 連続的/従属的なモーションには Updater を使用する

オブジェクトの状態が別のオブジェクトを連続的に追跡する必要がある場合(ドットに従うラベル、ValueTracker を追跡する値表示)、フレームごとに手動で play し直すのではなく、add_updater を使用してください:

tracker = ValueTracker(0)
label = DecimalNumber(0).add_updater(lambda d: d.set_value(tracker.get_value()))
dot = Dot().add_updater(lambda m: m.move_to(axes.c2p(tracker.get_value(), f(tracker.get_value()))))
self.add(label, dot)
self.play(tracker.animate.set_value(5), run_time=3, rate_func=linear)

オブジェクトの依存フェーズが終了したら、常に remove_updater を呼び出すか(またはクリーンな再計算ロジックのために always_redraw を使用)、長いシーンで後で古いアップデータのバグが発生するのを避けてください。


5. タイミング、ペーシング&イージングプロトコル

5.1 デフォルトレート関数ポリシー

  • デフォルト(オーバーライドしない): smooth — S字カーブのイーズイン/イーズアウト。アニメーションの90%に使用 — 数式の表示、図形の作成、標準的な動き。
  • linear: 文字通りの一定速度の物理的な動きを描写するものには必須 — 軌道上のドット、等速ベクトル、回転する時計の針、実際の経過時間に結びついたプログレスバー。
  • rush_into / rush_from: 何かが所定の位置にはめ込まれたり、飛び去ったりする感じを出すべき強調の登場/退場に使用します。
  • there_and_back / there_and_back_with_pause: Indicate スタイルの注意パルスに使用します。永続的な状態変更には決して使用しないでください。
  • ease_out_bounce / ease_out_elastic: 遊び心のあるインフォーマルなコンテンツのみに予約してください。形式的な数学/科学の導出では決して使用しないでください。プロフェッショナルらしくなくなります。

5.2 タイミング予算のルール

  • 個々の run_time は 0.4秒~3秒 の間に保ちます。0.4秒未満は耳障りに感じられ、3秒を超えると(物語上の理由がなければ)間が延びます。
  • タイトル/セクションヘッダーの登場: 0.8~1.2秒。
  • 数式/図のトランスフォーム: 1.0~1.5秒。
  • 強調パルス (Indicate, Flash, Circumscribe): 0.5~0.8秒。
  • カメラの動き (move_camera, self.camera.frame.animate): 1.5~3秒 — これより速いカメラの動きは吐き気を催させます。
  • 主要な表示の後には、意図的に self.wait(0.3~1.0) の休止を挿入します — 決して self.play() 呼び出しを休止なしに連続して実行しないでください。視聴者を圧倒します。

5.3 構成プロトコル

  • 同時だが独立したイベント → 単一の self.play(AnimA, AnimB, ...) 呼び出し。
  • 開始時間がずれた同時イベント(例: 6つの箇条書きが順番に重なって表示される) → LaggedStart(*anims, lag_ratio=0.15)。
  • 厳密に順次、依存したイベント → Succession(*anims) または個別の self.play() 呼び出し。
  • リスト/グリッド表示(箇条書き、図形のグリッド) → 単一の同時 FadeIn(group) ではなく、常に LaggedStartMap(FadeIn, group, lag_ratio=0.08, shift=UP*0.3) — ずらすことで、グループの登場がロボット的ではなく有機的に感じられます。

6. シーンとコードの構成プロトコル

6.1 Construct メソッドの形状

常に construct() を、コメントまたはヘルパーメソッドを介して明確に区切られた名前付きフェーズに分解します — 決して途切れのない100行のブロックにしないでください:

class DerivationScene(Scene):
    def construct(self):
        self.setup_title()
        self.show_initial_equation()
        self.derive_steps()
        self.highlight_result()
        self.cleanup()

    def setup_title(self):
        self.title = Text("Deriving the Quadratic Formula", font=FONT_MAIN).to_edge(UP)
        self.play(Write(self.title), run_time=T_NORMAL)
        self.wait(T_FAST)

    def show_initial_equation(self):
        ...

長い動画の場合は、1つの巨大な construct() ではなく、複数のシーンクラス(論理セクションごとに1つ)に分割します — -n を使用したターゲット再レンダリングと並列イテレーションが可能になります。

6.2 Mobject 構築プロトコル

  • 複雑なカスタムビジュアル(図、グラフ、アイコン)は、construct() にインラインで記述するのではなく、VGroup を返す helpers.py の独立した関数として構築します:
# helpers.py
def make_neuron(radius=0.3, color=PRIMARY) -> VGroup:
    circle = Circle(radius=radius, color=color, fill_opacity=0.8)
    label = Text("n", font_size=20).move_to(circle)
    return VGroup(circle, label)
  • mobjectには常に意味のある名前を付けます (title, eq_initial, graph_group) — 後で変更またはトランスフォームする必要がある、参照されていない無名リテラルを残さないでください。
  • 重なり合うレイヤーがあるシーンでは、明示的に z_index を使用します(2つ以上のレイヤーが存在する場合、追加順序だけに依存しないでください)。

6.3 スタイル / リンティングルール

  • 変数/メソッドはスネークケース、Sceneサブクラスはパスカルケース。
  • コードの可読性のために、アニメーションの「ビート」間に1行の空行を入れます — コード構造はビデオのペーシングを視覚的に反映する必要があります。
  • 色/位置/タイミングにベアのマジックナンバーは使用しないでください — 常に theme.py の定数を参照します。
  • 大規模プロジェクトの保守性のために、ヘルパー関数に型ヒントを付けます(def make_axes() -> Axes:)。

7. 構図とカメラプロトコル(2D & 3D)

2D

  • ビデオが2Dでパン/ズームする必要がある場合(例: 図のサブ領域に焦点を当てる)は MovingCameraScene を使用します — self.camera.frame.animate.move_to(...).set(width=...) を介してアニメーション化し、常に明示的な run_time を指定します。

3D

  • ThreeDScene をサブクラス化します。
  • 専用のセットアップステップで self.set_camera_orientation(phi=70*DEGREES, theta=-45*DEGREES, zoom=1) を使用して初期方向を設定します — 意図的でない限り、デフォルトの方向のままにしないでください。
  • 視聴者が動きとして知覚するはずのカメラの再配置には、self.move_camera(phi=..., theta=..., run_time=2.5) を使用してください — シーンの中で set_camera_orientation でジャンプカットをしないでください。
  • ナレーション中のゆっくりとしたアイドル回転には self.begin_ambient_camera_rotation(rate=0.15) を使用します。その後、意図的な move_camera の前に、常に self.stop_ambient_camera_rotation() とペアにします。
  • カメラアングルに関係なく読みやすい状態を保つ必要があるHUD/ラベル/タイトル → self.add_fixed_in_frame_mobjects(label)。
  • 3Dオブジェクトを追跡するが読みやすい状態を保つ必要があるラベル → self.add_fixed_orientation_mobjects(label)。
  • 3Dサーフェスの resolution タプルは、イテレーション中は低く(例: (24,24))保ちます。最終的なプロダクションレンダリングのためだけに引き上げます — これは純粋にパフォーマンス/ワークフローのルールであり、視覚的なルールではありません。

8. 強調と注意プロトコル

重要な結果を、サポートコンテンツと視覚的に同じように見せたままにしないでください。シーンの「見せ場」(最終的な数式、重要な洞察、結果)を表示した後、正確に1つの強調テクニックを適用します — 複数スタックすると必死に見えるので、1つ以上は使用しないでください:

  • Circumscribe(mobject, color=ACCENT, run_time=1.2) — その周りに図形を描画します。
  • Indicate(mobject, scale_factor=1.15) — 短いパルススケール + カラーフラッシュ。
  • Flash(point, color=ACCENT) — 放射状バースト、特定の座標/交点に適しています。
  • mobject.animate.set_color(ACCENT) をわずかなスケールと組み合わせる — 「これが答えである」ことを示す永続的な色の変更に。

9. レンダリングとエクスポートプロトコル

9.1 設定ファイルの固定(これをコミットしてください — 最終納品のためにアドホックなフラグに依存しないでください)

manim.cfg:

[CLI]
quality = production_quality
preview = False
background_color = "#0E0E12"
output_file = {scene_name}
frame_rate = 60
pixel_height = 1080
pixel_width = 1920

9.2 ワークフローステージ(常にこの順序に従ってください。決して最初から最終品質でレンダリングしないでください)

  1. 下書きパス: manim -pql scenes/02_derivation.py DerivationScene — 高速イテレーション、ロジック/タイミングを確認。
  2. スポットチェックパス: manim -pqh -s scenes/02_derivation.py DerivationScene — 構図/色の単一フレーム高品質チェック。
  3. 最終レンダリングパス: manim -pqh scenes/02_derivation.py DerivationScene — 完全な高品質レンダリング。-a フラグを manim.cfg で指定しない限り使用しないでください。

9.3 メディア管理

  • 毎回 manim cache clean を実行して、確実にアーティファクト(特にキャッシュされたSVG/TeXレンダリング)をクリアしてから、最終プロダクションを提出してください。
  • シーンを特定するために出力ファイル名を {project_name}_{scene_name}.mp4 のようにしてください。
  • プロダクションの提出物は media/ から releases/ に移動し、そこから削除しないでください。

10. デバッグ&フォールバックプロトコル

10.1 Manimの一般的なAI生成エラー

このチェックリストを常に頭の中に入れておいてください:

  • ❌ screen_width/screen_height — Manimには存在しません。config.frame_width/config.frame_height を使用するか、設定を書き換えてください。
  • ❌ ShowCreation — ManimCEでは削除されました。Create を使用してください。
  • ❌ Text 内での alignment — alignment は Paragraph クラスにあります。text_align ではありません。justify も使用しないでください。単一の Text オブジェクトは常に左揃えです。複数行のテキストブロックには MarkupText を使用してください。
  • ❌ Play における submobjects_mode — Scene.play() には存在しません。LaggedStart を使用してずらしてください。
  • ❌ set_color_by_gradient を Mobject に直接 — ManimCE v0.18+では、color パラメータにタプルを渡す必要があります: Circle(color=(RED, BLUE))。set_color_by_gradient は VMobject のサブクラスでのみ利用可能です。
  • ❌ Write で非テキストmobject — Write は Text/MathTex/Tex 用に設計されています。図形には Create、FadeIn、DrawBorderThenFill を使用してください。
  • ❌ 旧式の get_center() の代わりに point プロパティを使用している — 正しい: mobject.get_center()、mobject.get_left()、mobject.get_corner(UL) など。mobject.point は存在しません。

10.2 非互換性が疑われる場合のフォールバック

ManimCEバージョンが不明または疑わしい場合:

  1. pip show manim | grep Version を実行してバージョンを確認します。
  2. v0.18未満の場合は、from manim import * の代わりに from manimlib import * を使用してください。
  3. それでもエラーが発生する場合は、Create ではなく FadeIn でフォールバックし、複雑なトランスフォームを避けてください。

付録A: 品質チェックリスト(AI自己チェック用)

各シーンを生成した後、AIシステムはコードを検査し、以下のすべてが真であることを確認する必要があります:

#チェック合格/不合格
1すべてのmobjectにアニメーション動詞が付属していますか?(FadeIn、Create、Write、Transform — 生の self.add() ではありませんか?)
2カラーコードとrun_timeはすべてテーマファイルから来ていますか?(インラインのマジックナンバーはありませんか?)
3オブジェクトが別のオブジェクトになる場合、FadeOut + FadeIn ではなくトランスフォームを使用していますか?
4タイトルとラベルは一貫したフォント、サイズ、位置を使用していますか?
5各主要な表示の後に短い self.wait() がありますか?
6グループ化されたエンティティ(VGroup)は、分離されたmobjectではなく、単位として配置/アニメーション化されていますか?
7複数のアニメーションが重なる場合、正しい構成ツールを使用していますか(LaggedStart、Succession、単一の self.play 引数リスト)?
82Dパン/ズームが必要なシーンで MovingCameraScene を使用していますか?(または3Dのために ThreeDScene?)

付録B: クイックリファレンスカード(プロンプトインジェクション用)

以下は、フォローアップの会話でこの仕様全体を再送信しなくても、コアプロトコルを強制するために、AIエージェントのシステムプロンプトに直接注入できる短縮版です:

[MSP-CORE] ManimCE ≥0.18. 常に `from manim import *` を使用します。
非テキストの出現には `Create` / `FadeIn`、Texには `Write` を使用します。
テーマ定数(`theme.py`)を常に使用します — ハードコードされた色やタイミングはありません。
オブジェクトが別のオブジェクトになる場合はトランスフォームします(`TransformMatchingTex`、`ReplacementTransform`)。
カットしないでください。表示、トランスフォーム、強調(`Indicate` / `Circumscribe`)、そして休止です。
レート関数: 通常は `smooth`、等速モーションには `linear`。`run_time` は0.4〜3秒。
`LaggedStart` でリストをずらし、`VGroup` で配置します。
手動の座標は避けてください — `arrange` / `next_to` / `shift` / `to_edge` を使用します。
APIを混在させないでください — これはManimCEでありManimGLではありません。
疑問がある場合は、最もスムーズで意図的な選択をしてください。

関連スキル