Video check: 다른 사람이 보기 전에 렌더링의 문제를 찾아내기
이것은 video-check 0.2.3입니다.
사용자는 전문 편집자가 내보내기 파일을 검수하는 것처럼 검사된 영상과 다음 내용이 포함된 짧은 REVIEW.md를 받게 됩니다: 측정한 항목, 확인한 사항, 수정한 내용, 그리고 아무도 확인하지 않은 부분.
전체 과정에 걸쳐 세 가지가 항상 적용됩니다:
- 먼저 측정하고, 그 다음에 본다. 모델이 프레임을 보면 정지 구간이나 원프레임 글리치를 놓칠 수 있습니다. FFmpeg는 그렇지 않습니다. 보기 전에
check.py를 실행하고, 영상이 "괜찮아 보인다"는 이유로 절대 건너뛰지 마세요. - 만든 사람이 최악의 리뷰어다. 각 샷이 무엇을 보여주려 했는지 알기 때문에 그림 대신 계획을 보게 됩니다. 당신의 계획을 모르는 사람이 시트를 보게 하세요(3단계).
- 당신은 들을 수 없다. 스크립트는 음량, 피크, 무음을 측정합니다. 음악이 어울리는지, 특정 소리가 올바른 소리인지, 음성이 명확한지는 사람이 직접 들어야 합니다. 매번 그렇게 말하세요.
입력이 누락된 경우
렌더링된 파일이 이 머신에 있어야 합니다. 사용자가 영상을 설명만 하거나 플랫폼 링크를 제공하면 파일을 요청하세요. TikTok, YouTube 또는 Instagram에서 다운로드하지 마세요. 당신이 영상을 만들었다면 계획(크기, 프레임 레이트, 길이, 음량 목표, 의도된 정지 구간과 플래시)도 알고 있어야 합니다. 사용자가 자신의 편집본을 가져온 경우 어떤 용도인지(플랫폼, 길이) 물어보고 나머지는 아래 기본값을 사용하세요.
워크플로우
-
측정. 계획된 내용을 전달하여 스크립트가 결함과 선택을 구분할 수 있게 하세요:
python scripts/check.py final.mp4 --out work/check1 --loudness -14당신이 영상을 만들었거나 사용자가 계획을 알려준 경우, 추가하세요. 예:
--expect 1080x1920 --fps 30 --duration 32 --holds 28.5-32 --flashes 12.4. 플랫폼에서 크기, 프레임 레이트 또는 길이를 추측하지 마세요. 아무도 1080p를 요구하지 않은 960x540 파일은 크기 결함이 아닙니다. 따라서 아무도 계획하지 않았다면--expect를 생략하세요.--holds는 의도된 정지 구간(엔드 카드, 정지된 제목)을 나열하고,--flashes는 계획된 원프레임 플래시와 딥을 나열하고,--loop는 루프용으로 제작된 조각에 사용하고,--audio none은 무음 조각에 사용합니다. 온라인 영상은 약 -14 LUFS로 노멀라이즈됩니다. 팟캐스트는 -16, 방송은 -23을 사용하세요. 결과는P0/P1/P2 t=… code: what -> fix형식으로 출력되며check.json,overview_NN.png,findings.png를 작성합니다.references/reading-the-checks.md에 각 검사가 무엇을 잡아내고 무엇을 놓치는지 설명되어 있습니다. -
P0는 지금 바로 수정하세요. 잘못된 크기, 잘못된 프레임 레이트, 잘못된 길이, 있어야 할 오디오가 없음, 클리핑: 이것들은 취향 문제가 아닌 렌더링 실수입니다. 명령어를 수정하고, 다시 렌더링한 후 아무도 보기 전에 1단계를 다시 실행하세요. 음량, 클리핑, 트루 피크의 경우 편집본이 있다면 편집본에서 믹스를 수정하세요(음악, 가장 큰 소리를 낮추세요). 완성된 파일만 있다면
python scripts/fix_sound.py in.mp4 out.mp4 --loudness -14를 실행하세요. 피크를 제한하고, 두 패스로 노멀라이즈하며, 그림은 그대로 복사합니다. 목표치 ±0.2 LU 이내로 맞추고 -1.5 dBTP 미만으로 유지합니다. 단일 패스loudnorm은 피크 목표를 놓치고, 단순 리미터는 믹스를 조용하게 만듭니다. 라운드를 반복하며 필터를 수동으로 조정하지 마세요. -
새로운 눈으로 보세요. 모든 개요 시트와
findings.png를 Read 도구로 여세요. 그런 다음 당신의 계획을 모르는 사람에게 두 번째 검토를 요청하세요:- 서브에이전트를 시작할 수 있다면, 시트와 플랫폼, 영상의 용도에 대한 한 문장만 전달하세요. 계획, 코드, 의도는 전달하지 마세요.
references/review-guide.md의 브리핑을 사용하세요. - 서브에이전트를 사용할 수 없다면 직접 보되, 계획을 가리세요: 각 시트를 낯선 사람처럼 한 프레임씩 한 문장으로 설명한 후 판단하세요.
REVIEW.md에 "one context"라고 작성하세요.
각 문제는
t=12.4s · 화면 위치 · 무엇이 잘못되었는가 → 정확한 변경 사항형식으로 P0(손상되었거나 읽을 수 없음), P1(시청자가 알아차릴 수 있음), 또는 P2(다듬기)로 기록됩니다. 10점 만점 점수는 없습니다. 점수는 수정할 대상을 찾지 못합니다.references/review-guide.md의 목록을 확인하세요. 여기에는 템플릿이나 기계가 만든 것처럼 보이게 하는 요소들(슬라이드 같은 진행 표시줄과 단계 카운터, 모든 줄이 같은 방식으로 나타남, 플랫폼 버튼 아래 텍스트, 비어 있는 첫 프레임, 아무도 주지 않은 숫자)이 포함되어 있습니다. - 서브에이전트를 시작할 수 있다면, 시트와 플랫폼, 영상의 용도에 대한 한 문장만 전달하세요. 계획, 코드, 의도는 전달하지 마세요.
-
가장 심각한 세 가지를 수정한 후 다시 확인하세요. P0와 가장 심각한 P1 세 가지를 선택하세요. 각각에 대해 렌더링된 파일이 아니라 편집 목록이나 명령어를 변경하세요. 수정 방법을 모른다면 원하는 결과를
search_techniques로 검색하고(예: "음악 아래 음성 줄이기", "컷에서 오디오 페이드 아웃")get_technique로 프롬프트를 가져오세요. 렌더링한 후--before work/check1/check.json --out work/check2를 사용하여 1단계를 다시 실행하세요. 수정된 사항, 남아 있는 사항, 새로 생긴 사항이 나열되고before_after.png가 생성됩니다. 변경한 프레임을 확인하세요. -
3라운드 후에 중지하세요. 3라운드에도 P0가 남아 있거나 큰 변경이 필요하다면 루프를 돌지 말고 중지하고 사용자에게 남은 문제와 이유를 알리세요. 결정이 필요한 문제(다른 노래, 존재하지 않는 샷)는 질문으로 사용자에게 전달하세요.
전달
먼저, 버전을 확인하세요. EditAtlas MCP가 연결되어 있다면 이름 없이 get_skill을 호출하세요. video-check가 0.2.3보다 높게 나오면 응답의 첫 줄에 최신 버전이 존재하며 업데이트 방법(Claude Code에서는 /plugin, Marketplaces, editatlas-skills, Update marketplace; MCP가 없으면 get_skill with name video-check 단계)을 명시하세요. MCP가 없으면 건너뛰세요.
영상 옆에 사용자의 언어로 REVIEW.md를 작성하세요. references/review-guide.md의 템플릿을 사용하세요:
- 한 줄 평: 준비 완료(남은 문제 없음), 준비 완료(참고 사항 있음)(참고 사항에는 여전히 남아 있는 모든 발견 항목과 각각 남아 있는 P1이 당신이 가지고 있지 않은 것(예: 편집 프로젝트)이 필요한 이유를 명시), 또는 준비되지 않음(P0가 여전히 남아 있거나 당신이 수정할 수 있는 P1이 남아 있음);
- 스크립트가 측정한 항목(크기, 프레임 레이트, 길이, 음량, 트루 피크, 분당 컷 수)과 각 라운드에서 수정된 발견 항목;
- 여전히 남아 있는 각 발견 항목의 시간과 패턴을
check.py가 작성한 그대로(예: "0.4초부터 12프레임마다 하나; 11.7초에서 14.9초까지 2-6프레임마다 하나"), 단순한 개수만이 아닌 형태로; - 리뷰어가 본 내용과 별도의 리뷰어인지 one context인지;
- 여전히 사람이 필요한 것: 믹스와 음악 선택 듣기, 화면의 철자와 이름, 립싱크, 실제 휴대폰에서 색상 확인, 그리고 당신이 수정할 수 없었던 모든 것. 아무도 사운드를 듣지 않았다는 문장을 평범한 말로, 사용자의 언어로만 유지하세요.
사용자에게 마지막 라운드의 before_after.png를 보여주세요. 영상에 "오류가 없다"고 절대 쓰지 말고 무엇을 확인했는지 작성하세요.
참고 자료
references/reading-the-checks.md: 각 측정값, 임계값, 잡아내는 것과 놓치는 것, 알려진 영상에 대한 결과. 발견 항목이 잘못된 것처럼 보이거나--holds를 설정하기 전에 읽으세요.references/review-guide.md: 리뷰어를 위한 브리핑, 징후 목록, 문제 형식 및REVIEW.md템플릿. 3단계에서 읽으세요.