측정 기반 비디오 편집
원칙: 색상은 측정으로 판단합니다. 모든 색상 변경 제안은 그 동기(스코프, 백분위수, 피부 각도)를 숫자로 제시하고, 변경 후 숫자도 함께 제시합니다. 이 스킬의 모든 규칙에는 출처가 표시되어 있습니다. 출처가 없는 것은 **[출처 없음]**으로 표시되며, 절대 규칙으로 사용되지 않습니다.
명시된 한계: 저는 프레임과 숫자를 볼 뿐, 비디오를 재생하며 보지 않습니다. 리듬, 컷의 느낌, 룩의 취향은 요청자가 판단할 몫입니다. 전달 시에는 반드시 요청자가 휴대폰으로 확인하도록 요청합니다.
요구 사항: ffmpeg 및 ffprobe (8.1.2에서 테스트, libvidstab 포함 R61), Python 3.10+ 및 numpy와 Pillow (pip install numpy pillow).
파일
| 파일 | 용도 |
|---|---|
scripts/escopos.py | 장면별 진단: 스코프 시트 (waveform, parade RGB, 피부 톤 라인이 있는 vectorscope, 히스토그램) + 경고 및 출처가 포함된 diagnostico.md/json |
scripts/comparar.py | 장면별 전후 비교: 시트, 1080p split_cenaN.png, 숫자 표 및 해결/새로운 경고 |
scripts/graduar.py | 신호 순서대로 보정 계획(JSON)을 RGB 16비트로 적용; --previa는 정지 프레임 전후 생성 |
scripts/gerar_lut.py | 승인된 보정을 .cube (33/65)로 변환하여 Premiere/Resolve/CapCut에 적용하고 PSNR로 증명 |
scripts/montar.py | 목록(JSON) 기반으로 하드 컷, J 컷, L 컷으로 클립 조립 |
scripts/receitas.py | 출처가 있는 38개 ffmpeg 레시피; testar clipe.mp4는 모두 실행; md는 referencias/receitas-ffmpeg.md 생성 |
referencias/cor-fluxo.md | 신호 순서, 대비, 커브, 채도, 16비트 정밀도 |
referencias/niveis-e-escopos.md | BT.709, EBU R103 v3.0, 각 스코프 읽는 방법, 스크립트 측정 방법 |
referencias/pele.md | 피부 톤 라인, 크로마 범위, 증상 → 원인 → 보정 |
referencias/hdr-hlg.md | iPhone HLG → SDR, BT.2408 레벨, 측정 체인 |
referencias/corte.md | Murch (6가지 규칙, 깜박임), 액션 컷, J/L 컷, 오디오 편집, 동기화 |
referencias/plataformas.md | Meta 및 TikTok: 형식, 안전 영역, 길이, 공식 및 비공식 정보 |
referencias/receitas-ffmpeg.md | 그룹별 38개 레시피 (입력, 진단, 색상, 룩, 컷, 레이어, 모션, 마무리, 오디오, 전달) |
작업 폴더: 작품당 하나의 폴더 (예: editar-video/<프로젝트>/<작품>/): 원본, 계획, 미리보기, 시트 및 최종 파일을 함께 보관합니다.
아래 명령에서 ~/.claude/skills/editar-video는 스킬이 설치된 위치입니다. 다른 위치에 설치했다면 조정하세요.
단계 0 — 입력 (게이트 없음)
python ~/.claude/skills/editar-video/scripts/receitas.py mostrar R01 # 파일로 실행
다른 모든 것보다 먼저 ffprobe 숫자를 기준으로 결정합니다:
color_transfer=arib-std-b67(HLG) 또는smpte2084(PQ) → 먼저 SDR로 변환 (referencias/hdr-hlg.md, R03). 태그만 변경하지 마세요.r_frame_rate ≠ avg_frame_rate→ 가변 프레임레이트: 컷 전에 R02 적용 (Meta는 고정 프레임레이트 요구, Ads Guide).color_range=pc→ 변환 전에 콘텐츠가 실제로 0–255인지 확인 (R04).signalstats는 범위 태그를 무시합니다.- AI 파일, 화면 녹화: 일반적으로 태그 없이 전체 범위로 제공됩니다. 측정 전에 가정하지 마세요.
단계 1 — 측정 기반 진단 (게이트 1)
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag # SDR
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag --sdr # HLG: 톤매핑 후 측정
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 --pele 0.35,0.15,0.3,0.25 # 얼굴 영역
시트를 VER(보기) → AMPLIAR(확대) → CONFIRMAR(확인) 방식으로 읽습니다: 프레임, 각 스코프, 마지막으로 숫자. 다음을 표시합니다:
- 시트 (
folha_escopos.png) 및 장면별 표; - 측정된 사실, 한 줄에 하나씩, 규칙 및 출처 포함: "장면 2: 하이라이트 R 98,6 / G 90,0 / B 80,2 → 하이라이트에 따뜻한 색상이 우세함, 벽이 흰색이면 (Adobe, parade RGB)";
- 측정으로 알 수 없는 것 (예: 따뜻한 톤이 의도적인지 여부).
자동 피부 마스크 (Chai & Ngan)는 갈색, 베이지, 주황색을 잡아냅니다. 얼굴이 작거나 같은 색상의 물체가 있는 경우 --pele로 얼굴 영역을 전달하세요.
게이트 1: 요청자가 문제가 무엇이고 의도가 무엇인지 확인합니다. 요청자가 원하는 색상 우세를 수정하지 않습니다.
단계 2 — 보정 계획 및 미리보기 (게이트 2)
plano.json 작성 (graduar.py 상단의 형식 참조). 각 작업에는 측정된 이유가 "porque" 필드에 포함됩니다. 고정 순서: 컨폼 → 글로벌 → 장면별(매칭) → 룩 → 마무리 → 합법화 (referencias/cor-fluxo.md, 섹션 1).
- 노멀라이즈: 채널별 블랙/화이트 포인트 (
niveis)를baixas_RGB/altas_RGB에서 계산합니다. - 밸런스: 먼저 온도, 그 다음 그린/마젠타 (
temperatura,balanco). - 장면 매칭: 참조 장면 선택 (가장 밝거나 원하는 룩에 가장 가까운 장면, Colorist Guide 20, 레슨 2)하고 다른 장면의 Y 평균, 하이라이트 RGB 및 피부 톤을 근사화합니다.
- 룩: 장면 매칭 후에만 적용합니다. 스타일 채도, 크리에이티브 LUT. 룩은 취향입니다: 제안하고 요청자가 결정합니다.
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --mostrar # 필터 체인
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --previa # 각 장면 중간의 전후
게이트 2: 미리보기 승인. 조정은 장면과 정도를 명시합니다 ("장면 3, 따뜻함 절반"). 요청된 것만 변경합니다.
단계 3 — 렌더링 및 측정 비교 (게이트 3)
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json
python ~/.claude/skills/editar-video/scripts/comparar.py bruto.mp4 corrigido.mp4 -o comparacao --zoom-vs 2
folha_antes_depois.png + comparacao.md (전후 숫자, 해결 및 새로운 경고, 장면 간 진폭)를 제공합니다. 새로운 경고가 발생하면 표시 전에 수정합니다.
게이트 3: 요청자가 보정된 비디오를 시청하고 승인합니다.
단계 4 — 컷, 레이어, 텍스트, 모션 (요청 시)
- 컷: JSON 형식의 클립 목록 →
montar.py(하드, J, L). 규칙과 출처는referencias/corte.md에 있습니다. 샷 길이와 분당 컷 수를 측정합니다. 리듬은 요청자가 판단합니다. - 텍스트, 자막, 로고: R50–R52, 항상 플랫폼 안전 영역 내 (
referencias/plataformas.md). 텍스트는 닫힌 목록의 리터럴 텍스트입니다. 자막은 음성을 따르며, 단어 3개당 1초 + 1초의 읽기 시간을 갖습니다. - 비디오 위 모션: 이징이 있는 줌/팬 (R60), 안정화 (R61), 속도 (R62).
- 처음부터 모션 그래픽 (운동 타이포그래피, 애니메이션 숫자):
/motion스킬 사용, 비디오는 프레임 시퀀스로 입력됩니다. - 순서: 그래픽과 자막은 색상 및 HDR→SDR 변환 후에 추가됩니다 (ITU-R BT.2408-9 §9).
단계 5 — 리뷰 및 전달
표시 전 체크리스트:
comparar.py에서 최종 레벨/색역 경고 없음; BT.709 태그가 ffprobe로 확인됨.- 해상도, 고정 fps, 길이, 프레임 수, 시작/끝에 검은 프레임 없음.
- 텍스트가 안전 영역 내에 있음; 자막이 음성과 일치함.
- 음량 측정 (R80) 및 정보 제공. -14 LUFS 목표는 [공식 출처 없음]; 요청자가 동의하면 사용합니다.
- 인코딩 R90 (H.264, yuv420p, BT.709, +faststart).
- TikTok TopView인 경우 처음 3초 동안 강한 플래시나 순백색 없음 (
plataformas.md). - 요청자에게 휴대폰으로 확인 요청: 리듬, 느낌, 피부 톤.
재사용될 승인된 룩 → gerar_lut.py --plano plano.json -o <프로젝트>_look.cube 및 --conferir로 증명.
코드 규칙 (ffmpeg 8.1.2, 2026-11-05 기준)
- RGB 색상 필터는
format=gbrp16le뒤에 옵니다. 8비트에서는 왕복 시 평균 Y 코드가 1.1 손실됩니다. 16비트에서는 정확하게 출력됩니다. - 10비트/HLG 스트림에서
eq를 사용하지 마세요. 8비트로 강제 변환됩니다. - 필터 경로:
file='/폴더/파일.cube'(작은따옴표;:또는 공백이 있는 경로는 `)로 이스케이프 필요). - 출력 태그:
-colorspace bt709 -color_primaries bt709 -color_trc bt709 -color_range tv(+graduar.py체인 끝에setparams). - 합법화는 마지막에만 수행합니다 (EBU R103 v3.0).
limiter는 RGB 색역을 수정하지 않습니다. RGB16 단계에서 이미 클리핑합니다. -ss는 reencode와 함께-i앞에 사용하면 정밀 컷;-c copy를 사용하면 키프레임에서 컷이 발생합니다.