Film academy
코드처럼 빌드되고 측정되고 수정되는 영화를 만드는 방법입니다. 영화를 웹 페이지로 작성하면 렌더러가 촬영하고, 믹서가 비트에 맞춰 사운드를 배치하며, 게이트가 이전 컷보다 느리거나 정적인 컷을 거부합니다. 소유자가 영화에 대해 말한 모든 것은 그대로 보관되며, 컷이 통과되기 전에 답변되어야 합니다.
모든 명령은 이 스킬의 폴더에서 실행됩니다(python film.py ...). ffmpeg, Python 3.9+, pip install playwright && playwright install chromium이 필요합니다. python film.py check 명령으로 누락된 항목을 확인할 수 있습니다. OCR(tesseract)은 선택 사항입니다.
시작하기: 제품 설명과 두 가지 명령 실행
소유자가 제품을 설명하고 영화를 원할 때:
- 스스로 만들 수 없는 것만 수집하세요: 이름, 하나의 약속(한 문장), 실제로 사실인 2-4개의 사실(증명 행), 가능하다면 실제 숫자 하나, 하나의 요청(URL), 그리고 제품이 웹 페이지인지 네이티브/폰 앱인지(화면 녹화 요청, 아래 참조). 주장이나 숫자를 절대 지어내지 마세요: 영화는 주어진 것만 보여줍니다. 한 번의 메시지로 질문하세요. 길이가 주어지지 않았다면 6-15초는 소셜 컷, 30-60초는 히어로 영화입니다.
python film.py new "<이름>" --promise "<약속>" --points "레이블=값|레이블=값" [--number "40%" --number-label "..."] [--slam "설명 불필요."] [--action "한 번 탭"] --url <url> [--music track.mp3 --drop-bar N] [--recording rec.mov]명령으로films/<slug>/film.json과 페이지를 작성합니다.python film.py make films/<slug>: 렌더링, 사운드, 게이트; 모든 make는 이전 빌드와 비교하여 번호가 매겨진 빌드(v1,v2, ...)입니다.--master옵션으로 1920x1080, 60fps로 마스터를 만듭니다.- 확인하기 (
python film.py sheet <film.mp4> films/<slug>/sheet.jpg로 이미지 생성 후 읽기; 비디오를 재생할 수 없음) 및 소유자에게 mp4 위치를 알립니다. - 취향은 그들의 몫입니다. 첫 번째 라운드는 적절하지만 일반적입니다. 그들에게 시청하고 무엇이 잘못되었는지 말해달라고 요청하세요; 모든 발언을 같은 턴에 그대로 저장합니다(
film.py note "<그들의 말>" --source "누가, 언제" --store films/<slug>/film-notes.json),film.json또는film.html을 변경하고, 각 노트를 새 빌드에 대해 태그합니다(film.py tick N1 --film <mp4> --where 0:04 --store ...), 다시make합니다. 게이트는 태그되지 않은 노트가 있는 빌드와 이전보다 느리거나 정적인 빌드를 거부합니다. - 소유자에게 명확히 말하세요: 게이트는 느려지거나 악화되는 컷을 잡아내지만 취향을 판단할 수는 없습니다; 그리고 작업은 그들의 Claude 토큰을 소모합니다(첫 번째 영화는 수만 개, 각 수정 라운드는 10-30k; 사용자 정의 장면은 더 많이 소모), 따라서 한 라운드에 여러 항목을 수정하고 여러 스틸 이미지 대신 하나의 콘택트 시트를 읽으세요.
네이티브 또는 폰 앱(웹 페이지 아님): 하나의 짧은 화면 녹화(5-10초, 하나의 작업, 알림 끄기, 개인 정보 화면에 없음)를 요청하고 python film.py import-recording rec.mov films/<slug> --start 2 --seconds 6 명령을 실행하세요. 녹화는 페이지가 창에 표시하는 프레임이 되어, 그려진 카드를 대체합니다.
페이지를 film.json 이상으로 변경하기 전에 playbook.md를 읽으세요(구조 및 편집 섹션 먼저, 음악 선택 전 사운드). 음악: 생성된 플레이스홀더가 기본값입니다; 저장소에 트랙을 절대 배포하지 마세요, 소유자가 제공한 트랙은 영화를 게시할 수 있는 라이선스가 필요합니다.
수동 파이프라인 (make가 수행하는 단계별 작업)
루프
- 한 번에 브리핑. 종류(프로모, 설명 영상, 소셜 컷), 영화가 하는 하나의 약속(한 문장), 길이, 재생 위치, 그리고 표시할 수 있는 것(소유자가 게시할 수 있는 자료만; 사용 권한을 명명할 수 없는 데이터는 안 됨). 소유자가 길이를 주지 않았다면 히어로 영화는 30-60초, 소셜은 15초. 영화 제작 방법을 묻지 마세요; 그것은 당신의 일입니다.
- 픽셀 전에 참고 자료. 같은 분야의 영화 2개 이상을 구하고(시청하고, 개인 공부를 위해 보관할 수 있는 것만 다운로드)
python film.py measure ref1.mp4 ref2.mp4를 실행하세요. 평균 샷 길이, 정적 공유 비율, 카드당 단어 수가 기준이 됩니다.playbook.md를 읽으세요: 작성 전 구조 및 편집 그룹, 믹싱 전 사운드 그룹. 참고 자료를 절대 복사하지 말고 숫자와 기법을 가져오세요. - 영화를 하나의 HTML 페이지로 작성 (
academy/template.html에서 시작;film.py new가 프로젝트에 복사합니다. 또한window.timeline()과window.cards()를 정의하여 게이트가 실제 컷과 카드 텍스트를 알 수 있게 합니다). 계약:window.seek(t)는 시간t에서 페이지를 순수 함수로 그립니다(타이머, 자동 재생 CSS 애니메이션 없음),window.duration()은 초를 반환,window.cues()는 프레임에 속하는 사운드에 대한[{t, sfx, db}]를 반환,window.ready는 폰트와 이미지에 대한 프로미스,window.MISSING은 로드에 실패한 에셋 목록(항목이 있으면 렌더링 실패). 장면 시작을 음악의 마디 그리드에 맞춥니다(bar = beats_per_bar * 60 / bpm). 결말로 시작(프레임 0은 그림), 하나의 약속, 늦게 나오는 핵심 순간, 브랜드는 초반과 엔드 카드에 다시 등장. - 렌더링 전에 확인. 모델은 비디오를 재생할 수 없음:
python film.py stills film.html out/stills 0,2.5,5로 PNG를 읽고;python film.py sheet film.mp4 sheet.jpg는 렌더링 후 초당 한 프레임을 하나의 이미지로 제공합니다. 보이는 것을 수정하세요. - 렌더링.
python film.py render film.html out/film.mp4 --fps 30 --size 1280x720 --workers 2(마스터의 경우--fps 60 --size 1920x1080사용). N개의 Chromium 워커가 각각 조각을 촬영합니다; 충돌한 워커나 누락된 에셋은 전체 렌더링을 실패시키며, 더 짧은 영화를 만들지 않습니다. 페이지의 큐는out/film.cues.json에 기록됩니다. - 사운드.
python film.py mix out/film.mp4 out/final.mp4 --plan plan.json --music track.mp3 --sfx sfx_dir --cues out/film.cues.json. 계획은 마디별로 음악 세그먼트를 나열하므로(track_bar->film_bar,bars) 모든 점프가 다운비트에서 시작됩니다; 마지막 코드는 엔드 카드 아래에서 울립니다. 음량은 -14 LUFS, 실제 피크 -1 dBTP(투패스 loudnorm)로 조정되며 이후 측정됩니다. 음악: 직접 준비하고, 영화를 게시할 수 있는 라이선스를 확보하세요(저장소에 트랙을 절대 배포하지 마세요); 효과음은<name>.wav입니다. 기본적으로 음성은 없습니다; 평평한 합성 음성은 없는 것보다 나쁩니다. - 긴 영화는 부분으로 나누기. 각 부분에 자체 페이지와 렌더링을 할당하여 여러 사람이나 에이전트가 병렬로 작업할 수 있게 한 다음,
python film.py join p1.mp4 p2.mp4 p3.mp4 --out film.mp4 --dissolve 0.5(각 부분의.cues.json은 전체 영화의 클록으로 이동)로 결합하고 전체에 대해 한 번 믹싱합니다. - 게이트.
python film.py gate --film out/final.mp4 --against previous.mp4 --refs ref1.mp4 ref2.mp4 --timeline times.json --bpm 120. 컷이 이전보다 느리거나, 더 정적이거나, 매우 짧은 샷이나 모든 비트에 컷이 폭발적으로 나타나면 중단합니다(exit 5); 카드당 단어 수와 음량에 대해 경고합니다. ffmpeg의 장면 점수는 부드러운 전환을 거의 인식하지 못하므로times.json에 실제 컷 시간을 제공하세요({"final": [2.0, 4.0, ...]}, 파일 스템이 키). 영화를 수정하고, 렌더링하고, 다시 게이트를 통과하세요. 이전 컷을 이기지 못하는 영화는 완료되지 않습니다. - 노트가 모든 컷을 묶습니다. 소유자가 영화에 대해 무엇이든 말할 때마다, 같은 턴에 그대로 저장하세요:
python film.py note "<정확한 말>" --source "누가, 날짜" [--means "당신의 해석"]. 게이트 전에, 각 노트를 정확한 파일과 답변된 위치에 태그하세요:python film.py tick N1 --film out/final.mp4 --where 0:04(타임스탬프 또는shot 7).film.py gate는 해당 파일 해시에 대한 태그가 없는 노트가 있으면 거부합니다(exit 6); 다시 렌더링하거나 음악을 바꾸면 새 파일이 되고 새 태그가 필요합니다.python film.py notes --film out/final.mp4는 열려 있는 노트를 나열합니다. 소유자의 말은 절대 편집되지 않습니다; 당신의 해석은--means에 들어갑니다. - 완성된 영화를 전달합니다. 소유자는 최종 컷(전체 해상도 마스터, 포스터용 스틸 이미지)을 봅니다. 애니매틱, 스토리보드 또는 반쯤 완성된 버전이 아닙니다. 초안을 보길 요청했다면 그들의 결정이지 기본값이 아닙니다.
유지된 규칙
- 소유자의 취향은 모든 점수보다 우선합니다: 게이트는 회귀와 죽은 컷을 잡아내지만, 더 나은 영화를 선택하지는 않습니다. 소유자가 영화의 좋고 나쁜 점을 말하면, 다음 영화를 위해 플레이북에 추가하세요.
- 측정이 이미 포함된 파이프라인 부분을 절대 재구축하지 마세요: 먼저 측정(
film.py measure)하고, 그런 다음 변경하세요. - 수정 사항은 이 폴더(플레이북, 페이지 템플릿, 계획)에 저장되며, 세션 후에 사라지는 프롬프트가 아닙니다.
- 참고 영화, 클립 또는 라이선스 트랙을 저장소에 넣지 마세요: 숫자만 저장합니다.
파일
| 파일 | 설명 |
|---|---|
film.py | 명령줄: new, make, import-recording, check, render, stills, join, mix, measure, gate, sheet, note, tick, notes |
academy/project.py, academy/template.html | new/make: 영화 프로젝트, 설정 기반 페이지 |
academy/render.py | 프레임별 Chromium 렌더러(병렬 슬라이스, ffmpeg) |
academy/mix.py | 마디선 음악 컷, 큐에 맞춘 히트, -14 LUFS를 위한 투패스 loudnorm |
academy/join.py | 디졸브로 결합된 부분, 큐 병합 |
academy/gate.py | 측정 및 검사 |
academy/notes.py | 축어적 노트, 파일 해시에 연결된 태그 |
playbook.md | 43개의 출처가 있는 기법과 게이트의 숫자 |
data/ | 참고 숫자(18개의 게시된 영화) 및 컷 제작 한계(205개 영화), 숫자만 |
example/ | 10초 원본 영화(bash example/build.sh): 가상 제품으로 new 후 make 실행 |