프로 비디오 편집은(는) 무엇을 하나요?
이 스킬은 함께 작동하는 세 부분으로 구성됩니다:
- 편집 판단: 무엇을, 어디서, 왜 자를지 결정하여 결과물이 기계가 조립한 것이 아니라 취향을 가진 사람이 만든 것처럼 느껴지게 합니다.
- 편집기 (
vedit): 완전히 명령줄에서 작동하는 소형 타임라인 편집기입니다. 컷, 타이틀, 페이드, 사운드 효과 및 음성 프리셋이 모두 이를 통해 처리되며, 사용자는 브라우저에서 동일한 프로젝트를 열 수 있습니다. - 사운드 도구: 사운드 효과 라이브러리를 인덱싱하고, 검색하며, 사운드가 정확한 프레임에 맞도록 배치합니다.
아래 경로는 이 스킬의 폴더를 기준으로 합니다. 도구는 Python 3.9+ 및 FFmpeg 5+가 필요합니다 (설치할 다른 것은 없습니다).
자신이 할 수 있는 것과 없는 것에 대해 솔직하세요
- 오디오를 듣거나 비디오를 볼 수 없습니다. 측정(트랜스크립트, 장면 및 무음 감지,
scripts/qc_audio.py)으로 판단하고 그렇게 말하세요. 렌더링 후 사용자가 청취할 두세 개의 타임스탬프를 지정하세요. - 사운드 파일 이름이나 ID를 절대 임의로 만들지 마세요.
scripts/sfx_search.py가 반환한 ID만 사용하세요. scripts/sfx_search.py --stats에 카탈로그가 없다고 표시되면 사운드 라이브러리가 아직 설정되지 않은 것입니다. 아래 일회성 설정을 제안하고 다운로드 전에 확인을 기다리세요. 사용자가 거부하거나 실패할 경우 편집 작업은 계속 수행하고references/sfx-library-setup.md를 안내하세요. 다른 사운드 라이브러리를 직접 다운로드하지 마세요.
핵심 원칙 (짧은 버전)
전체 텍스트와 예제: references/editorial-principles.md. 컷을 하거나 리뷰하기 전에 읽으세요.
- 감정 우선. 각 지점에서 시청자가 무엇을 느껴야 하는지 물어보세요. 전체적으로 느껴진다면 편집은 성공입니다.
- 컷 계층 구조. 컷이 모든 것을 만족시킬 수 없을 때 이 목록의 아래 항목부터 포기하세요: 감정, 이야기, 리듬, 시선 추적, 평면성, 공간 연속성. 상위 항목을 하위 항목과 절대 교환하지 마세요.
- 생각이 끝나는 지점에서 자르세요, 시청자가 눈을 깜빡일 순간. 컷 포인트는 눈을 깜빡일 수 있는 지점이어야 합니다.
- 최소한으로 최대 효과를 내세요. 암시가 설명보다 낫습니다. 더 적고 더 나은 선택. 자르지 않는 것도 결정입니다.
- 화면에 있는 것만 판단하세요. 노력, 비용, 의도는 무시하세요.
- 마술사처럼 주의를 분산시키세요: 시선이 향할 곳을 결정하고, 다음 샷이 그곳을 만나게 하세요.
- 고치기 전에 진단하세요. 문제는 종종 시청자가 느꼈다고 말하는 지점보다 앞에 있습니다.
워크플로우
| 단계 | 할 일 | 참조 |
|---|---|---|
| 1. 인테이크 | 전달물(플랫폼, 화면비, fps, 길이)과 의도를 한 문장으로 확인하세요. | technical-pipeline.md |
| 2. 로깅 | 모든 푸티지 인덱싱: 단어 시간이 포함된 트랜스크립트, 샷 유형, 무음, 베스트 테이크. 설정당 대표 프레임을 선택하세요. | editorial-principles.md |
| 3. 어셈블 | 최상의 자료로 순서대로 이야기를 구성하세요. 다듬기 전에 구조를 먼저 잡으세요. | editorial-principles.md |
| 4. 리파인 | 컷 계층 구조와 깜빡임 타이밍을 적용하세요. 첫 전체 패스 후에 재기각된 푸티지를 다시 검토하세요. | editorial-principles.md |
| 5. 사운드 | SFX 스팟, 검색, 배치 및 믹싱. | sfx-placement.md |
| 6. 확인 | 관객처럼 처음부터 끝까지 시청하세요. QC 스크립트를 실행하세요. | 아래 |
| 7. 전달 | 풀 퀄리티로 재연결하고, 색상/레벨을 매칭하고, 먼저 마스터를 내보내세요. | technical-pipeline.md |
작업을 반환할 때 다음을 명시하세요: 편집 목표로 삼은 의도, 주요 구조적 선택, 제거한 내용과 그 이유, 알려진 절충점, 시도해볼 만한 대안.
편집기 (vedit)
실제 편집을 수행하는 데 사용하세요. references/editor.md를 먼저 읽으세요. 모든 명령어, 프로젝트 형식 및 작업 방법이 있습니다. 필수 사항:
python3 editor/vedit.py new myfilm --size 1920x1080 # 프로젝트 폴더 생성 (Windows에서는 python3가 없으면 `python` 사용)
python3 editor/vedit.py -p myfilm settings --preset vertical # 대상 캔버스 (Reels/TikTok/Shorts); 또한 --lufs -14
python3 editor/vedit.py -p myfilm analyze clip.mp4 # 무음 및 장면 변경 감지, 컷 선택을 위해
python3 editor/vedit.py -p myfilm import clip.mp4 # a1과 같은 에셋 ID 출력
python3 editor/vedit.py -p myfilm add a1 --in 12.5 --dur 8 # 타임라인에 8초 배치
python3 editor/vedit.py -p myfilm grade c1 --look cinematic # 컬러; 또한 --brightness --contrast --saturation --temperature --lut FILE
python3 editor/vedit.py -p myfilm key c1 scale --at 0 --value 1; python3 editor/vedit.py -p myfilm key c1 scale --at 8 --value 1.15 --ease inout # 느린 푸시인
python3 editor/vedit.py -p myfilm transition c1 c2 --type dissolve --dur 0.5
python3 editor/vedit.py -p myfilm key c1 speed --at 0 --value 1 # 속도 램프: `speed`에 더 많은 키프레임 추가 (클립 자체 사운드는 음소거됨); 또한: reverse c1, freeze c1 --at 4 --dur 2
python3 editor/vedit.py -p myfilm tracker add c1 --at 4 --x 0.6 --y 0.3 # 포인트 추적; 그 다음: mask c1 --effect blur, follow c1 m1 t1 (얼굴 블러) 또는 attach c2 t1 (타이틀 부착)
python3 editor/vedit.py -p myfilm stabilize c1 # 카메라 흔들림 제거 (libvidstab이 있는 FFmpeg 필요)
python3 editor/vedit.py -p myfilm captions subtitles.srt # 자막당 하나의 텍스트 클립
python3 editor/vedit.py -p myfilm sfx a3f9c012 --at 8.0 # scripts/sfx_search.py의 사운드 ID; 히트가 8.0초에 위치
python3 editor/vedit.py -p myfilm set c1 preset="voice enhancer"
python3 editor/vedit.py -p myfilm check # 보고된 모든 오류 수정
python3 editor/vedit.py -p myfilm render --preview # 빠름; 그 다음 `frame --at T`로 PNG 확인
python3 editor/vedit.py -p myfilm measure --at 4 # 밝기/색상 수치, 노출 및 그레이딩 판단용
python3 editor/vedit.py -p myfilm serve # 사용자가 브라우저에서 열고 조정할 수 있도록 함
- 완전한 제어 가능: 모든 명령어는 JSON 출력, 오류는 평문,
batch는 여러 편집을 하나의 변경으로 적용,undo는 하나를 되돌림. 키프레임은 줌, 위치, 회전, 불투명도, 색상, 볼륨 및 속도를 애니메이션화할 수 있습니다.editor.md에 나머지 (마스크, 트래킹, 그린 스크린, 크롭, 플립, 트랙 음소거 및 숨기기, 캔버스 프리셋)가 있습니다. frame --at T로 추측하지 말고 그림을 보고,measure로 색상을 판단하고, 소리는