Communitygithub.com

motion-preflight-qa

Garantia de qualidade automatizada pré-voo e pós-renderização para motion graphics, vídeos codificados por IA e anúncios sociais em formato curto.

O que é motion-preflight-qa?

Motion Preflight QA é uma ferramenta de garantia de qualidade determinística para vídeos renderizados por código, como motion graphics e anúncios de curta duração. Ela realiza uma auditoria técnica completa de oito pontos, verificando codec, formato de pixels (yuv420p), flags de streaming faststart, loudness EBU R128 (-14 LUFS / -1 dBTP), ganchos pretos mortos e gera uma folha de contato visual com zonas de segurança da plataforma. A ferramenta também pode corrigir automaticamente problemas comuns, como formato de pixels incorreto e loudness fora do padrão, gerando um arquivo mestre otimizado para entrega ao cliente ou upload em plataformas como Instagram Reels, TikTok, YouTube Shorts e LinkedIn. É ideal para fluxos de trabalho baseados em código, como HyperFrames, Remotion e HTML/GSAP, eliminando a necessidade de múltiplas re-renderizações.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Motion Preflight QA

Gate de qualidade determinística para broadcast e plataformas sociais, para motion graphics e anúncios em vídeo curto renderizados por código. Construído para eliminar re-renderizações cegas, legendas cortadas, áudio mudo/comprimido e bugs de reprodução no iOS/QuickTime.

Pré-requisitos

  • Python 3.9+ (apenas biblioteca padrão — nenhum pacote Python de terceiros necessário)
  • FFmpeg e FFprobe no PATH

Fluxo de Trabalho Padrão de Garantia de Qualidade (Execute Antes de Cada Entrega)

Passo 1: Audite o vídeo renderizado

Execute a auditoria técnica de 8 portas contra a plataforma de destino (reels, tiktok, shorts, youtube, linkedin, square ou auto):

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

Use --json para saída legível por máquina ao encadear em pipelines automatizados.

O que verifica:

  1. Container e Codec: Compatibilidade com H.264 (libx264) ou HEVC MP4.
  2. Formato de Pixel (yuv420p): Detecta exportações yuv444p / 10-bit que resultam em telas pretas no QuickTime, Safari e Instagram iOS.
  3. Web Faststart (moov antes de mdat): Verifica reprodução móvel progressiva instantânea sem atrasos de buffer.
  4. Proporção e Resolução: Verifica correspondência com as dimensões da plataforma de destino (ex.: 1080x1920 para 9:16 vertical).
  5. Consistência da Taxa de Quadros: Verifica FPS padrão limpo (24, 30, 60 ou 120) e sinaliza taxas de quadros variáveis não padrão.
  6. Integridade do Gancho (Escaneamento de Quadro Preto): Sinaliza qualquer introdução preta morta (> 0,25 s no início) ou lacunas pretas inesperadas no meio do vídeo.
  7. Altura do Áudio (EBU R128): Mede a Altura Integrada (I em LUFS) e o Pico Verdadeiro (TP em dBTP) contra o padrão social de -14 LUFS / -1,0 dBTP.
  8. Tamanho do Arquivo e Orçamento de Bitrate: Sinaliza exportações de grão de filme inchadas que disparam recompressão agressiva da plataforma.

Passo 2: Gere a Folha de Contato da Zona de Segurança

Gere uma folha de prova visual de 6 quadros com zonas de perigo HUD da plataforma, com precisão de pixel, mascaradas em vermelho translúcido e o perímetro de segurança do título delineado em verde:

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

Inspecione qa_contact_sheet.png (visualmente ou com uma ferramenta de leitura de imagem):

  • Zonas vermelhas = áreas de perigo da interface do usuário (cabeçalho superior, trilho direito de like/comentário/compartilhar, gaveta inferior de legenda/áudio).
  • Caixa verde = Zona de segurança do título. Qualquer título, estatística, chamada de produto ou CTA que toque o vermelho DEVE ser reposicionado antes da entrega.
  • Para inspecionar um único timestamp problemático em resolução total, adicione --at <segundos> --out proof_frame.png.

Passo 3: Auto-Mestre para Entrega (se qualquer verificação técnica avisar ou falhar)

Corrija o formato de pixel, injete +faststart, aplique normalização de altura EBU R128 de duas passagens (-14 LUFS, -1,0 dBTP) e otimize o bitrate de forma limpa:

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

Use --crf 23 para grão de filme pesado ou fundos ruidosos para reduzir o tamanho do arquivo sem tipografia borrada. Em seguida, reexecute o Passo 1 no arquivo mestre para confirmar um PASSO 100/100.

Documentação de Referência

  • references/platform-safe-zones.md — Coordenadas exatas das zonas de segurança de 2026 e margens de pixel para Instagram Reels, TikTok, YouTube Shorts, LinkedIn e widescreen 16:9.
  • references/delivery-specs.md — Codec, espaço de cor, altura, bitrate e correções comuns de falhas de código para vídeo.

Habilidades Relacionadas