モーション・マッチ: アニメーションを測定し、再現し、同じ動きであることを証明する
「これをこんな風に動かして」を数値に変換します: すべてのカット、そして動く各要素に対して、開始・持続時間・イージング、オーバーシュート、移動距離、回転、形状変化。ユーザーが使用するツール(CSS、Web Animations API、Framer Motion、GSAP、Remotion、SwiftUI、After Effects)でモーションを再構築し、フレームごとに比較して、タイミングが±0.08秒以内で一致するまで繰り返します。参照モーションがなく、静止画のみですか? ディレクターモード(下記)をUIエントランス用に、ストーリーモードをリールや説明動画用に使用します: Claudeがモーションをデザイン・構築し、同じスクリプトで自身のレンダリングを測定するため、「スムーズ」は主張ではなく確認されます。動画クリップを広告に編集する場合(UGC、AI生成、撮影済み)? 編集モードを使用します: 同じ測定、ディレクタールール、レビューをフッテージに適用します。 手法は NiazMorshed2007/reanimate および rossark0/rossark-motion-skill(いずれもMITライセンス)を参考にしています。スクリプトは独自のものです。
<skill> はこのスキルのフォルダです。作業はカレントフォルダの ./motion-match/<name>/ に置きます:
ref/(参照分解)、ours/(自レンダリング分解)、compare-N/(各比較ラウンド)、spec.md。
セットアップ(初回)
PATHにffmpeg/ffprobe、およびnumpyとPillowを備えたPython 3が必要です。
- 確認:
python3 -c "import numpy, PIL"。失敗した場合、それらを持つPythonを探します(既存のプロジェクトvenvなど)。見つからなければ、ユーザーに一度だけ尋ねた後、python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillowを実行し、以下pythonとして~/.motion-match/venv/bin/pythonを使用します。すべてのスクリプトは-I付きで実行します。 - ディレクターモードとストーリーモードでは、ページをヘッドレスでレンダリングします:
pip install playwright && python -m playwright install chromium(一度だけ尋ねます)。インストールできない場合は、代わりにページをスクリーンレコーディングし、タイミングの精度が落ちることを伝えます。 - その他のインストールは不要。どこにもアップロードしません。
0. スコープ(測定前に spec.md の先頭に記述)
- ターゲット: ユーザーが指定した通りのファイル + 時間範囲(+ クロップ)(「最初の3秒」「ボタンだけ」)。
- 忠実度: モーション忠実(デフォルト): 順序、タイミング(±0.08秒)、イージングファミリー、オーバーシュート、要素のサイズに対する移動距離、スガー。ユーザー自身のアート、色、フォント、言葉。ピクセル忠実は、ユーザーが明示的に依頼し、かつ個人練習の場合のみ: 他人のデザイン、ロゴ、キャラクター、音楽はそれらのもの。コピーの公開を支援することは決してしません。
- 出力先: モーションが使用されるツールやコード(不明な場合は一度尋ねます: 出力形式を決定します)。
- 参照の取得: ユーザーが提供するファイル、またはユーザーが作成するスクリーンレコーディング(ウェブサイトやアプリ: インタラクションを録画。スキルはフレームから動作し、サイトのコードからは取得しません)。YouTubeやサイトからのダウンロードは、ユーザーがその特定の動画を明示的に要求した場合のみ、専用フォルダに保存し、非公開の参照素材として扱います。
1. 分解
python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<name>/ref [--start S --end E --crop x:y:w:h]
→ ソースfpsで全フレーム、sheets/timing_NN.png(全フレーム: タイミング、イージング、フォロースルー)および sheets/poses.png(1秒あたり2枚: 何が起きているか)。すべてのシートを読みます。GIFも同様に動作します。
2. 測定
- カットとセクション:
python -I <skill>/scripts/motion_compare.py motion-match/<name>/ref motion-match/<name>/ref --out motion-match/<name>/self --no-align参照のカット(シーンチェンジ)と移動とその時間をリストします。静止しない参照は、そのカットで分割されます。 - 正確な色:
python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T(コンタクトシートではなく、フルサイズフレームのピクセル座標)。 - 各動く要素:
track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks](または--not-bg HEXで「背景以外のすべて」)。発光している、または込み入った参照では常に--regionとその要素に固有の色を指定し、表示される可視フレーム範囲が妥当かを確認します。フレームごとに位置(cx cy)、サイズ(w h)、スカッシュ(aspect)、エッジ、フェード/成長(presence)、色、回転(angle)を記録します。 - 各移動:
python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B(1ウィンドウに1移動、カットをまたがない)→ 開始、終了、持続時間(ミリ秒とフレーム数)、イージングファミリー、オーバーシュート、セトル時間、およびCSS、WAAPI、Framer Motion、GSAP、Remotion用のコピー可能な行。誤差 ≤ 0.03 は良好な適合。「単一のイージーが適合しない」場合は、ウィンドウを分割するか、ポーズの連鎖(キーフレーム)であることを意味します。 - 微小な動き(2%のスカッシュ、5pxのフロート)はシートには表示されませんが、トラックの数値には表示されます。それらを読み取ります。
- 小さくフェードインするテキストはアクティビティ曲線のノイズに近くなります。代わりに
track_motionで測定します。
どの数値がどの種類の動きを測定するか
| 動き | 測定方法 | 備考 |
|---|---|---|
| 移動、スライド、フロート | cx, cy | 軸ごとに1回の適合 |
| スケール、成長、スカッシュ | w, h, aspect | |
| フェード | presence(--colors 付き) | |
| 回転、スピン | angle(度、時計回り+、360度を超えて連続) | シルエットから。円の場合は None: 円上のマークを別要素として追跡し、その cx/cy を適合。n倍対称性の形状(正方形: 4倍)は1フレームあたり < 180/n 度が必要なため、高速スピンには高fpsのソースが必要です。領域内の同じ色の他の形状が妨害します: --region を狭く |
| モーフ(形状→形状) | --save-masks、その後 shape_compare.py | 下記参照 |
| 3Dフリップ/カード回転 | w(cosのように縮小)+ presence; 中点で色が反転 | 裏面は別要素として扱う |
| パスモーション(弧、曲線) | cx と cy の両方、さらにパスに沿って回転する場合は angle | 各軸を適合; パス形状はシートに表示 |
| クリップ/マスク表示、ワイプ | x1 または y1(先端)、w/h | |
| ラインの描画 | presence | |
| テキスト分割(単語/文字ごと) | 最初と最後の単語を追跡; スガーは開始間隔 ÷ (カウント − 1) | |
| カウンター、チャートバー | バー: h/y0; 数字: シート(目視) |
モーフ。 track_motion.py ... --name blob --save-masks で各フレームのシルエットを保存(中央揃え、等面積にスケール)。その後:
python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to Bでtrack_blob.jsonにmorph系列を追加(0 = 最初の形状、1 = 最後)。fit_easing.py ... --prop morphで開始、終了、持続時間を取得。モーフ進行は面積に基づくため、タイミングは信頼できますが、イージング名は貼り付け可能な値ではありません。仕様から、または追跡可能なパラメータ(w、aspect、angle)からイージーを取得してください。- 自レンダリングと参照の比較:
shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate]→ 形状パス: 参照のすべての中間形状が、時間に関係なく自レンダリングにも存在しているか(合格: 平均 ≤ 10%、最大 ≤ 25% of モーフ全体)。その後fit_easing.py REF_TRACK --prop morph --vs OUR_TRACKでタイミングを確認。--rotateは、モーフが同時にスピンする場合に回転を無視(angleで確認)。
3. モーション仕様の記述(spec.md; 各行がチェック項目になります)
| # | 要素 | プロパティ | 変化 | 開始秒 | 持続時間秒(フレーム数) | イージング | オーバーシュート | スガー / 備考 | ソース |
| 1 | カード | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | カードあたり+0.08秒 | track + fit_easing |
| 2 | アイコン | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | track angle + fit_easing |
| 3 | ブロブ | morph | 四角 → 円 | 0.50 | 0.40 (12) | easeInOutCubic | — | 形状パス PASS | shape_compare |
| c | — | cuts | — | 1.77, 2.33 | — | — | — | — | motion_compare self |
行に「?」がある場合、フレームがまだ読み取られていないことを意味します。動かない要素も記載します。ジョブが大きい場合は、構築前に仕様をユーザーに表示します。
4. 構築
ユーザーのツール、ユーザーのデザインで。仕様からタイミングを、そのツール用のフィッターの出力からイージングをコピーします。レイアウトが異なる場合は、距離を要素またはフレームに対して相対的にマッピングします。ポーズの連鎖: スムーズでオーバーシュートしない補間のキーフレーム。参照がオーバーシュートしてセトルする場合はスプリング。
- 回転:
transform-originを明示的に設定(ピボットを測定:cx, cyが変わらない点)。 - モーフ: SVGパスは、両端で同じ数と種類のコマンドが必要(または flubber / GSAP MorphSVG を使用)。UIレイアウトのモーフ(ボタン→カード、サムネイル→ページ)はFLIPまたは共有要素トランジション(Framer
layoutId、View Transitions API)を使用。角丸/サイズのモーフはプレーンなCSS。 - 3D: 親に
perspective800–1200 px、backface-visibility: hidden、両面を別々のレイヤーとして。
5. 比較と修正(2〜5ラウンド)
- 同じウィンドウ、同じfpsで自レンダリングをレンダリングまたはスクリーンレコーディング(ウェブページは参照と同じ方法で録画)。
ref_frames.py OURS.mp4 --out motion-match/<name>/ours --like motion-match/<name>/ref/frames.json(同じウィンドウ、クロップ、fps、フレームサイズ)。motion_compare.py motion-match/<name>/ref motion-match/<name>/ours --out motion-match/<name>/compare-N→ オフセット、すべてのカットと移動の開始/終了/持続時間/ピーク誤差、±0.08秒以内でPASS、activity.png(両方の曲線)、sheets/compare_NN.png(参照 | 自レンダリング | 差分)。毎ラウンドシートを読みます。- 仕様の行ごとに: 同じ方法で自レンダリングを追跡し、
fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK→ 移動ごとのタイミング PASS/FAIL、移動距離とイージングファミリーの一致。モーフ行: さらにshape_compare.py --vs。 - エビデンスが示す最も小さな問題を修正し、再レンダリング、繰り返し。5ラウンド後も失敗している項目は、その数値と理由を報告。許容範囲を黙って緩めてはいけません。
| 症状 | 一般的な原因 | 修正方法 |
|---|---|---|
| すべてが一定のオフセットでずれている | 開始遅延またはトリガーレイテンシ | 最初の遅延を調整 |
| 自レンダリングが短く、前半に詰まっている | イージングが強すぎる(expo vs cubic) | 適合されたベジェを使用 |
| 参照はオーバーシュートするが、自レンダリングはしない | スプリング/back vs プレーンイージー | back.out / 測定されたオーバーシュートに調整したスプリング |
| 自レンダリングの動きが早く止まる | 二次的な動きが欠落している(ドリフト、プッシュイン) | そのウィンドウのシートを確認 |
| 自レンダリングに余分な動きやカットがある | 参照で静止しているものがアニメーションしている | 削除するか遅延させる |
| 要素番号が跳ねる | トラッキングが別の要素を捕捉した | --region を狭く、それに固有の色を使用 |
回転移動は正しいが、cx/cy で自レンダリングがぐらつく | transform-origin が間違っている | ピボットを測定された静止点に移動 |
| モーフタイミング PASS、形状パス FAIL | パスの補間が異なる(点の順序、開始点) | パス点を並べ替える/コマンドを一致させる。モーフライブラリを使用 |
6. 報告
忠実度; マッチしたものとユーザー自身のもの; 最新の比較テーブル(カットと移動の誤差、PASS/FAIL); 要素ごとの行; activity.png と比較シートへのパス; 残っているすべての差異(数値と理由); およびどのチェックが測定(スクリプトで生成)されたか、目視(シートを見て)されたか。
ディレクターモード: 静止画入力、モーションをデザイン
参照モーションがなく、ユーザーが画像(UIスクリーンショット、モックアップ、ポスター、製品写真)を提供する場合、またはClaudeにモーションを選択させる場合に使用します。作業は通常通り ./motion-match/<name>/ に置きます(ours/、spec.md、check-N/)。ビデオ作品(UIエントランス以外)の場合は、以下の手順をストーリーモード(下記)内で実行します。
- 画像を読み取る。 すべての要素(背景、ナビ、見出し、本文、画像、CTA、カード、アイコン)を、px単位のボックス、役割、ランク(1つの焦点、次にサポート、最後に装飾)とともにリスト。リーディングオーダー、グループ(カード行、リスト)、ムード(落ち着いた/プレミアム、ニュートラル/プロダクト、遊び心)、および特別なモーションを示唆するもの(トグルアイコン、チャート、ロゴマーク、曲線パス、反転可能カード)を記録。
- パーソナリティを選択(ムードから。ユーザーが指定した場合はそれを使用)。オプションを求められた場合は、3つすべてを構築。
| パーソナリティ | エントランス | 持続時間 | イージング | 移動距離 | スガー | オーバーシュート |
|---|---|---|---|---|---|---|
| 落ち着いた | フェード + 上昇 | 400–600 ms | easeOutQuart / cubic-bezier(.25,1,.5,1) | 8–16 px | 60–80 ms | なし |
| ニュートラル | フェード + 上昇、またはスケール .97→1 | 250–400 ms | easeOutCubic / cubic-bezier(.33,1,.68,1) | 12–24 px | 40–60 ms | なし |
| 遊び心 | 上昇 + スケール .9→1 | スプリング | スプリング (stiffness 300–400, damping 20–26) | 16–32 px | 50–70 ms | 3–8% |
- 役割に応じて特別なモーションを選択(語彙; 値は開始点であり、パーソナリティでスケーリング):
| モーション | 使用場面 | デフォルト |
|---|---|---|
| モーフ | アイコントグル(メニュー ↔ 閉じる、再生 ↔ 一時停止)、ボタンがカードやシートに拡大する場合、形状ロゴ | 300–500 ms easeInOutCubic; レイアウトモーフは FLIP/共有要素 |
| 回転 | トグル/シェブロンアイコン、リフレッシュ、傾いたエントランス | アイコン 90–180°、200–300 ms easeOutCubic; エントランス −6…−10° → 0、パーソナリティのイージーで; ローダー 360° 線形 0.8–1.2 s ループ |
| 3Dフリップ / 傾き | 二面カード、価格トグル、ホバー奥行き | フリップ rotateY 180°、500–700 ms easeInOutCubic; ホバー傾き ≤ 8° |
| パスモーション | 移動するもの(飛行機、ルート上の点、カーソル) | easeInOutSine、パスに沿って回転、0.8–1.6 s |
| クリップ / マスク表示 | ヒーローイメージ、大きな見出し | inset または円クリップ、500–800 ms easeOutQuart |
| テキスト分割 | メイン見出しのみ | 単語 40–60 ms 間隔、文字 15–30 ms; 行全体 ≤ 1 s |
| ライン描画 | アイコン、署名、チャート、アンダーライン | stroke-dashoffset、600–1000 ms easeInOutCubic |
| カウンター / チャート成長 | 数字、バー、リング | 数字 800–1200 ms easeOutExpo; バーはベースラインから、スガー 40–60 ms |
| パララックス / 奥行き | レイヤードヒーロー、スクロールシーン | レイヤー速度 0.2–0.6 of スクロール; サポートされていればスクロールタイムライン |
- コレオグラフ は以下のルールに従う:
- 順序: 背景/コンテナ → 焦点 → 見出し → サポート → CTA。装飾(ナビ)は最後、またはページをフレームする場合は最初に150msの素早いフェード。
- サイズが持続時間を決定(アイコンは低め…
(元の内容は切り捨てられていますが、翻訳は与えられた範囲で完了しています。)