itswenxin/motion-agent-best-practices

Bonnes pratiques de Motion Agent

Utilisez ceci comme couche de routage pour le travail avec Motion Agent. Le contrat d'exécution AE complet se trouve toujours dans skill/SKILL.md du dépôt ; lisez-le avant de toucher à After Effects.

Principe fondamental

Ne traitez pas Motion Agent comme "générer du JSX et croiser les doigts." Traitez-le comme un flux de production :

1. Comprenez le brief, la référence, le produit et le contexte de livraison.
2. Choisissez la bonne compétence de workflow.
3. Construisez des structures AE modifiables, pas des calques jetables à usage unique.
4. Vérifiez avec des images capturées, des valeurs échantillonnées et des preuves concrètes.
5. Promouvez les motifs récurrents dans un cas ou une compétence.

Routage des compétences

L'utilisateur demande	Charger
Une nouvelle vidéo, prise, animation ou composition	motion-create
Vidéo de lancement, film de campagne, annonce produit, promotion sociale	motion-promo-video
Animation UI, démo produit, flux de tableau de bord, mouvement de carte/curseur/écran	motion-ui-demo
Contrôles AE réutilisables, expressions, rigs, préréglages, motion composantisé	motion-ae-rig
Révision, polissage, comparaison, débogage, validation, faire correspondre à la référence	motion-qa
Rendu, exportation, capture d'aperçu, empaquetage de livraison	motion-render
Trouver la documentation du dépôt, exemples, recettes de cas, fondamentaux AE	motion-docs

Si une tâche couvre plusieurs domaines, chargez le plus petit ensemble utile. Par exemple, une démo de lancement de produit nécessite généralement motion-promo-video, motion-ui-demo, motion-ae-rig et motion-qa.

Avant de modifier AE

Lisez le skill/SKILL.md original du dépôt, puis exécutez sa checklist de prévol. En particulier :

• Utilisez ae_scripts/tools/run_jsx.sh pour le JSX.
• Respectez les limites d'ExtendScript ES3 d'AE.
• Recherchez les matchName des effets au lieu de deviner les noms d'affichage.
• Gardez un changement logique par lot de scripts.
• Préservez les modifications utilisateur et les valeurs de contrôle existantes.

Contrat de production

Chaque résultat de Motion Agent doit laisser :

• une structure de projet AE modifiable
• des contrôles nommés pour un réglage répété
• des preuves d'aperçu
• une courte note expliquant ce qui a changé et ce qui a été vérifié
• des scripts réutilisables ou des notes de cas si le motif est susceptible de se répéter

Règles de sortie modifiable

• Nommez les calques, précompositions, contrôles, marqueurs et fichiers de sortie pour les humains.
• Placez les contrôles destinés à l'utilisateur dans un calque AI_Controls clair ou un calque de contrôle spécifique à la tâche.
• Gardez les expressions lisibles et localisées ; préférez les modifications chirurgicales aux réécritures complètes.
• Évitez la magie cachée : si le timing ou la disposition est généré, exposez les boutons importants.
• Ne réduisez pas tout en images clés figées sauf si l'utilisateur demande explicitement une sortie finale uniquement.

Règles de vérification

Avant de dire "terminé", rassemblez des preuves :

• capturez des images représentatives
• inspectez les calques modifiés, expressions ou valeurs de contrôle
• échantillonnez le timing/lissage lorsque la qualité du mouvement est importante
• vérifiez les limites du texte, la lisibilité du logo et les zones de sécurité de la composition
• enregistrez toute hypothèse non vérifiée

Promotion de motifs

Lorsqu'un workflow se répète, ne le laissez pas enterré dans une conversation :

1. Ajoutez ou mettez à jour un cas dans cases/<catégorie>/<cas>/.
2. Sauvegardez un RECIPE.md, un JSX réutilisable et des preuves avant/après.
3. Si la règle est largement utile, promouvez la version courte dans skill/SKILL.md ou l'une de ces compétences d'agent.
4. Synchronisez et validez selon le workflow du dépôt.