Communitygithub.com

motion-preflight-qa

モーション グラフィックス、AI で生成された動画、ショートフォーム広告向けの、配信前・レンダリング後品質保証を自動化します。コーデック、ピクセルフォーマット、高速ストリーミングフラグ、ラウドネス、デッドブラックフックを監査し、安全ゾーンコンタクトシートを生成し、マスター MP4 を出力します。クライアント納品やソーシャルメディアへのアップロード前に必ず使用してください。

motion-preflight-qa とは?

このスキルは、コードレンダリングされたモーション グラフィックスや短尺動画広告のための、放送品質およびソーシャルプラットフォーム対応の品質ゲートウェイです。FFprobe と FFmpeg を使用して、H.264/HEVC コーデック、yuv420p ピクセルフォーマット、Web Faststart フラグ、アスペクト比、フレームレート、EBU R128 準拠のラウドネス(-14 LUFS / -1 dBTP)、ブラックフレームの有無、ファイルサイズとビットレートを含む 8 項目の技術監査を自動化します。また、Instagram Reels、TikTok、YouTube Shorts、LinkedIn など各プラットフォームの UI 要素(ヘッダー、アクションボタン、キャプション領域)による隠蔽リスクを可視化する、6フレームの安全ゾーンコンタクトシートを生成します。監査で問題が見つかった場合は、ピクセルフォーマットの修正、faststart の付与、2パス EBU R128 ラウドネスノーマライゼーション、ビットレート最適化を自動で施した配信用マスター MP4 を作成し、最終確認として監査を再実行します。Hyperfame、Remotion、HTML/GSAP によるレンダリングと、ソーシャル配信およびクライアント納品の両方で使用可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shk2005/motion-preflight-qa/tree/HEAD

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

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

ドキュメント

Motion Preflight QA

コードレンダリングされたモーション グラフィックスおよびショートフォーム動画広告向けの、決定論的な放送・ソーシャルプラットフォーム品質ゲート。ブラインドでの再レンダリング、キャプションの切り抜き、音声のミュート/クリッピング、iOS/QuickTime の再生バグを排除するために構築されました。

前提条件

  • Python 3.9 以上(標準ライブラリのみ — サードパーティの Python パッケージは不要)
  • FFmpeg と FFprobe が PATH に存在すること

標準 QA ワークフロー(納品前に毎回実行)

ステップ 1: レンダリングされた動画の監査

対象プラットフォーム(reels、tiktok、shorts、youtube、linkedin、square、または auto)に対して、8 項目の技術監査を実行します:

python3 scripts/audit_video.py path/to/video.mp4 --platform reels

自動化パイプラインに連携する場合は --json を使用して、機械可読な出力を取得します。

確認する内容:

  1. コンテナとコーデック: H.264 (libx264) または HEVC MP4 互換性。
  2. ピクセルフォーマット (yuv420p): QuickTime、Safari、Instagram iOS で黒画面になる yuv444p / 10-bit 出力を検出。
  3. Web Faststart (moov が mdat より前): モバイルでの即時プログレッシブ再生(バッファリング遅延なし)を確認。
  4. アスペクト比と解像度: 対象プラットフォームの寸法(例:9:16 縦向きの場合は 1080x1920)と一致するか確認。
  5. フレームレートの一貫性: 標準フレームレート(24、30、60、120)のクリーンさを確認し、非標準の可変フレームレートをフラグ付け。
  6. フックの完全性(黒フレームスキャン): 先頭のデッドブラックイントロ(0.25 秒超)や、動画途中の予期しない黒ギャップをフラグ付け。
  7. オーディオラウドネス (EBU R128): 統合ラウドネス(I、LUFS)とトゥルーピーク(TP、dBTP)を測定し、ソーシャル標準の -14 LUFS / -1.0 dBTP と比較。
  8. ファイルサイズとビットレート予算: プラットフォーム側の積極的な再圧縮を誘発する、肥大化したフィルムグレイン出力をフラグ付け。

ステップ 2: 安全ゾーンコンタクトシートの生成

プラットフォームのピクセル精度 HUD 危険ゾーンを半透明の赤でマスクし、タイトル安全領域を緑で囲んだ、6 フレームのビジュアルプルーフシートを生成します:

python3 scripts/safe_zone_overlay.py path/to/video.mp4 --platform reels --out qa_contact_sheet.png

qa_contact_sheet.png を(目視または画像読み取りツールで)確認します:

  • 赤いゾーン = UI 危険エリア(上部ヘッダー、右側のいいね/コメント/シェアボタン、下部キャプション/オーディオドロワー)。
  • 緑のボックス = タイトル安全ゾーン。 赤い領域に触れている見出し、統計、プロダクトコールアウト、CTA は、納品前に必ず再配置する必要があります。
  • 問題のタイムスタンプをフル解像度で単体確認するには、--at <秒数> --out proof_frame.png を追加します。

ステップ 3: 納品用自動マスター作成(技術チェックで警告または失敗があった場合)

ピクセルフォーマットを修正し、+faststart を注入し、2 パス EBU R128 ラウドネスノーマライゼーション(-14 LUFS、-1.0 dBTP)を適用し、ビットレートをクリーンに最適化します:

python3 scripts/fix_delivery.py path/to/video.mp4 --out path/to/video_master.mp4 --crf 20

フィルムグレインやノイズの多い背景には --crf 23 を使用して、文字のぼやけを抑えながらファイルサイズを縮小します。その後、マスターとなったファイルに対してステップ 1 を再実行し、100/100 PASS を確認します。

リファレンスドキュメント

  • references/platform-safe-zones.md — Instagram Reels、TikTok、YouTube Shorts、LinkedIn、16:9 ワイドスクリーン向けの 2026 年最新安全ゾーン座標とピクセルマージン。
  • references/delivery-specs.md — コーデック、カラースペース、ラウドネス、ビットレート、および一般的なコードから動画への変換失敗の修正方法。

関連スキル