Motion Agent ベストプラクティス は何をしますか？
これはMotion Agent作業のルーティングレイヤーとして使用します。詳細なAE実行契約はリポジトリの skill/SKILL.md にあります。After Effectsに触れる前に必ずそれを読んでください。
核となる原則
Motion Agentを「JSXを生成して運任せ」として扱わないでください。プロダクションワークフローとして扱います：
- ブリーフ、参考資料、製品、納品コンテキストを理解する。
- 適切なワークフロースキルを選択する。
- 編集可能なAE構造を構築し、使い捨てのレイヤーは作らない。
- キャプチャしたフレーム、サンプリングした値、具体的なエビデンスで検証する。
- 再利用可能なパターンをケースまたはスキルに昇格させる。
スキルルーティング
| ユーザーが依頼する内容 | 読み込むスキル |
|---|---|
| 新しい動画、ショット、アニメーション、コンポジション | motion-create |
| ローンチ動画、キャンペーンフィルム、製品告知、ソーシャルプロモ | motion-promo-video |
| UIアニメーション、製品デモ、ダッシュボードフロー、カード/スライダー/画面のモーション | motion-ui-demo |
| 再利用可能なAEコントロール、エクスプレッション、リグ、プリセット、コンポーネント化されたモーション | motion-ae-rig |
| レビュー、ブラッシュアップ、比較、デバッグ、検証、参考に合わせる | motion-qa |
| レンダリング、書き出し、プレビューキャプチャ、納品パッケージング | motion-render |
| リポジトリのドキュメント、サンプル、ケースレシピ、AE基礎知識の検索 | motion-docs |
タスクが複数の領域にまたがる場合は、最小限の有用なセットを読み込んでください。たとえば、製品ローンチデモでは通常 motion-promo-video、motion-ui-demo、motion-ae-rig、motion-qa が必要です。
AE編集前
リポジトリのオリジナル skill/SKILL.md を読み、その事前チェックリストを実行してください。特に：
- JSXには
ae_scripts/tools/run_jsx.shを使用する。 - AEのES3 ExtendScriptの制限を尊重する。
- エフェクトの
matchNameを調べ、表示名を推測しない。 - スクリプトのバッチごとに論理的な変更を1つに保つ。
- ユーザーの変更や既存のコントローラー値を保持する。
制作契約
すべてのMotion Agentの結果は、以下を残す必要があります：
- 編集可能なAEプロジェクト構造
- 繰り返し調整するための名前付きコントロール
- プレビューのエビデンス
- 何が変更され、何が検証されたかを説明する短いメモ
- パターンが繰り返されそうな場合の再利用可能なスクリプトまたはケースノート
編集可能な出力ルール
- レイヤー、プリコンポ、コントロール、マーカー、出力ファイルには人間が理解できる名前を付ける。
- ユーザー向けのコントロールは、明確な
AI_Controlsまたはタスク固有のコントロールレイヤーに配置する。 - エクスプレッションは読みやすくローカライズされた状態を保ち、全面書き換えよりも外科的な編集を優先する。
- 隠れたマジックを避ける：タイミングやレイアウトが生成される場合は、重要な調整つまみを露出する。
- ユーザーが明示的に最終出力のみを要求しない限り、すべてをベイクされたキーフレームに押し込まない。
検証ルール
「完了」と言う前に、エビデンスを収集する：
- 代表的なフレームをキャプチャする
- 変更されたレイヤー、エクスプレッション、コントローラー値を検査する
- モーションの品質が重要な場合はタイミング/イージングをサンプリングする
- テキストのバウンディングボックス、ロゴの可読性、コンポジションのセーフエリアを確認する
- 未検証の仮定を記録する
パターンの昇格
ワークフローが繰り返される場合、チャット内に埋めないでください：
cases/<category>/<case>/の下にケースを追加または更新する。RECIPE.md、再利用可能なJSX、およびbefore/afterのエビデンスを保存する。- ルールが広く役立つ場合は、短いバージョンを
skill/SKILL.mdまたはこれらのエージェントスキルのいずれかに昇格させる。 - リポジトリのワークフローに従って同期しコミットする。