Communitygithub.com

モーション・レトロスペクティブ

ユーザーがAfter Effectsの作業を最終確認した直後に実行し、すべてのブリッジ操作をリプレイして、再利用可能なレシピ、落とし穴、ルールを抽出し、ケースライブラリとスキル/SKILL.mdに公開します。

モーション・レトロスペクティブ とは?

Motion Retrospectiveスキルは、After Effectsプロジェクトが完了した直後に、エージェントがその制作過程全体を振り返り、将来のセッションで再利用できる知識を抽出するためのツールです。ユーザーが「ship it」や「書き出し完了」などと発言したタイミングで起動し、セッション中に行われたすべてのブリッジ操作(スクリプト実行、コマンドなど)を収集・分析します。 このスキルの主な利点は、成功したテクニックを「レシピ」として構造化し、失敗例とその修正方法を「落とし穴」として記録することで、エージェントの実力を継続的に向上させる点にあります。収集したデータはタイムライン、障害、スクリプトに整理され、最終的には `cases/` ディレクトリ内のカテゴリ別レシピフォルダや `skill/SKILL.md` に反映されます。 Claude Code(MCPベース)や類似のAIエージェントプラットフォーム上で動作し、After Effects用のBridgeツールと連携して使用します。自動公開はリポジトリ所有者の設定(`MOTION_AGENT_AUTO_PUBLISH=1`)に依存し、クライアントアセットやプライベートパスが公開リポジトリに含まれないようにする品質基準を厳守します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itswenxin/motion-agent/tree/HEAD/agent-skills/motion-retrospective

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Motion Retrospective

完成した作品は、エージェントを以前よりも良い状態にしておくべきです。レンダリングが確認されたら、証拠がまだランタイムに残っているうちに(処理済みコマンドは7日後に削除されます)ビルド全体をレビューし、次のセッションで再利用できる知識に変換します。

トリガー

ユーザーが最終的なレンダリング/書き出しを確認した同じターンにこのスキルを開始します。例:「レンダリング完了 / 書き出した / これでOK / ship it / looks good, exporting」。Bridgeはまた、bridgeHealth.retrospective をレンダリングコマンドの結果に追加して、リマインダーとして機能させます。再度促されるのを待ってはいけません。

手順

  1. 収集. セッションの開始時刻をメモし、次を実行します:

    python3 tools/retrospective.py --slug <作品名> --since <セッション開始時刻または例: 6h> [--match "<メインコンポ名>"]
    

    これにより cases/_inbox/<日付>-<スラッグ>/ 内に TIMELINE.md、FAILURES.md、scripts/(正常に実行されたすべての変更スクリプト、重複除去済み)、stats.json が作成されます。

  2. 証拠をキャプチャー. 最終レンダリングから4~6フレームを取得し(captureFrame または tools/run_capture.sh)、tools/sheet.py でコンタクトシートを作成します。evidence/ に保存します。ビデオ、.aep、クライアントのフッテージやフォントは絶対にコミットしないでください。

  3. タイムラインをレビュー. コマンドの実行ごとに以下を書き留めます:

    • ユーザーが求めた内容(会話から)、何が変わったか、どのスクリプトが実行されたか;
    • 見た目だけでなくメカニズム(リグ構造、エクスプレッション、キー値、レイヤー順序);
    • それを機能させた数値(持続時間、イージングの影響、オフセット、サイズ);
    • FAILURES.md のすべての障害: その原因と修正方法。
  4. レシピに分割. 1つの作品には通常、複数の再利用可能なテクニックが含まれます。それぞれに固有のフォルダ cases/<カテゴリ>/<テクニック>/(カテゴリ: text-animation、shape-animation、ui-animation、transitions、effects)を作成し、RECIPE.md、クリーンな再利用可能な .jsx、PROMPT_TEMPLATE.md、および証拠を配置します。cases/projects/<作品>/RECIPE.md にプロジェクトインデックスを保持し、それらをリンクします(例: sync-dubbing-studio)。転送可能な方法からプロジェクト固有のレイヤー名を分離します。

  5. ルールを昇格. この作品を超えて適用されるものはすべて skill/SKILL.md にコピーします: 新しい落とし穴(坑位速查)、新しいユーザーフィードバック翻訳(反馈翻译表)、およびレシピインデックス。LEARNING_MAP.md の項目にチェックを付けるか、項目を追加します。README.md / README.zh-CN.md のケース数とプロジェクトテーブルが変更された場合は更新します。

  6. 公開.

    tools/publish_case.sh cases/<カテゴリ>/<テクニック> "学んだこと" --push
    

    このスクリプトは /Users/<名前>/ パスを除去し、ビデオ/オーディオ/.aepファイルを拒否し、tools/health_check.py を実行し、コミットしてプッシュします。リポジトリ所有者がオプトインした場合(MOTION_AGENT_AUTO_PUBLISH=1、または明示的に要求した場合)のみ自動的にプッシュします。それ以外の場合はコミットして確認を求めます。

  7. 報告 ユーザーに数行で伝えます: 追加されたレシピの数、昇格されたルール、およびコミットリンク。

品質基準

  • レシピはメカニズムを命名し、誰でも再現できる数値を提供すること。
  • すべての落とし穴には、何が壊れたか、なぜか、および修正方法が記載されていること。
  • 公開リポジトリにクライアントアセット、プライベートパス、未公開素材を含めないこと。
  • 作品が新たなことを何も教えなかった場合は、その旨を伝え、既存のケースに証拠のみを追加すること。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル