Communitygithub.com

비디오 검토 및 전달

완성된 영화를 전달 가능한 상태로 만드는 루프입니다. 프레임을 검토하고, 사운드를 측정하고, 검사를 실행하고, 초안과 샘플을 관련자에게 보여주고, 피드백에 따라 작업하고, 마스터를 렌더링하고, 완성된 파일을 검증하고, 프로젝트 기록을 작성하고, 보고합니다. 빌드나 변경 후, 모든 렌더링 전, 그리고 피드백이 도착할 때마다 사용하세요.

비디오 검토 및 전달란 무엇인가요?

이 스킬은 영화나 영상 프로젝트의 검토 및 전달 과정을 자동화하고 표준화합니다. `npx hyperframes lint`와 같은 명령어를 사용하여 오류를 검사하고, `snapshot`으로 주요 프레임을 캡처하여 시각적으로 확인하며, 드래프트 렌더링 후 `ffmpeg`를 이용해 음량을 측정합니다. 옵션 비교 시에는 전체 렌더링 대신 스틸 컷을 사용하여 시간과 자원을 절약하고, 피드백을 구체적인 액션 항목으로 변환하여 효율적으로 처리합니다. 최종 렌더링 전후로 디스크 공간, 해상도, 프레임 레이트, 음량(-16 LUFS, -1 dBFS 이하) 등을 체계적으로 검증하고, SCRIPT.md, SPEC.md 등 프로젝트 기록 파일을 업데이트하여 최종 산출물과 함께 간결한 보고 메시지를 전달합니다. 주로 `npx hyperframes` 기반 워크플로우를 지원하며, Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트와 함께 사용하기 적합합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-review-and-delivery

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

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

문서

검토 및 전달

1. 모든 변경 후 루프

  1. npx hyperframes lint. 오류가 0개여야 합니다.
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,... 변경한 시점과 그 전후 한 프레임씩 포함합니다. 연락처 시트를 열고 실제로 읽으십시오: 모든 카드가 완전한가, 얼굴이 가려진 곳은 없는가, 텍스트가 상자를 벗어나지는 않는가, 완성되어야 할 것이 반쯤 그려져 있지는 않은가?
  3. 프레임이 올바를 때까지 수정하고 반복합니다.
  4. npx hyperframes check --json (또는 4K 푸티지의 경우 scripts/check.sh). 오류를 수정합니다. 경고를 한 번 읽고 결정하십시오: 수정하거나, 유지하고 그 이유를 REVIEW.md에 기록합니다. 조치할 가치가 있는 경고: 3초 이상 변경되지 않는 부분, 빈 첫 프레임, 컨테이너를 벗어나는 텍스트.

스냅샷은 저렴합니다. 렌더링은 그렇지 않습니다. 렌더링 전에 할 수 있는 모든 검토를 하십시오.

2. 초안

초안은 저품질의 전체 영화입니다: npx hyperframes render --quality draft -o renders/draft-01.mp4, 100초 분량의 1080p 영화 기준 1~3분 소요됩니다. 그런 다음:

  • 렌더링된 파일의 시트를 만듭니다 (scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5) 그리고 읽습니다. 스냅샷이 잘못 가져올 수 있는 푸티지를 포함하여 인코딩된 영화를 보여줍니다.
  • 음량 측정: ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -.
  • 2초마다 레벨을 측정하고 (scripts/levels.py draft.mp4 2) 계획과 비교합니다: 조용한 부분이 조용한가, 제품이 등장하는 지점에서 리프트가 도착하는가?

관련자에게 초안과 함께 무엇이 포함되어 있고 어떤 부분에 주의를 기울여야 하는지 짧은 메모를 제공하십시오. 첫 번째 초안은 수정을 위해 존재합니다. 완벽하게 다듬기보다는 초기에 전달하십시오.

3. 옵션 보여주기

질문이 시각적 요소(하이라이트 스타일, 폰트, 레이아웃, 색상)에 관한 것이라면, 렌더링 대신 스틸 컷을 보여주십시오.

  • 각 옵션을 빌드하고, 동일한 세 네 개의 순간을 스냅샷으로 찍고, 연락처 시트를 평범한 이름(A-underline.jpg, B-band.jpg)으로 나란히 저장합니다.
  • 각각 A와 B가 무엇인지, 그리고 자신이 어느 것을 선택할지와 그 이유를 한 줄로 설명합니다.
  • 이 점에 대해서만 답변을 기다리십시오. 이에 의존하지 않는 다른 모든 작업은 계속 진행하십시오.

상대방의 말이 두 가지 의미로 해석될 수 있을 때, 이것이 알아내는 방법입니다. 1분이면 됩니다. 잘못된 전체 렌더링은 10분과 그들의 인내심을 소모합니다.

4. 피드백에 따른 조치

피드백은 짧고, 비격식적이며 때로는 짜증스럽게 도착합니다. 다음과 같이 처리하십시오:

  • 행동으로 재진술하십시오 실행하기 전에, 한 줄로: "싱가포르 사진: 다른 사진과 동일한 작은 인쇄물, 문제 부분과 결말 부분에."
  • 해당되는 모든 곳에 적용하십시오. 한 요소가 잘못되었다면, 영화 내 다른 곳의 형제 요소들도 동일한 방식으로 잘못된 것입니다.
  • 취향은 주어진 대로 받아들이십시오. "느리다", "지루하다", "싸구려 같다", "너무 두껍다": 변경하십시오. 변명하지 마십시오. 사실에 관한 의견 차이(얼굴을 가릴 것, 주장이 사실이 아닐 것)가 있다면, 이유와 함께 한 번만 말하십시오.
  • 일반적인 지시 사항과 그 의미:
