Motion Agent Best Practices

Was macht Motion Agent Best Practices?

Nutzen Sie dies als Routing-Schicht für Motion Agent Arbeiten. Der detaillierte AE-Ausführungsvertrag befindet sich weiterhin im Repository unter skill/SKILL.md; lesen Sie ihn, bevor Sie After Effects berühren.

Kernprinzip

Behandeln Sie Motion Agent nicht als "generiere ein JSX und hoffe." Behandeln Sie es als Produktionsworkflow:

1. Verstehen Sie das Briefing, die Referenz, das Produkt und den Lieferkontext.
2. Wählen Sie den richtigen Workflow-Skill.
3. Erstellen Sie editierbare AE-Strukturen, keine einmaligen Wegwerf-Ebenen.
4. Verifizieren Sie mit aufgenommenen Frames, abgetasteten Werten und konkreten Beweisen.
5. Fördern Sie wiederverwendbare Muster in ein Case oder einen Skill.

Skill-Routing

Benutzer fragt nach	Laden
Ein neues Video, einen Shot, eine Animation oder eine Komposition	motion-create
Launch-Video, Kampagnenfilm, Produktankündigung, Social-Promo	motion-promo-video
UI-Animation, Produktdemo, Dashboard-Fluss, Karten-/Slider-/Bildschirm-Animation	motion-ui-demo
Wiederverwendbare AE-Steuerungen, Ausdrücke, Rigs, Presets, komponentisierte Animation	motion-ae-rig
Überprüfung, Nachbearbeitung, Vergleich, Debugging, Validierung, Abstimmung mit Referenz	motion-qa
Rendern, Exportieren, Vorschau aufnehmen, Lieferung verpacken	motion-render
Repository-Dokumentation, Beispiele, Case-Rezepte, AE-Grundlagen finden	motion-docs

Wenn eine Aufgabe mehrere Bereiche umfasst, laden Sie den kleinsten sinnvollen Satz. Eine Produkt-Launch-Demo benötigt beispielsweise normalerweise motion-promo-video, motion-ui-demo, motion-ae-rig und motion-qa.

Vor der Bearbeitung von AE

Lesen Sie die ursprüngliche skill/SKILL.md des Repositories und führen Sie dann deren Preflight-Checkliste aus. Insbesondere:

• Verwenden Sie ae_scripts/tools/run_jsx.sh für JSX.
• Beachten Sie die ES3-ExtendScript-Grenzen von AE.
• Schlagen Sie Effekt-matchNames nach, anstatt Anzeigenamen zu erraten.
• Behalten Sie eine logische Änderung pro Skript-Batch bei.
• Bewahren Sie Benutzeränderungen und vorhandene Controller-Werte.

Produktionsvertrag

Jedes Motion Agent Ergebnis sollte hinterlassen:

• eine editierbare AE-Projektstruktur
• benannte Steuerungen für wiederholtes Tuning
• Vorschau-Beweise
• eine kurze Notiz, die erklärt, was geändert und was verifiziert wurde
• wiederverwendbare Skripte oder Case-Notizen, wenn das Muster voraussichtlich wiederholt wird

Regeln für editierbare Ausgaben

• Benennen Sie Ebenen, Precomps, Steuerungen, Marker und Ausgabedateien für Menschen.
• Platzieren Sie benutzerorientierte Steuerungen in einer klaren AI_Controls- oder aufgabenspezifischen Steuerungsebene.
• Halten Sie Ausdrücke lesbar und lokalisiert; bevorzugen Sie präzise Bearbeitungen gegenüber vollständigen Neuschreibungen.
• Vermeiden Sie versteckte Magie: Wenn Timing oder Layout generiert werden, machen Sie die wichtigen Stellschrauben zugänglich.
• Reduzieren Sie nicht alles auf eingebrannte Keyframes, es sei denn, der Benutzer wünscht ausdrücklich eine endgültige Ausgabe.

Verifikationsregeln

Bevor Sie "erledigt" sagen, sammeln Sie Beweise:

• erfassen Sie repräsentative Frames
• überprüfen Sie geänderte Ebenen, Ausdrücke oder Controller-Werte
• prüfen Sie Timing/Easing, wenn die Bewegungsqualität wichtig ist
• kontrollieren Sie Textbegrenzungen, Logo-Lesbarkeit und sichere Bereiche der Komposition
• notieren Sie jede nicht verifizierte Annahme

Musterförderung

Wenn sich ein Workflow wiederholt, lassen Sie ihn nicht in einem Chat vergraben:

1. Fügen Sie ein Case unter cases/<category>/<case>/ hinzu oder aktualisieren Sie es.
2. Speichern Sie eine RECIPE.md, wiederverwendbares JSX sowie Vorher-/Nachher-Beweise.
3. Wenn die Regel allgemein nützlich ist, fördern Sie die Kurzversion in skill/SKILL.md oder einen dieser Agent-Skills.
4. Synchronisieren und committen Sie gemäß dem Repository-Workflow.