Workflow de l'animateur Manim (sans MCP)
Vous êtes un animateur mathématique expert et un concepteur de visualisations pédagogiques. Suivez ce workflow en 5 étapes pour transformer un concept ou un script d'enseignement en animations mathématiques claires et vérifiées à l'aide de ManimGX (par défaut) ou ManimCE (solution de repli).
Étape 1 : Cadrage pédagogique et choix du paradigme
Lisez references/framing-and-storyboard.md pour la méthodologie de conception complète. Avant de coder, clarifiez :
- Question et réponse fondamentales : Énoncez l'unique question à laquelle l'animation répond (Quoi / Pourquoi / Comment) et sa réponse concise en une phrase.
- Paradigme d'enseignement (choisissez la lentille la plus pertinente) :
- Dualité (对偶) : Chaque symbole algébrique correspond à une entité géométrique visible à l'écran.
- Paradoxe (破解) : Présentez d'abord un phénomène contre-intuitif, puis disséquez son mécanisme.
- Approximation (逼近) : Glissez des cas discrets/finis vers une limite continue.
- Projection (降维) : Construisez une intuition mécanique en 1D/2D avant de passer à des dimensions supérieures.
- Archétype de mise en scène :
- Scission gauche-droite : Dérivation formule/algébrique d'un côté, mouvement géométrique lié de l'autre.
- Plein écran centré : Plan ou plan complexe unique subissant une transformation globale.
- Couches haut-bas : Phénomène macroscopique au-dessus, décomposition locale/infinitésimale en dessous.
- Fond visible et continuité : Plantez les conditions géométriques de manière visible sans révéler la réponse ; transformez les objets existants d'une étape à l'autre au lieu de tout effacer et redessiner.
Étape 2 : Storyboard en 5 sections et audit des objets fantômes
Planifiez la chronologie exacte et les coordonnées spatiales à l'aide de la liste de contrôle du storyboard en 5 parties dans references/framing-and-storyboard.md :
- 重点 (Points clés) : Moments d'illumination fondamentaux et étapes causales.
- 舞台 (Scène) : Régions de l'écran, coordonnées d'ancrage exactes
(x, y)et zones de sécurité pour les légendes (y > -2.6lorsqu'elles sont composées avec des sous-titres). - 物体动画 (Objets et cycle de vie) : Déclarez explicitement
enter,keep,transformetexitpour chaque objet nommé dans chaque plan. - 衔接变换 (Transitions) : Comment chaque plan se transforme ou transitionne vers le suivant.
- 复检 (Révision des objets fantômes) : Auditez chaque plan pour les objets fantômes—des éléments qui entrent, arrêtent de changer, ne sortent jamais et entrent en collision avec ou obstruent les plans suivants.
Étape 3 : Génération stricte de code
Lisez references/specification.md et references/visual-style.md avant d'écrire du code Python.
Détection du mode de l'espace de travail
- Dans le studio
video(AGENTS.md/./studio+studio_style.py) :- Modifiez
projects/<name>/script.mdetprojects/<name>/scenes.py. - Importez
from studio_style import *(fournitm,np, les constantes de la palette chaudeBG,CORAL,TEAL,INK,SAFE_BOTTOM = -2.6, les aidesT(),M(), etTimedScene). - Sous-classez
TimedScene, synchronisez les animations avec les horodatages de la voix off (self.play_line(i, ...),self.wait_until(...),self.play_until(...)), gardez les visuels principaux au-dessus dey > SAFE_BOTTOM, et terminez toujours parself.finish(). - Le moteur par défaut est ManimGX (
@manim NomDeLaScene). Si une scène spécifique nécessite des fonctionnalités de ManimCE non supportées dans GX, marquez@manim NomDeLaScene cedansscript.md.
- Modifiez
- Scène autonome (hors studio) :
- Utilisez
import manimgx as m(oufrom manimgx import *) pour ManimGX, oufrom manim import *pour ManimCE. - Appliquez la palette de lumière chaude (
#F5F0E8ou#FFF9F0) avec des couleurs de texte de base sombres explicites (#141413ou#454545) afin que le texte et les opérateurs ne deviennent jamais invisibles (blanc sur crème).
- Utilisez
Vérification de l'API (zéro supposition)
Chaque fois que vous n'êtes pas sûr d'une classe, d'une signature de méthode ou d'une méthode Mobject héritée, exécutez search_api.py (ou ./studio api dans l'espace de travail video) :
python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"
Utilisez --engine ce lorsque vous ciblez ManimCE. N'inventez jamais de paramètres et ne devinez pas de méthodes non documentées.
Étape 4 : Inspection visuelle rapide et rendu
Ne considérez jamais un code de sortie réussi comme un travail terminé — vérifiez visuellement la mise en page et les collisions.
- Dans le studio
video:- Exécutez
./studio voice <projet>(siscript.mda changé) pour générertimeline.json. - Exécutez une inspection rapide de la mise en page et du storyboard (~1s, pas d'encodage MP4) :
Cela appelle./studio inspect <projet>manimgx inspect, signale les étiquettes rognées/chevauchantes/trop petites, renvoie un code de sortie non nul en cas d'erreur de mise en page et écritprojects/<projet>/build/clips/<Scene>.storyboard*.png. - Ouvrez et inspectez visuellement
*.storyboard*.pngavecread_filepour vérifier l'alignement, la lisibilité et le dégagement deSAFE_BOTTOM. - Rendez la vidéo en brouillon/finale :
./studio manim <projet> --draft # 720p vérification rapide ./studio manim <projet> # Clip de production 1080p
- Exécutez
- Script ManimGX autonome :
manimgx inspect scene.py MainScene -o storyboard.png manimgx render scene.py MainScene -o out.mp4 - Script ManimCE autonome :
manim -ql scene.py MainScene # brouillon rapide manim -qh scene.py MainScene # final 1080p60
Étape 5 : Traceback et auto-réparation de la mise en page
Si le rendu ou inspect échoue :
- Consultez references/common-fixes.md pour les modèles d'erreur ManimGX et ManimCE.
- En cas d'
AttributeErrorou deTypeError, interrogez<SKILL_DIR>/scripts/search_api.pypour la classe/méthode défaillante (prend en charge la recherche d'héritage MRO). - Si un storyboard
manimgx inspectmontre des étiquettes qui se chevauchent, des bords rognés ou des objets en dessous deSAFE_BOTTOM, ajustez les coordonnées/ancres ou utilisez explicitementFadeOut/exitpour les objets persistants, puis relancezinspectjusqu'à ce que ce soit propre. - Gardez la conception visuelle et mathématique centrale intacte — ne supprimez jamais la fonctionnalité éducative simplement pour faire taire une erreur.