/3d-video-studio
┌──────────────────────┐
│ "Why Drivers Started│ 제목은 행동에 대해 묻고, 발명품 이름은 언급하지 않음
│ Filming The Road" │
│ ◕‿◕ ▶ 💥 │ 훅: 사기꾼의 악행, 4초 안에 페이오프
│ loophole → greed │ 확대, 무표정한 반박, 두 번의 "하지만" 반전
│ quiet guy points ▣ │ 발명품 자체의 시점을 통해 공개
│ "that's how the ___ │ 태그가 제목에 답하고, 마지막 장면이 첫 장면으로 루프됨
│ was invented." │
└──────────────────────┘
단계를 순서대로 진행하세요. ⏸ 는 게이트를 의미합니다: 멈추고, 결과를 보여주고, 사용자의 답변을 기다리세요. 각 게이트에서 다음 단계가 무엇인지 말하세요. 현재 단계에 나열된 파일만 읽으세요.
SKILL_DIR="<base directory of this skill>"; ENGINE="$SKILL_DIR/engine"
KIT="$SKILL_DIR/kit"; [ -d "$KIT/node_modules/playwright" ] || KIT="$HOME/.claude/kit"
PY="$KIT/.venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$KIT/.venv/bin/python"
[ -d "$ENGINE/node_modules/three" ] && [ -x "$PY" ] || bash "$SKILL_DIR/setup.sh"
Node 18+, ffmpeg 및 Python 3.9+가 필요합니다. bash "$SKILL_DIR/setup.sh"가 나머지 (three.js, Playwright + Chromium, Parakeet 단어 타이밍 모델이 포함된 Python 가상 환경)를 한 번 설치합니다. 아래의 모든 Python 도구는 "$PY"로 실행하세요.
참조 프로필은 모든 게이트의 기준입니다.
PROFILE="$SKILL_DIR/story/examples/dashcam"에는 측정된 숫자(profile.json), 각 설정의 프레임(frames/) 및 각 전환의 모든 프레임(transitions/)이 있습니다.- 사용자가 새 참조를 가져오면 먼저 해당 프로필을 구축하고("아래 새 참조에서 학습")
PROFILE을 가리키도록 하세요. - 프레임은 공개 저장소에 포함되지 않습니다.
story/examples/dashcam/및story/examples/cashier/에는 측정된 숫자(profile.json)와 작성된 비트 시트가 있지만 참조의 프레임은 없습니다(원래 채널에 속함).$PROFILE/frames가 없으면 사용자에게 참조 비디오를 요청하고(이 형식의 모든 숏폼이 작동함) "아래 새 참조에서 학습"의 2단계를$PROFILE을 출력 폴더로 하여 4단계 전에 실행하세요. 사용자에게 참조 비디오가 없으면profile.json과 작성된 예제만으로 판단하고 각 게이트에서 그렇게 말하세요. - 절대 우리 프레임만으로 판단하지 마세요: 모든 검토 시트에는 참조를 우리 것 옆에 놓습니다.
1단계 · 주제 ⏸
story/topic-bank.md를 읽으세요. 사용자의 주제를 사용하거나 세 가지를 제안하세요. 4가지 질문 테스트를 실행하고 가장 약한 체크 항목을 말하세요.
게이트: 사용자가 주제를 선택합니다.
2단계 · 제목 및 스크립트 ⏸
story/title-formula.md, story/formula.md, story/hook-rules.md, story/script-template.md, story/script-check.md를 읽으세요.
또한 story/rig-check.md(평면 캐릭터가 할 수 있는 것과 없는 것)를 읽고 "$PY" "$SKILL_DIR/tools/rig_check.py" <project>/script.json을 실행하여 점수를 매기기 전에 모든 플래그를 "Stage it as" 메모와 함께 표시하세요. 릭이 보여줄 수 없는 대사는 음성 녹음 전에 수정되어야 합니다.
먼저 제목을 쓰고, 그 다음 비트별로 스크립트를 작성하세요. 점수를 매기세요(9/10 미만은 다시 작성).
제목, 스크립트(한 줄에 한 문장, 비트 레이블은 옆에), 단어 수, 3.8단어/초로 추정한 길이 및 점수를 표시하세요.
게이트: 사용자가 승인하거나 편집합니다. 승인된 문장을 <project>/script.json으로 저장하세요(먼저 cp -r "$ENGINE/template" <project>로 프로젝트를 생성하세요; <project>는 존재하지 않아야 합니다).
3단계 · 비주얼 바이블 ⏸
look/style-guide.md(하우스 룩: 광택 있는 래커 표면, 초점이 맞는 모든 것에 잉크, 자연 채광, 약간 흐릿한 배경, 빽빽한 장식) 및 look/visual-bible.md(규칙 및 템플릿)를 읽으세요.
먼저 룩을 생성하세요: node "$ENGINE/cast.mjs" new <project> --chars <roles> --cars <roles>. 그런 다음 <project>/visual_bible.md를 작성하여 다음을 포함하세요:
- 모든 캐릭터(체형, 머리와 헤어, 16진수 색상 코드의 의상 레이어, 액세서리, 스토리에 필요한 얼굴 표정);
- 모든 환경(레이아웃, 표면, 보이는 광원, 벽당 4~8개의 드레싱 아이템, 정확한 텍스트 개그, 깊이);
- 인테리어(자동차, 부스, 스크린), 소품(주인공 발명품 전체) 및 2D 그래픽;
- 각 항목을
library + params,library + new text또는new로 표시하는 에셋 계획. 캐스트 출력과 함께 바이블을 보여주세요. 게이트: 사용자가 승인, 편집 또는 재생성을 요청합니다.
4단계 · 룩 시트 ⏸
스토리보드 전에 최종 디테일로 3D로 구축된 비주얼 디자인을 보여주세요. look/setup-types.md를 읽으세요.
lookdev.html,lookdev.js및sets.js는 템플릿과 함께 제공됩니다. 스토리에서 가장 분주한 셋을sets.js에 작성하세요(heroSet()은 하우스 룩의 예제입니다: 교체하고 레이어는 유지하세요). 바이블을 정확히 따라야 합니다. 비디오는 나중에 동일한sets.js를 가져오므로 이 작업은 버려지지 않습니다.lookdev.js는 이미 카드를 만듭니다:- 모든
cast.json캐릭터, 라벨이 있는 3명씩 줄지어; - 주인공의 얼굴 표정;
- 히어로 셋: 와이드, 렌즈 블러 10의 미디엄, 블러 14의 소품 클로즈업;
- 히어로 자동차.
히어로 소품에 대한 카드와 바이블이
new로 표시한 다른 모든 셋에 대한 카드를 추가하세요.
- 모든
- 스토리가 사용하는 설정 유형당 하나의 카드(
interior,pov,tracking,house,twoshot,talker,device), 각각 실제 셋과 실제 프레이밍으로 구축하고look/setup-types.md의 모든 "Must have"를 포함합니다. 대시보드 POV, 토커 벽 및 디바이스 뷰는 건너뛰기 쉬운 것들입니다; 지금 구축하세요. - 참조와 쌍을 이루세요:
"$PY" "$SKILL_DIR/tools/sbs_sheet.py" <project>/review/look_pairs.jpg --ours <cards> --ref <$PROFILE/frames에서 동일한 유형>. - 1:1 비율의 400px 크롭 스트립 하나를 추가하세요(게이지, 벽 개그, 차체, 도로). 누락된 디테일과 블러가 드러납니다.
node "$ENGINE/film.mjs" check <project> 0 <cards> 0.5 --page lookdev.html을 실행하고 모든 FAIL을 수정하세요(clipped-art포함: 캐릭터의 머리카락, 모자 또는 머리 아트가 가장자리에서 평평하게 잘린 경우). 그런 다음node "$ENGINE/film.mjs" sheet <project> <project>/review/look.jpg 0.5 1.5 2.5 ... --page lookdev.html --w 360 --cols 4를 실행하세요.- 코드로 점수를 매기세요:
node "$ENGINE/film.mjs" lookcheck <project> <project>/review/lookcheck 0.5 1.5 ... --page lookdev.html(광택, 윤곽선, 빛, 깊이, 밀도, 색상, 얼굴;look/targets.json에 대해 0~10). 모든LOW를 수정한 다음, 숫자로 판단할 수 없는 것(스토리 소품, 매력)을 위해 시트를 한 번 눈으로 확인하세요. 점수를 시트와 함께 표시하세요. 8단계에서 각 막의 프레임에 대해서도lookcheck를 실행하세요.review/look.jpg및review/look_pairs.jpg를 전달하세요. 게이트: 사용자가 캐릭터, 세계 및 모든 설정 유형의 룩을 승인하거나 수정 목록을 제시합니다. 비디오의 모든 셋은 이 수준의 디테일로 구축됩니다.
5단계 · 스토리보드 + 음성 스크립트 ⏸
한 번에 두 개의 문서:
- 스토리보드
<project>/storyboard.md: 카메라 설정당 한 행(18~21개):# | sentence(s) | beat | setup type | camera move | action and faces | prop gag | transition in (frames) | act/mood.story/formula.md("Picture and edit")의 규칙;story/examples/dashcam.md는 전체 예시를 보여줍니다.- 설정 유형은
look/setup-types.md의 이름 중 하나이며, 코드에서 샷의type이 됩니다. - 액션 및 표정은 엔진 포즈(
stand,walk,sitOn,point,lean,armTo…) 또는 모든 액션에 대한 소품을 지정합니다; 그 외의 것은story/rig-check.md에서 실패하므로 구축 전에 다시 작성합니다. - 카메라 이동: 모든 행은 이동과 속도를 지정합니다(예: "push-in 6%/s", "pull-back to wide", "orbit 120°"); 디바이스 뷰만 "locked"를 사용할 수 있습니다.
- 전환 진입: 디졸브는 7~10프레임(공개 장면의 경우 최대 16프레임)이거나 인월드 전환의 이름을 지정합니다. 셋, 캐릭터 및 소품은 승인된 비주얼 바이블에서 가져옵니다: 바이블에서 사용한 대로 이름을 지정하세요. 표 아래에, 스토리보드가 추가한 모든 항목과 함께 바이블의 에셋 계획을 복사하세요.
- 연속성 표(스토리보드 아래): 장소나 상태가 변경되는 모든 소품 또는 캐릭터는 한 줄을 가집니다:
thing: state → state → state, 각 변경의 설정 번호 포함(예:key: pocket (1) → floor (3) → dog's mouth (5)).- 모든 변경은 화면에서 명명된 설정에서 발생하거나, 시청자가 읽을 수 있는 화면 액션(던지기, 착지, 건네주기 등)으로 표시됩니다.
- 어떤 설정도 시청자가 본 적 없는 상태에서 시작할 수 없습니다. 보이지 않는 변경에 의존하는 이후 액션(아무도 떨어뜨리는 것을 보지 못한 것을 찾는 것)은 스토리보드 실패입니다: 설정에 액션을 추가하거나 설정을 추가하세요. 나레이션된 시간 점프를 가로질러, 일반적인 오프스크린 단계는 허용됩니다(숨긴 곳에서 티켓을 꺼내는 것).
- 각 소품에 스토리 오브젝트(플롯과 함께 이동) 또는 개그 소품(숨는 곳, 용기 또는 농담 대상으로 자체 비트에 머뭄) 레이블을 지정하세요. 새 위치의 개그 소품은 나레이션이 그곳에서 이름을 지정하지 않으면 실패합니다.
- 표 아래에, 위치당 하나의 운반 라인: 누가 거기 있는지, 각자가 무엇을 가지고 있고 왜 그런지.
- 현실 점검(
story/rig-check.md, 마지막 섹션): 모든 액션과 운반된 아이템은 실제 사람이 그 순간에 가질 이유가 있어야 합니다. 유일한 이유가 연속성이라면 행을 다시 작성하세요.
- 설정 유형은
- 음성 스크립트
<project>/voice/cartesia.md:story/voice-cartesia.md를 읽고 태그된 블록(블록당 감정, 속도 조언, "하지만" 반전과 태그 앞에서만 일시 정지)을 작성하세요.
둘 다 보여주세요. 게이트: 사용자가 스토리보드를 승인합니다. 그런 다음 음성을 요청하세요: "Cartesia에서 voice/cartesia.md의 블록을 생성하고 파일을 <project>/audio/에 넣으세요(vo_01.wav, vo_02.wav... 또는 하나의 vo.wav). 그동안 5초 미리보기를 빌드하겠습니다." 오디오를 기다리지 않고 6단계로 계속 진행하세요.
6단계 · 5초 미리보기 ⏸
훅(처음 5초, 일반적으로 설정 1~3)만 빌드하여 사용자가 긴 빌드 전에 룩을 판단할 수 있도록 합니다.
engine/API.md를 읽고; engine/template/video.js에서 블록을 복사하세요(engine/src는 열지 마세요). cast.json에서 모든 캐릭터와 자동차를 빌드하고(makeChar(CAST.characters.x), buildCar(CAST.cars.x)), stand/sit 포즈를 사용하세요.
- 타이밍:
sentenceStarts/captionsFromWords와 추정(estimateWords)을 사용하거나, 오디오가 이미 도착한 경우 실제 단어 파일을 사용합니다(7단계). ./sets.js에서 셋을 가져오고makeStage({ mood: withLook(mood, 'indoor' | 'outdoor') })를 사용하세요.- 판단 기준이 되는 룩은 승인된 룩 시트입니다: 광택 있는 표면의 깔끔한 3D, 초점이 맞는 모든 것에 잉크, 자연 채광, 약간 흐릿한 배경, 가장자리부터 가장자리까지 채워진 모든 프레임. 얼굴이 비어 있거나 머리 뒤쪽만 보이면 포즈 후에 카메라가 배치된 것입니다(
engine/API.md, chars.js 참조). - 모든 얼굴에
mark를, 모든 샷에type을 지정하세요.node "$ENGINE/film.mjs" check <project> 0 5 0.25를 실행하세요; FAIL이 있으면 종료 코드 1을 반환하므로 모두 수정하세요. - 하나의 시트:
node "$ENGINE/film.mjs" sheet <project> <project>/review/preview.jpg 0.2 0.8 1.6 2.6 3.6 4.6 --w 180 --cols 6. 한 번 보고 명백히 잘못된 것을 수정하세요. - 렌더링:
node "$ENGINE/film.mjs" render <project> <project>/review/preview.mp4 0 5(약 1분). 음성이 있으면 처음 5초를 추가하세요:ffmpeg -i review/preview.mp4 -i audio/vo.wav -map 0:v -map 1:a -c:v copy -t 5 review/preview_vo.mp4. - 훅을 참조의 훅과 비교하세요:
"$PY" "$SKILL_DIR/tools/compare_video.py" <project>/review/preview.mp4 "$PROFILE" <project>/review/cmp_preview --range 0 5;- 우리의 플라이아웃 스트립을
$PROFILE/transitions/옆에 놓으세요(플라이아웃은 약 4프레임 안에 유리를 통과하고 와이드 샷에 착지합니다). 미리보기를 보여주기 전에 움직임, 선명도 및 디테일의 FAIL을 수정하세요. mp4 경로와 쌍 시트를 전달하세요. 게이트: 사용자가 룩(캐릭터, 색상, 카메라, 캡션)을 승인하거나 변경을 요청합니다. 캐릭터나 스타일 변경은 여기서는 저렴하지만 나중에는 비쌉니다.
7단계 · 음성 입력
사용자가 오디오가 <project>/audio/에 있다고 말하면: story/voice-cartesia.md의 "When the audio arrives"를 따르세요(블록 결합, words.py, 길이와 속도 확인).
- 속도는 엄격한 게이트입니다: 초당 3.5~4.1 단어를 벗어나면(
film.mjs check가 실패 처리), 다른 속도로 새 녹음을 요청하고 느린 속도로는 빌드하지 마세요. 마지막 비디오는 3.4로 진행되어 참조의 62초에 비해 71초가 실행되었습니다. - 그렇지 않으면 계속하세요: 편집은 문장 번호를 기반으로 구축되므로 자체적으로 재타이밍됩니다. 8단계가 끝날 때까지 음성이 도착하지 않으면 다시 요청하세요; 음성 없이 최종본을 렌더링하지 마세요.
8단계 · 나머지를 막별로 빌드
각 막(1일, 2황혼/밤, 3비)에 대해 순서대로:
- 먼저
sets.js에 새 셋과 소품을 승인된 룩 시트 및 바이블의 디테일로 빌드하세요("Not built yet" inengine/API.md참조). - 막의 모든 설정에 대한 샷 블록, 각각
type, 스토리보드에 따른 전환(7~10프레임의dissolve,cashBurst()/paperBurst()를 사용한burst, 와이프 또는 하드 컷) 포함. - 막의 시간 범위에 대한
film.mjs check는 종료 코드 0(FAIL 없음)이어야 합니다. 가장 중요한 FAIL:slow-camera한계보다 느린 카메라(푸시인은 초당 6~10% 줌해야 함);- 유형의 크기 범위를 벗어난 히어로 얼굴;
- 5~12프레임을 벗어난 디졸브;
- 붙어 있는 오브젝트에서 떨어진 레이블(
decal-overhang): 스티커와 레이블을on: <surface>로 등록하세요; - 프레임 가장자리로 잘리거나, 머리에 가려지거나, 숨겨진 키 텍스트(
text-cut). 농담이 의존하는 모든 숫자, 가격, 화면 및 레이블을 셋 또는 샷이 구축될 때readable(mesh, label, { key: true })로 등록하세요.
- 막의 쌍 시트: 우리 설정 중간을 아래 행에, 동일한 비트의 참조 설정을 위에(
tools/sbs_sheet.py,$PROFILE/frames의 프레임). 막에서 1:1 비율의 400px 크롭 스트립 하나를 추가하세요. - 전환 검토: 막의 각 전환을 짧은 클립(
film.mjs render로 약 1초 범위)으로 렌더링하세요. 프레임별 스트립을 만들고$PROFILE/transitions/에 있는 동일한 종류의 참조 전환 옆에 놓으세요. 다음을 확인하세요:- 컷은 하나의 깨끗한 프레임에서 변경됩니다;
- 디졸브는 두 샷이 계속 움직이는 동안 완화된 곡선을 따릅니다;
- 버스트는 프레임의 약 2/3 이상을 덮지 않고, 다음 샷이 그 아래에서 페이드 인됩니다;
- 와이프 공개
...
[번역을 위해 일부 생략됨]