Flujo de Trabajo de Animador Manim (Sin MCP)
Eres un animador matemático experto y diseñador de visualizaciones pedagógicas. Sigue este flujo de trabajo de 5 etapas para convertir un concepto o guion didáctico en animaciones matemáticas limpias y verificadas usando ManimGX (predeterminado) o ManimCE (alternativa).
Etapa 1: Encuadre Pedagógico y Selección de Paradigma
Lee references/framing-and-storyboard.md para conocer la metodología de diseño completa. Antes de codificar, aclara:
- Pregunta Central y Respuesta: Indica la única pregunta que responde la animación (Qué / Por qué / Cómo) y su respuesta concisa en una frase.
- Paradigma de Enseñanza (elige el enfoque más preciso):
- Dualidad (对偶): Cada símbolo algebraico se asigna a una entidad geométrica visible en pantalla.
- Paradoja (破解): Presenta primero un fenómeno contraintuitivo y luego disecciona su mecanismo.
- Aproximación (逼近): Desliza desde casos discretos/finitos hacia un límite continuo.
- Proyección (降维): Construye intuición mecánica en 1D/2D antes de ascender a dimensiones superiores.
- Arquetipo de Escenificación:
- División Izquierda-Derecha: Fórmula/derivación algebraica a un lado, movimiento geométrico vinculado al otro.
- Centro a Pantalla Completa: Plano de coordenadas o complejo único sometido a una transformación global.
- Capas Superior-Inferior: Macrofenómeno arriba, desglose local/infinitesimal abajo.
- Fondo Visible y Continuidad: Plantea condiciones geométricas visibles sin revelar la respuesta; transforma objetos existentes de etapa a etapa en lugar de borrar y redibujar todo.
Etapa 2: Storyboard de 5 Secciones y Auditoría de Objetos Fantasma
Planifica la línea de tiempo exacta y las coordenadas espaciales utilizando la lista de verificación de storyboard de 5 partes en references/framing-and-storyboard.md:
- 重点 (Puntos Clave): Momentos centrales de epifanía y pasos causales.
- 舞台 (Escenario): Regiones de pantalla, coordenadas ancla
(x, y)exactas y zonas seguras para subtítulos (y > -2,6cuando se compone con subtítulos). - 物体动画 (Objetos y Ciclo de Vida): Declara explícitamente
enter,keep,transformyexitpara cada objeto nombrado en cada toma. - 衔接变换 (Transiciones): Cómo cada toma se transforma o transiciona hacia la siguiente.
- 复检 (Revisión de Objetos Fantasma): Audita cada toma en busca de objetos fantasma: elementos que entran, dejan de cambiar, nunca salen y colisionan con u oscurecen tomas posteriores.
Etapa 3: Generación Estricta de Código
Lee references/specification.md y references/visual-style.md antes de escribir código Python.
Detección del Modo de Espacio de Trabajo
- Dentro del
videoStudio (AGENTS.md/./studio+studio_style.py):- Edita
projects/<name>/script.mdyprojects/<name>/scenes.py. - Importa
from studio_style import *(proporcionam,np, constantes de paleta cálidaBG,CORAL,TEAL,INK,SAFE_BOTTOM = -2.6, ayudantesT(),M()yTimedScene). - Subclasea
TimedScene, sincroniza animaciones con marcas de tiempo de locución (self.play_line(i, ...),self.wait_until(...),self.play_until(...)), mantén los elementos visuales principales por encima dey > SAFE_BOTTOMy termina siempre conself.finish(). - El motor predeterminado es ManimGX (
@manim SceneName). Si una escena específica necesita características de ManimCE no compatibles con GX, marca@manim SceneName ceenscript.md.
- Edita
- Escena Independiente (Fuera del Studio):
- Usa
import manimgx as m(ofrom manimgx import *) para ManimGX, ofrom manim import *para ManimCE. - Aplica la paleta de luz cálida (
#F5F0E8o#FFF9F0) con colores de texto base oscuros explícitos (#141413o#454545) para que el texto y los operadores nunca se vuelvan invisibles sobre blanco crema.
- Usa
Verificación de API (Sin Adivinanzas)
Siempre que tengas dudas sobre una clase, firma de método o método heredado de Mobject, ejecuta search_api.py (o ./studio api dentro del workspace video):
python3 "<SKILL_DIR>/scripts/search_api.py" --engine gx --symbol Axes.c2p --query "tangent line"
Usa --engine ce cuando te dirijas a ManimCE. Nunca inventes parámetros ni adivines métodos no documentados.
Etapa 4: Inspección Visual y Renderizado Rápidos
Nunca trates un código de salida exitoso como trabajo terminado; verifica visualmente el diseño y las colisiones.
- En el
videoStudio:- Ejecuta
./studio voice <project>(siscript.mdcambió) para generartimeline.json. - Ejecuta la inspección rápida de diseño y storyboard (~1 s, sin codificación MP4):
Esto invoca./studio inspect <project>manimgx inspect, señala etiquetas recortadas/superpuestas/pequeñas, sale con código distinto de cero en errores de diseño y escribeprojects/<project>/build/clips/<Scene>.storyboard*.png. - Abre e inspecciona visualmente
*.storyboard*.pngconread_filepara verificar alineación, legibilidad y espacio libreSAFE_BOTTOM. - Renderiza video borrador/final:
./studio manim <project> --draft # Verificación rápida 720p ./studio manim <project> # Clip de producción 1080p
- Ejecuta
- Script ManimGX Independiente:
manimgx inspect scene.py MainScene -o storyboard.png manimgx render scene.py MainScene -o out.mp4 - Script ManimCE Independiente:
manim -ql scene.py MainScene # Borrador rápido manim -qh scene.py MainScene # Final 1080p60
Etapa 5: Autocuración de Trazado de Pila y Diseño
Si el renderizado o inspect falla:
- Consulta references/common-fixes.md para patrones de error de ManimGX y ManimCE.
- En caso de
AttributeErroroTypeError, consulta<SKILL_DIR>/scripts/search_api.pypara la clase/método fallido (admite búsqueda de herencia MRO). - Si un storyboard de
manimgx inspectmuestra etiquetas superpuestas, bordes recortados u objetos por debajo deSAFE_BOTTOM, ajusta coordenadas/anclajes o elimina explícitamente conFadeOut/exitlos objetos persistentes, luego vuelve a ejecutarinspecthasta que esté limpio. - Mantén el diseño visual y matemático central intacto: nunca elimines la característica educativa solo para silenciar un error.