그들이 말하는 것수행할 작업
느리다, 졸리다, 지루하다더 짧은 샷, 더 빠른 음성, 컷 줄이기, 더 활기찬 음악; 더 많은 효과는 제외
실제 같지 않다, AI 같다실제 사람의 실제 푸티지; 인공 그래픽 줄이기
스톡 클립을 붙인 것 같다모든 것에 하나의 그레이드 적용; 반복 등장하는 사람; 일관된 카드
연결되지 않는다이름, 직업, 구체적인 욕구; 그들 자신의 말로 표현된 문제
사운드가 평평하다, 단조롭다분위기에 따라 점수 매기기; 리프트 전에 조용하게
catchy하게 만들어라후크와 요약 라인 다시 쓰기; 콜백 추가
이건 다른 것들과 다르다형제 요소들과 정확히 일치하도록 만들기
이 단어들에 더 주의를 기울여라라인당 하나의 강조 표시, 먼저 스틸 컷으로 보여주기
  • 여러 메시지가 동시에 오는 경우: 각각을 처리하고, 어떻게 처리했는지 한 줄로 말하십시오. 나중에 온 메시지가 이전 메시지를 덮어씁니다.
  • 결정 사항 기록 REVIEW.md와 기억에 저장하십시오: 그들이 선택한 것, 거절한 것, 그들의 말로.

5. 마스터 렌더링

초안이 승인되었거나 남은 변경 사항이 작을 때:

  1. 여유 디스크 공간을 확인하십시오. 4K 렌더링은 100초당 약 11GB의 임시 공간이 필요합니다.
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<name>-4k.mp4, 백그라운드에서 실행하십시오. 속도가 필요하거나 요청받은 경우 --gpu를 추가하십시오. 그 대가(비트레이트 약 절반)를 설명하십시오.
  3. 소요 시간을 묻는다면, 렌더링 진행 상황을 읽고 숫자로 답하십시오.

버전 이름은 간단하게 지정하십시오 (-v2, -v3). 버전이 거절되면, 실수로 열지 않도록 삭제하십시오.

6. 완성된 파일 검증

전달하려는 파일 자체에서 수행하십시오. 프로젝트에서가 아닙니다.

  • ffprobe: 해상도, 프레임 레이트, 길이, 크기.
  • 전체 파일의 시트: 모든 섹션이 존재하는지, 빈 부분이나 멈춘 부분이 없는지, 마지막 프레임이 올바른지.
  • 텍스트와 얼굴의 전체 크기 크롭: 선명한 타이포그래피, 푸티지가 블록화되지 않음.
  • 음량: 약 −16 LUFS 통합, 실제 피크 −1 dBFS 이하.
  • 후반 프레임에서 디코딩된 QR 코드 (scripts/scan.py): 정확한 링크, 전체 및 절반 크기에서.
  • 요청 시 엔드 카드의 주소 확인.

7. 프로젝트 기록

보고하기 전에 네 개의 파일을 업데이트하십시오. templates/에 각각의 스켈레톤이 있습니다.

  • SCRIPT.md: 스크립트 테이블 (시간, 영상, 음성), 등장인물, 각 대사의 출처, 숫자.
  • SPEC.md: 목표, 출력물, 타이밍 및 사운드 계획, 룩, 타입, 모션, 프레임이 포함된 샷 리스트, QA 리스트.
  • CREDITS.md: 모든 출처와 라이선스.
  • REVIEW.md: 결정 사항; 측정됨, 확인됨, 확인되지 않음; 미결정 사항; 가장 약한 샷; 의도적으로 유지된 경고; 영화 변경 방법 (어떤 파일, 어떤 명령어).

8. 인계 메시지

짧게, 다음 순서로:

  1. 파일: 경로, 해상도, 길이, 크기.
  2. 이전 버전 이후 변경된 사항, 짧은 목록.
  3. 확인한 사항과 방법; 확인하지 않은 사항 (들은 적 없음).
  4. 결정이 필요한 사항, 가장 중요한 것부터: 제품에 반영되지 않은 것, 회사가 공개를 원하지 않을 수 있는 화면상의 내용, 확인해야 할 라이선스, 들어봐야 할 발음.

자신의 작업에 대한 형용사는 사용하지 마십시오. 무언가 실패했거나 누락된 경우, 그것이 첫 줄이어야 합니다.

9. 하우스키핑

  • 영화가 편집된 소스 다운로드와 매니페스트는 보관하십시오. 사용하지 않은 후보, 오래된 초안 및 캐시는 공간이 부족하거나 요청받았을 때 삭제하십시오. 삭제할 내용을 확인하십시오. 자신이 만든 것만 삭제하십시오.
  • 요청받지 않는 한 해당 저장소를 커밋하거나 푸시하지 마십시오.
  • 생성기 스크립트와 도우미 스크립트는 재시작 시 지워지는 임시 폴더가 아닌 프로젝트 내에 보관하십시오.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