긴 비디오 렌더링
긴 비디오 워크플로우의 9단계. 출력물: 사용자가 승인할 때까지의 검토 렌더(저화질), 이후 고화질 최종 비디오 한 개.
장면은 이전 단계에서와 같이 비디오 전체에 걸쳐 순서대로 번호가 매겨진 스크립트의 한 클립을 의미합니다. 검토 비디오에 장면 번호가 표시되어 검토자가 가리킬 수 있습니다.
시작하기 전에
~/.long-video/projects/<slug>/에서 프로젝트를 찾으세요.status: approved인video-script.md가 필요합니다.- 프로젝트 설정을 로드하세요: 해상도, 화면 비율, 자막 모드(
visuals.captions), 음량 요구 사항, 플랫폼. - ffmpeg와 ffprobe를 확인하세요(
ffmpeg -version). 번들 렌더러는 libx264와 libass가 있는 ffmpeg가 필요합니다. render/가 이미 존재하는 경우, 계속할지(버전 목록 표시) 아니면 다시 시작할지 물어보세요.
1단계: 인벤토리
모든 장면을 확인하고 존재하는 항목을 나열하세요:
| 항목 | 위치 | 사용 용도 |
|---|---|---|
| 비디오 클립 | clips/scene-<NNN>_clip.* (또는 _take2 등 사용자가 승인한 버전) | 해당 장면의 영상 |
| 이미지만 | frames/scene-<NNN>_start.* | 스크립트의 카메라 움직임(확대, 축소, 패닝)이 있는 정지 이미지 |
| 음성 | audio/lines/scene-<NNN>_<speaker>_<NN>.* | 내레이션 및 대화 |
| 사운드 스템 | sound/mix/sfx_track.wav, amb_track.wav, music_track.wav | 효과음, 분위기, 음악 |
짧은 표로 누락된 항목을 보고하세요. 클립도 없고 이미지도 없는 장면은 차단 요소입니다: 해당 장면을 나열하고 long-video-keyframes 또는 long-video-clips으로 돌아갈 것을 제안하세요. 음성이나 사운드가 누락된 것은 사용자가 해당 단계를 건너뛰기로 선택한 경우에만 허용됩니다. 단계가 건너뛰어졌다면 다시 요청하지 마세요.
클립 단계가 건너뛰어진 경우(clips_mode: images-only), 모든 장면은 스크립트 샷에서 가져온 카메라 움직임이 있는 정지 이미지가 됩니다.
2단계: 조립 도구 선택
- Claude가 제어할 수 있는 비디오 편집기가 있는지 확인하세요: 이 세션에 연결된 편집 MCP 서버 또는 장치의 CLI(FilmCraft:
filmcraft-cli commands; EffectCraft:effectcraft-cli --help).../long-video-sound/references/tools.md의 섹션 5를 참조하세요. - 사용 가능한 편집기가 있다면, 사용할지(사용자가 프로젝트를 열고 조정할 수 있음) 아니면 번들 렌더러를 사용할지 물어보세요. 기본값은 번들 렌더러입니다. 사용자가 편집기를 선택하면 먼저 명령 목록과 문서를 읽고, 복사본에서 작업하며, 설치나 빌드 전에 먼저 물어보고, 동일한 파일 이름을 유지하세요.
- 어떤 도구를 사용할지 알려주세요.
이 스킬의 나머지 부분은 번들 렌더러를 설명합니다. 편집기를 사용하는 경우, 동일한 단계를 해당 명령을 통해 수행하고 검토 및 최종 파일을 동일한 폴더와 이름으로 내보내세요.
3단계: 편집 목록 빌드
references/edl-format.md를 읽으세요. 프로젝트 파일에서 render/edl.json을 작성하세요:
- 각 장면에 대해 지속 시간(스크립트 기준 또는 실제 클립 길이가 장면 길이보다 짧거나 긴 경우 실제 길이), 영상 소스, 정지 이미지의 카메라 움직임, 전환 효과를 포함한 항목 하나씩,
- 음성 배치: 장면 시작 시간과 짧은 오프셋(기본값 0.3초), 순서대로 작은 간격을 둔 라인,
- 사운드 스템,
- 설정에서 자막을 원하는 경우 음성 텍스트의 자막(각 음성 파일의 지속 시간에 따른 시작 및 종료),
- 설정의 너비, 높이 및 fps. 기본 fps는 24입니다. 기본 음량 목표는 -14 LUFS이며 트루 피크는 -1.5 dBTP 미만입니다.
규칙:
- 승인된 스크립트의 정확한 장면 지속 시간을 사용하세요. 스토리를 늘리거나 줄이지 마세요.
- 장면보다 긴 클립은 끝에서 잘립니다. 장면보다 짧은 클립은 마지막 프레임을 유지합니다. 둘 다 보고하세요.
- 장면 끝이나 비디오 끝을 넘어서는 음성 라인은 경고로 보고됩니다.
- 전환: 기본값은
cut입니다.fade(검은색으로 페이드)는 스크립트에 명시된 경우에만 사용합니다. 크로스 디졸브는 편집 도구가 필요합니다. - 렌더링 전에 계획을 확인하세요:
node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --plan.
짧은 요약을 보여주세요: 장면 수, 대상 대비 총 런타임, 클립 대 정지 이미지, 경고. 스토리를 변경하지 않고 해결할 수 있는 문제는 수정하세요. 해결할 수 없는 문제는 사용자에게 물어보세요.
4단계: 검토 버전 렌더링
검토 품질: 저해상도(약 360p), 높은 압축, 왼쪽 상단에 장면 번호와 시간 표시, 설정에서 자막이 내장(burned-in) 된 경우 자막 포함.
node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --version 1
- 출력:
render/review/<slug>_review_v1.mp4및 지속 시간, 크기, 음량이 포함된.report.json. - 장면 세그먼트는 캐시됩니다. 이후 검토에서는 변경된 장면만 다시 렌더링하므로 훨씬 빠릅니다.
- 몇 분 이상의 비디오의 경우 명령을 백그라운드에서 실행하고 완료될 때까지 기다리세요. 폴링하지 마세요.
- 자막 모드가
srt인 경우 비디오 옆에.srt파일이 작성됩니다.
보고서를 확인하세요: 실제 지속 시간과 계획된 지속 시간, 음량, 스트림. 그런 다음 사용자에게 전체 경로와 크기를 알려주세요.
검토 방법을 알려주세요: 파일을 시청하고, 각 댓글과 함께 모서리에 표시된 장면 번호와 시간을 기록하세요. Claude는 파일을 보내거나 업로드하지 않습니다. 사용자가 클라이언트와 공유합니다. 사용자가 요청하는 경우에만 업로드를 준비하겠다고 제안하고, 먼저 물어보세요.
5단계: 변경 사항 수집
"변경 사항이 있나요? 최종이라면 말씀해 주시면 고화질 버전을 렌더링하겠습니다."라고 물어보세요.
사용자는 클라이언트의 피드백을 붙여넣을 수 있습니다. references/review-feedback.md를 읽으세요. 각 댓글에 대해:
- 참조하는 장면 번호 또는 시간을 찾으세요. 댓글이 모호하면 짧은 질문 하나를 하세요.
- 분류하고 경로를 선택하세요:
- 편집 수준(트림, 길이, 순서, 자막 텍스트, 자막 켜기/끄기, 전환, 음성, 음악 또는 효과 레벨): 여기서
edl.json또는 스템의 게인을 수정하세요. - 장면의 영상(외관, 캐릭터, 구성, 움직임): 해당 장면에 대해
long-video-keyframes또는long-video-clips으로 돌아가세요. 새 파일은_take2스타일의 이름을 얻습니다. 그런 다음 편집 목록을 업데이트하세요. - 음성 라인(전달, 발음, 표현): 해당 라인에 대해
long-video-voice로 가세요. 승인된 스크립트에 대한 표현 변경은 사용자의 승인과 스크립트 수정이 필요합니다. - 사운드(효과음, 분위기, 음악): 해당 큐에 대해
long-video-sound로 가서 다시 믹스하세요. - 스토리 또는 구조(장면 추가 또는 제거):
long-video-director로 가서 영향을 받는 장면만 하류에서 다시 작업하세요.
- 편집 수준(트림, 길이, 순서, 자막 텍스트, 자막 켜기/끄기, 전환, 음성, 음악 또는 효과 레벨): 여기서
- 버전, 장면, 요청, 경로 및 상태와 함께 목록을
render/review-log.md에 작성하세요. - 사용자에게 짧은 표로 계획을 보여주세요. 크레딧이나 시간이 소요되는 재생성 전에 승인을 요청하세요.
- 변경 사항을 적용한 후 다음 검토를 렌더링하세요(
--version 2등). 모든 이전 검토 파일을 보관하세요. - 사용자에게 장면별로 변경된 내용과 새 파일 경로를 알려주세요.
사용자가 승인할 때까지 반복하세요. 침묵이나 "지금까지 괜찮아 보입니다"는 승인이 아닙니다.
6단계: 최종 비디오 렌더링
사용자가 특정 검토 버전이 최종이라고 명시적으로 말한 경우에만 진행하세요.
- 확인: "검토 v에서 최종 버전을 렌더링할까요?" 편집 목록이 해당 버전과 일치하는지, 검토 로그에 열려 있는 변경 요청이 없는지 확인하세요.
- 최종 품질: 설정의 해상도, 고품질 H.264(crf 18, slow 프리셋), AAC 192k, 대상에 대한 2패스 음량 정규화, 검토 레이블 없음. 설정에서 자막이 내장(burned-in) 된 경우에만 자막이 포함됩니다. 그렇지 않으면
.srt파일이 작성됩니다. - 실행하세요. 긴 비디오의 경우 백그라운드에서:
node <skill folder>/scripts/build-render.mjs render/edl.json final render/final
- 보고서와
ffprobe로 확인하세요: 지속 시간이 계획과 일치하고, 해상도와 fps가 올바르며, 비디오 스트림과 오디오 스트림이 각각 하나씩 있고, 음량이 대상 근처(약 1 LU 이내)이고 트루 피크가 -1 dBFS 미만인지 확인하세요. - 선택적으로 예상치 못한 검은 프레임과 긴 무음을 확인하세요:
ffmpeg -i FILE -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. 결과를 보고하세요. project.json을 업데이트하세요:"stage": "final-rendered","final_video": "<path>", 그리고 승인된 검토 버전.- 사용자에게 전체 경로, 크기 및 지속 시간을 알려주세요. 비디오 설명을 위해
sound/credits.md의 크레딧을 상기시키세요. long-video-publish(YouTube 제목 옵션, 설명, 태그 및 썸네일 프롬프트)로 계속할 것을 제안하세요. 사용자가 동의하는 경우에만 시작하세요. 게시하거나 업로드하지 마세요. 사용자가 요청하고 해당 단계가 존재하지 않는 한 다른 이후 단계를 시작하지 마세요.
규칙
- 특정 검토 버전에 대한 명시적인 승인 없이 최종 버전을 절대 렌더링하지 마세요.
- 승인된 스크립트를 절대 변경하지 마세요. 피드백에 필요하다면 경로를 지정하고 물어보세요.
- 사용자의 명확한 요청 없이 비디오를 보내거나, 공유하거나, 업로드하지 마세요.
- 이전 검토 렌더를 절대 삭제하지 마세요.
- 계획에 대한 사용자의 승인 없이 이미지, 클립, 음성 또는 사운드를 절대 재생성하지 마세요.
- 채팅 메시지는 짧게 유지하세요. 변경 목록은
render/review-log.md에 작성하세요.