Motion Retrospective
完成した作品は、エージェントを以前よりも良い状態にしておくべきです。レンダリングが確認されたら、証拠がまだランタイムに残っているうちに(処理済みコマンドは7日後に削除されます)ビルド全体をレビューし、次のセッションで再利用できる知識に変換します。
トリガー
ユーザーが最終的なレンダリング/書き出しを確認した同じターンにこのスキルを開始します。例:「レンダリング完了 / 書き出した / これでOK / ship it / looks good, exporting」。Bridgeはまた、bridgeHealth.retrospective をレンダリングコマンドの結果に追加して、リマインダーとして機能させます。再度促されるのを待ってはいけません。
手順
-
収集. セッションの開始時刻をメモし、次を実行します:
python3 tools/retrospective.py --slug <作品名> --since <セッション開始時刻または例: 6h> [--match "<メインコンポ名>"]これにより
cases/_inbox/<日付>-<スラッグ>/内にTIMELINE.md、FAILURES.md、scripts/(正常に実行されたすべての変更スクリプト、重複除去済み)、stats.jsonが作成されます。 -
証拠をキャプチャー. 最終レンダリングから4~6フレームを取得し(
captureFrameまたはtools/run_capture.sh)、tools/sheet.pyでコンタクトシートを作成します。evidence/に保存します。ビデオ、.aep、クライアントのフッテージやフォントは絶対にコミットしないでください。 -
タイムラインをレビュー. コマンドの実行ごとに以下を書き留めます:
- ユーザーが求めた内容(会話から)、何が変わったか、どのスクリプトが実行されたか;
- 見た目だけでなくメカニズム(リグ構造、エクスプレッション、キー値、レイヤー順序);
- それを機能させた数値(持続時間、イージングの影響、オフセット、サイズ);
FAILURES.mdのすべての障害: その原因と修正方法。
-
レシピに分割. 1つの作品には通常、複数の再利用可能なテクニックが含まれます。それぞれに固有のフォルダ
cases/<カテゴリ>/<テクニック>/(カテゴリ: text-animation、shape-animation、ui-animation、transitions、effects)を作成し、RECIPE.md、クリーンな再利用可能な.jsx、PROMPT_TEMPLATE.md、および証拠を配置します。cases/projects/<作品>/RECIPE.mdにプロジェクトインデックスを保持し、それらをリンクします(例:sync-dubbing-studio)。転送可能な方法からプロジェクト固有のレイヤー名を分離します。 -
ルールを昇格. この作品を超えて適用されるものはすべて
skill/SKILL.mdにコピーします: 新しい落とし穴(坑位速查)、新しいユーザーフィードバック翻訳(反馈翻译表)、およびレシピインデックス。LEARNING_MAP.mdの項目にチェックを付けるか、項目を追加します。README.md/README.zh-CN.mdのケース数とプロジェクトテーブルが変更された場合は更新します。 -
公開.
tools/publish_case.sh cases/<カテゴリ>/<テクニック> "学んだこと" --pushこのスクリプトは
/Users/<名前>/パスを除去し、ビデオ/オーディオ/.aepファイルを拒否し、tools/health_check.pyを実行し、コミットしてプッシュします。リポジトリ所有者がオプトインした場合(MOTION_AGENT_AUTO_PUBLISH=1、または明示的に要求した場合)のみ自動的にプッシュします。それ以外の場合はコミットして確認を求めます。 -
報告 ユーザーに数行で伝えます: 追加されたレシピの数、昇格されたルール、およびコミットリンク。
品質基準
- レシピはメカニズムを命名し、誰でも再現できる数値を提供すること。
- すべての落とし穴には、何が壊れたか、なぜか、および修正方法が記載されていること。
- 公開リポジトリにクライアントアセット、プライベートパス、未公開素材を含めないこと。
- 作品が新たなことを何も教えなかった場合は、その旨を伝え、既存のケースに証拠のみを追加すること。