itswenxin/motion-agent-best-practices

Mejores Prácticas de Motion Agent

Úselo como la capa de enrutamiento para el trabajo con Motion Agent. El contrato de ejecución profunda de AE aún reside en el archivo skill/SKILL.md del repositorio; léalo antes de tocar After Effects.

Principio Fundamental

No trate a Motion Agent como "generar un JSX y esperar". Trátelo como un flujo de trabajo de producción:

1. Comprenda el brief, la referencia, el producto y el contexto de entrega.
2. Elija el skill de flujo de trabajo correcto.
3. Construya estructuras editables de AE, no capas desechables de un solo uso.
4. Verifique con fotogramas capturados, valores muestreados y evidencia concreta.
5. Promueva patrones reutilizables en un caso o skill.

Enrutamiento de Skills

El usuario pide	Cargar
Un nuevo vídeo, toma, animación o composición	motion-create
Vídeo de lanzamiento, película promocional, anuncio de producto, promo social	motion-promo-video
Animación de UI, demo de producto, flujo de dashboard, animación de tarjeta/control deslizante/pantalla	motion-ui-demo
Controles reutilizables de AE, expresiones, rigs, presets, motion componentizado	motion-ae-rig
Revisar, pulir, comparar, depurar, validar, hacer que coincida con la referencia	motion-qa
Renderizar, exportar, capturar vista previa, empaquetar entrega	motion-render
Encontrar documentación del repositorio, ejemplos, recetas de casos, fundamentos de AE	motion-docs

Si una tarea abarca múltiples áreas, cargue el conjunto más pequeño útil. Por ejemplo, una demo de lanzamiento de producto generalmente necesita motion-promo-video, motion-ui-demo, motion-ae-rig y motion-qa.

Antes de Editar AE

Lea el archivo skill/SKILL.md original del repositorio, luego ejecute su lista de verificación previa. En particular:

• Use ae_scripts/tools/run_jsx.sh para JSX.
• Respete los límites de ExtendScript ES3 de AE.
• Busque los matchName de los efectos en lugar de adivinar nombres de pantalla.
• Mantenga un cambio lógico por lote de script.
• Preserve los cambios del usuario y los valores de control existentes.

Contrato de Producción

Cada resultado de Motion Agent debe dejar:

• una estructura de proyecto de AE editable
• controles nombrados para ajustes repetidos
• evidencia de previsualización
• una nota breve que explique qué cambió y qué se verificó
• scripts reutilizables o notas de caso si es probable que el patrón se repita

Reglas de Salida Editable

• Nombre capas, precomposiciones, controles, marcadores y archivos de salida para humanos.
• Coloque los controles visibles para el usuario en una capa de control clara AI_Controls o específica de la tarea.
• Mantenga las expresiones legibles y localizadas; prefiera ediciones quirúrgicas sobre reescrituras completas.
• Evite la magia oculta: si el tiempo o la disposición se genera, exponga los mandos importantes.
• No colapse todo en fotogramas clave horneados a menos que el usuario solicite explícitamente salida final únicamente.

Reglas de Verificación

Antes de decir "terminado", recopile evidencia:

• capture fotogramas representativos
• inspeccione capas, expresiones o valores de control modificados
• muestree el tiempo/la suavidad cuando la calidad del movimiento sea importante
• verifique los límites del texto, la legibilidad del logotipo y las áreas seguras de la composición
• registre cualquier suposición no verificada

Promoción de Patrones

Cuando un flujo de trabajo se repite, no lo deje enterrado en un chat:

1. Añada o actualice un caso en cases/<categoría>/<caso>/.
2. Guarde un RECIPE.md, JSX reutilizable y evidencia de antes/después.
3. Si la regla es ampliamente útil, promueva la versión corta en skill/SKILL.md o en uno de estos skills de agente.
4. Sincronice y confirme según el flujo de trabajo del repositorio.