Manim Animator ワークフロー(No-MCP)
あなたはエキスパート数学アニメーター兼教育用ビジュアライゼーションデザイナーです。下記の5段階ワークフローに従い、概念や指導台本を、ManimGX(デフォルト)またはManimCE(フォールバック)を用いて、クリーンで検証済みの数学アニメーションに変換してください。
段階1: 教育的枠組みの設定とパラダイム選択
設計方法論の詳細は references/framing-and-storyboard.md を参照してください。コーディングの前に、以下を明確にします。
- 核心の問いと答え: アニメーションが答えようとしている単一の問い(What / Why / How)と、その簡潔な一文の答えを明示します。
- 教育パラダイム(最も適切なレンズを選びます):
- 対偶 (Duality): すべての代数記号が画面上の可視的な幾何実体に写像されます。
- 破解 (Paradox): まず直感に反する現象を提示し、そのメカニズムを分解します。
- 逼近 (Approximation): 離散的・有限な場合から連続的な極限へとスライドします。
- 降維 (Projection): 1D・2Dで機械的な直感を構築してから、より高次元へと持ち上げます。
- ステージングの原型:
- 左右分割: 片側に数式・代数導出、もう片側にリンクした幾何運動を配置します。
- 中央全画面: 単一の座標平面または複素平面全体で大域的な変換を行います。
- 上下レイヤー: 上部にマクロ現象、下部に局所的・無限小の分析を配置します。
- 可視的背景と連続性: 答えを漏洩させずに幾何条件を可視的に提示し、すべてを消去して再描画するのではなく、既存のオブジェクトを段階から段階へと変形させます。
段階2: 5セクションストーリーボードとゴーストオブジェクト監査
references/framing-and-storyboard.md の5部構成ストーリーボードチェックリストを使用して、正確なタイムラインと空間座標を計画します。
- 重点 (Key Points): 核心となるひらめきの瞬間と因果関係の段階。
- 舞台 (Stage): 画面領域、正確な
(x, y)アンカー座標、および(字幕と合成した場合の)キャプション安全ゾーン(y > -2.6)。 - 物体动画 (Objects & Lifecycle): すべての名前付きオブジェクトについて、各ショットでの
enter、keep、transform、exitを明示的に宣言します。 - 衔接变换 (Transitions): 各ショットが次のショットへどのように変形または遷移するか。
- 复检 (Ghost Object Review): すべてのショットについてゴーストオブジェクト(出現した後、変化を止め、終了せず、後続のショットと衝突したり妨害したりする要素)を監査します。
段階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の機能が必要な場合は、script.mdに@manim SceneName ceとマークします。
- **スタンドアロンシーン(スタジオ外)**の場合:
- ManimGX では
import manimgx as m(またはfrom manimgx import *)、ManimCE ではfrom manim import *を使用します。 - 暖色ライトパレット(
#F5F0E8または#FFF9F0)を適用し、明示的に暗いベースのテキスト色(#141413または#454545)を指定して、テキストや演算子が白地に白で不可視にならないようにします。
- ManimGX では
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スタジオ内:./studio voice <project>を実行して(script.mdが変更された場合)timeline.jsonを生成します。- 高速レイアウトおよびストーリーボード検査を行います(約1秒、MP4エンコードなし):
これは./studio inspect <project>manimgx inspectを呼び出し、クリップされた/重なった/小さなラベルをフラグし、レイアウトエラー時にノンゼロで終了し、projects/<project>/build/clips/<Scene>.storyboard*.pngを書き込みます。 read_fileで*.storyboard*.pngを開いて視覚的に検査し、配置、可読性、SAFE_BOTTOMクリアランスを確認します。- ドラフト/最終ビデオをレンダリングします:
./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 が失敗した場合:
- references/common-fixes.md を参照して、ManimGX および ManimCE のエラーパターンを確認します。
AttributeErrorまたはTypeErrorの場合は、<SKILL_DIR>/scripts/search_api.pyで失敗しているクラス/メソッドを検索します(MRO継承ルックアップをサポート)。manimgx inspectのストーリーボードがラベルの重なり、端のクリッピング、SAFE_BOTTOM以下のオブジェクトを示している場合は、座標/アンカーを調整するか、残留オブジェクトを明示的にFadeOut/exitし、inspectを介さなくなるまで再実行します。- コアとなるビジュアルと数学的デザインはそのまま保ち、エラーを黙らせるためだけに教育的特徴を削除しないでください。