mcpField
R
review-loop

review-loop

github.com/whaleyxbtクリエイティブ・メディア713141 回インストール3 週間前に更新
リポジトリ

review-loop について

コンタクトシートで動画のレンダリングフレームを確認し、視覚と音声のチェック項目を満たすまで修正を重ねるスキルです。完成を報告する前に、構図、可読性、タイミング、一貫性、音声の問題を見つけられます。

主な機能

  1. 01ドラフトのレンダリングとシート確認
  2. 02タイムスタンプ付きフレーム検査
  3. 03トランジションと静止画の精査
  4. 04構図・文字・タイミングのチェック項目
  5. 05音量とビートの確認
  6. 06報告前の再レンダリング検証

活用シーン

  1. 01ドラフトレンダリング後のアニメーション確認
  2. 02トランジションの重なりや欠けの発見
  3. 03スマートフォン幅での文字の可読性確認
  4. 04最終動画のフレームと音声の検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/whaleyxbt/claude-motion --skill review-loop

インストール後、Claude Code で/review-loopを入力して読み込まれたか確認します。

詳細

レビューループ

動画を見ることはできませんが、フレームは確認できます。現在のレンダリングのコンタクトシートを確認せずに、動画が完成したと報告してはいけません。

ループ

  1. npm run draft — 半分の解像度で out/draft.mp4 にレンダリングします(高速です)。
  2. npm run sheet — タイムライン上の各ビートから0.3秒後(動きが落ち着いたタイミング)のフレームを1枚ずつ取得し、4×2に並べて out/sheets/beats-N.png に出力します。各タイルにはタイムスタンプが表示されます。
  3. すべてのシート画像を開き、以下のチェックリストに沿って確認します。
  4. 気になる箇所を拡大して確認します。
    • npm run sheet -- --from 3 --to 5 --every 0.2 でトランジションを細かく確認します。
    • npm run sheet -- 3.7 3.75 3.8 で特定の瞬間を確認します。
    • npm run still -- out/still.png --frame=222 でフル解像度のフレームを1枚取得します。
  5. 修正したら、手順1に戻ります。一通り確認して問題が見つからなくなったら終了します。
  6. 最終確認:npm run build を実行し、次に npm run sheet -- --video out/effort.mp4 と npm run wave を実行します。

チェックリスト

構図

  • 各フレームの焦点は1つにします。2つの要素が競合する場合は、どちらかを待たせます。
  • 意図しない衝突や重なりがないようにします。特に、退出する要素と入ってくる要素が同じ場所を共有するトランジションでは注意します。
  • セーフエリア:端から約60 px以内に重要な要素を配置しません。
  • フレーム0は黒ではなく、実際の画像にします(Xのサムネイルです)。

テキスト

  • マスク、コンテナー、またはフレームによって、意図せずテキストが切れていないこと。
  • シートのタイルをスマートフォンの幅に縮小しても、重要なメッセージが読めること。
  • 読ませる間、テキストが動いていないこと。

タイミング

  • 読み取れる状態が十分な時間保たれていること(motion-design §4を参照)。保持中のタイルでテキストがまだアニメーションしている場合、保持時間が短すぎます。
  • シーンが空のフレームに切り替わるのではなく、重なり合っていること。
  • 退出は登場より速いこと。

一貫性

  • C にあるパレットの色だけを使い、アクセントはフレームの焦点を示すこと。
  • 同じ要素は、登場するすべてのシーンで同じ見た目であること。

サウンド(npm run wave の実行後)

  • トランジェントが out/wave.png のビート線上にあること。
  • −14 LUFS ±1、トゥルーピーク ≤ −1 dBFS。

報告

完了したら、何を確認し、何を修正したか、どのシートで確認できるかを伝えます。再レンダリングして確認していない修正を、修正済みだと主張してはいけません。

コメント