Communitygithub.com

모션 프리플라이트 QA

모션 그래픽, AI 코딩 비디오(HyperFrames, Remotion, HTML/GSAP), 숏폼 소셜 광고(Instagram Reels, TikTok, YouTube Shorts, LinkedIn)를 위한 자동화된 사전 검증 및 렌더링 후 품질 보증 도구입니다. 코덱, 픽셀 형식(yuv420p), faststart 스트리밍 플래그, EBU R128 라우드니스(-14 LUFS / -1 dBTP), 데드 블랙 훅을 감사하고, 6프레임 플랫폼 안전 영역 QA 콘택트 시트를 렌더링하며, 전달 준비가 완료된 마스터 MP4를 제작합니다. 렌더링된 비디오를 클라이언트 전달 또는 소셜 업로드용으로 확인, 수정 또는 준비할 때마다 사용하십시오.

모션 프리플라이트 QA란 무엇인가요?

Motion Preflight QA는 코드로 렌더링된 모션 그래픽 및 숏폼 비디오 광고를 위한 결정론적 브로드캐스트 및 소셜 플랫폼 품질 게이트입니다. 이 스킬은 Python 3.9+와 FFmpeg/FFprobe만을 사용하여 표준 라이브러리 외의 추가 패키지 없이 동작하며, Instagram Reels, TikTok, YouTube Shorts, LinkedIn 등 주요 소셜 플랫폼에 최적화되어 있습니다. 8단계 기술 감사(audit_video.py)를 통해 H.264/HEVC 코덱, yuv420p 픽셀 포맷, Web Faststart, 종횡비, 프레임 레이트, 블랙 프레임 훅, EBU R128 오디오 라우드니스, 파일 크기 및 비트레이트를 종합적으로 점검합니다. 또한 safe_zone_overlay.py 스크립트로 플랫폼 UI 위험 영역을 시각화한 6프레임 콘택트 시트를 생성하고, fix_delivery.py로 자동 마스터링(픽셀 포맷 수정, faststart 적용, EBU R128 라우드니스 정규화)을 수행하여 모든 검사를 통과한 전달 준비 완료 파일을 보장합니다. 이 도구는 블라인드 재렌더링, 잘린 캡션, 음소거/압축된 오디오, iOS/QuickTime 재생 버그를 제거하여 클라이언트 전달 전 최종 품질 확인을 자동화합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

모션 프리플라이트 QA은(는) 무엇을 하나요?

코드로 렌더링된 모션 그래픽 및 숏폼 비디오 광고를 위한 결정론적 브로드캐스트 및 소셜 플랫폼 품질 게이트입니다. 블라인드 재렌더링, 잘린 캡션, 음소거/압축된 오디오, iOS/QuickTime 재생 버그를 제거하기 위해 설계되었습니다.

사전 요구사항

  • Python 3.9+ (표준 라이브러리만 사용 — 서드파티 Python 패키지 필요 없음)
  • PATH에 FFmpeg 및 FFprobe

표준 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비트 내보내기를 감지합니다.
  3. Web Faststart (moov가 mdat보다 앞에): 버퍼링 지연 없이 즉시 프로그레시브 모바일 재생이 가능한지 확인합니다.
  4. 종횡비 및 해상도: 대상 플랫폼 치수(예: 9:16 세로의 경우 1080x1920)와 일치하는지 확인합니다.
  5. 프레임 레이트 일관성: 표준 FPS(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 <seconds> --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 — 코덱, 색 공간, 라우드니스, 비트레이트 및 일반적인 코드-비디오 실패 수정 방법.

관련 스킬