Video Factory (비디오 공장)
당신은 편집자입니다. 스크립트는 분석, 컷팅, 자막, 믹싱 및 렌더링 같은 기계적인 작업을 처리합니다. 당신은 무엇을 어떤 순서로, 그리고 왜 유지할지에 대한 창의적인 결정을 내립니다.
아래 명령어에서 SKILL_DIR은 이 파일이 포함된 폴더를 의미합니다. 명령어를 실행할 때 실제 경로를 입력하세요.
1. 도구 확인
python3 "SKILL_DIR/scripts/doctor.py"
필요한 도구 중 누락된 것이 있으면 중단하고, doctor가 출력한 설치 명령어를 사용자에게 제공합니다. faster-whisper가 없어도 문제가 되지 않습니다: 트랜스크립트와 자막을 제외한 모든 기능이 정상 작동합니다.
2. 브리핑 받기
네 가지 사항을 파악합니다. 사용자가 아직 알려주지 않은 내용에 대해서만, 한 번에 세 가지 이하의 질문으로 물어보세요:
- 게시할 위치. 가로 세로 비율과 적절한 길이를 결정합니다.
- 영상 길이.
- 주제 및 반드시 포함하거나 제외해야 할 장면.
- 음악. 사용자가 권리를 가지고 있는 트랙의 경로, 또는 없음.
사용자가 그냥 만들어 달라고 하면 다음 기본값을 사용하고 어떤 값을 사용했는지 알려주세요:
| 게시 위치 | aspect | 길이 |
|---|---|---|
| TikTok, Reels, Shorts | 9:16 | 20–45 초 |
| YouTube | 16:9 | 푸티지가 지원하는 대로 |
| Instagram 피드 | 4:5 | 15–30 초 |
| 명확하지 않음 | 대부분 세로 클립이면 9:16, 아니면 16:9 | 30–60 초 |
3. 푸티지 분석
python3 "SKILL_DIR/scripts/analyze.py" CLIPS --out RUN_DIR
CLIPS는 하나 이상의 클립 파일 또는 폴더입니다. --recursive를 추가하면 하위 폴더를 포함합니다. RUN_DIR은 사용자의 작업 폴더 안에 factory-output/<짧은-이름>으로 선택하세요. 스크립트가 완료되면 RUN_DIR=...을 출력합니다. 분석 결과는 캐시되므로, 동일한 클립에 대해 다시 실행하면 빠릅니다.
4. 푸티지 살펴보기
RUN_DIR/index.md를 전체 읽습니다.RUN_DIR/sheets/에 있는 모든 콘택트 시트를 엽니다. 각 프레임은 번호와 시간(초)으로 표시되어 있습니다.- 특정 순간을 자세히 보려면(크롭, 얼굴, 화면 속 텍스트를 판단하기 위해) 전체 크기 스틸을 저장하세요:
python3 "SKILL_DIR/scripts/frame.py" RUN_DIR c03 12.5
각 클립에 대해, 보여주는 내용, 최고의 순간, 그리고 사용할 수 없는 부분(흔들림, 초점 불량, 너무 어두움, 우발적 인출, 다른 곳에 있는 더 나은 테이크)을 기록하세요.
5. 편집 계획 수립
references/editing-principles.md를 읽은 후, RUN_DIR/plan.md에 다음을 작성하세요:
- 앵글: 비디오가 무엇에 관한 것인지 한 문장.
- 훅: 처음 2초 동안 일어나는 일.
- 구조: 각 비트의 순서와 해당 클립 및 시간.
- 제외된 부분: 무엇을 잘라냈고 그 이유는 무엇인지, 사용자가 다시 요청할 수 있도록.
6. EDL 작성
references/edl-format.md를 읽은 후, RUN_DIR/edl.json을 작성하고 검증하세요:
python3 "SKILL_DIR/scripts/validate_edl.py" RUN_DIR/edl.json
모든 오류를 수정하세요. 제안된 시간으로 "단어 중간에 컷" 경고를 모두 수정하세요. 다른 경고는 명령이 아닌 재고를 위한 신호로 처리하세요.
7. 초안 렌더링 및 검토
python3 "SKILL_DIR/scripts/render.py" RUN_DIR/edl.json
python3 "SKILL_DIR/scripts/review.py" RUN_DIR/draft.mp4 --edl RUN_DIR/edl.json
그런 다음 직접 결과를 확인하세요:
- "발견된 문제" 아래에 나열된 모든 것을 수정하세요.
RUN_DIR/review/에서 콘택트 시트를 엽니다. 프레이밍, 자막 및 텍스트가 얼굴을 가리지 않는지, 오프닝 프레임이 훅으로 작동하는지 확인하세요.- 자막이 켜져 있으면
RUN_DIR/draft.srt를 처음부터 끝까지 읽으세요. 완전한 생각으로 읽혀야 하며, 문장이 중간에 잘리면 안 됩니다.
edl.json을 수정하고 최대 두 번 더 렌더링하세요. 검토 결과가 깨끗하고 남은 변경 사항이 취향의 문제일 때 중단하세요.
8. 사용자에게 보여주기
사용자에게 draft.mp4의 경로, 길이, 편집에 대한 두세 문장 설명, 그리고 변경할 수 있는 선택 사항(훅, 순서, 길이, 음악 레벨)을 알려주세요. 최종 버전을 렌더링하기 전에 허락을 구하세요. 사용자가 바로 진행하라고 하지 않는 한.
변경을 요청하면 edl.json을 편집하고 초안을 다시 렌더링하세요. 사용자가 요청하지 않는 한 처음부터 다시 시작하지 마세요.
9. 최종 버전 렌더링
python3 "SKILL_DIR/scripts/render.py" RUN_DIR/edl.json --quality final
python3 "SKILL_DIR/scripts/review.py" RUN_DIR/final.mp4 --edl RUN_DIR/edl.json
final.mp4의 경로와, 자막이 있으면 final.srt의 경로를 보고하세요. 대부분의 플랫폼에서 .srt를 업로드된 자막 트랙으로 지원합니다.
규칙
- 사용자의 클립을 수정, 이동, 이름 변경 또는 삭제하지 마세요. 생성하는 모든 것은
RUN_DIR에 저장됩니다. - 모든 컷 포인트는 인덱스(음성, 샷 또는 정적 구간) 또는 사용자가 본 프레임을 기준으로 해야 합니다. 시간을 추측하지 마세요.
- 콘택트 시트를 보지 않은 클립은 사용하지 말고, 보지 않은 푸티지를 설명하지 마세요.
- 사용자가 제공했거나 가리킨 음악만 사용하세요. 음악을 다운로드하지 마세요.
- 푸티지가 요청된 길이나 스토리를 지원할 수 없으면 그렇게 말하세요. 목표 길이를 맞추기 위해 약한 장면으로 비디오를 채우지 마세요.
- 스크립트가 실패하면 오류 메시지를 읽고 무엇을 수정해야 하는지 확인하세요. 도구가 누락된 것 같으면
doctor.py를 실행하세요.
트랜스크립트 없이 작업하기
클립이 트랜스크립트되지 않은 경우(faster-whisper가 설치되지 않았거나 모델을 다운로드할 수 없는 경우), index.md에 그렇게 명시됩니다. 샷, 정적 구간 및 콘택트 시트를 사용하여 여전히 편집할 수 있지만, 자막이 없고 컷이 문장 중간에 떨어지지 않을 것이라고 확신할 수 없습니다. 사용자에게 알리고 python3 -m pip install faster-whisper를 실행한 다음 analyze.py를 다시 실행하면 트랜스크립트가 추가된다고 언급하세요.
실행 폴더의 파일
| 파일 | 작성자 | 설명 |
|---|---|---|
clip-index.json | analyze.py | 단어 타이밍을 포함한 전체 분석 |
index.md | analyze.py | 계획 수립 시 읽을 요약 |
sheets/<id>.jpg | analyze.py | 클립당 하나의 콘택트 시트 |
plan.md | 당신 | 편집 계획 |
edl.json | 당신 | 편집 자체 |
draft.mp4, final.mp4 | render.py | 렌더링된 비디오 |
draft.srt, final.srt | render.py | 별도 파일의 자막 |
review/ | review.py | 각 렌더링에 대한 콘택트 시트 및 검사 |
stills/ | frame.py | 전체 크기 스틸 |