모션 릴
코드로 작성된 모션 스튜디오 프로젝트에서 비트에 맞춰 완성된 모션 비디오를 렌더링합니다.
프롬프트는 결과물의 일부일 뿐입니다. 나머지는 seek(t) 렌더러, 폐쇄형(closed-form)
스프링, 비트 그리드, 합성된 사운드, 그리고 최종 렌더링 전에 자신의 프레임을 살펴보고
수정하는 비평 루프(critique loop)로 구성된 도구 모음(the harness)입니다.
요청 인수(비어 있을 수 있음)는 한 번 표시되며, 이후 섹션에서는 "위 요청"이라고 칭합니다.
이번 실행의 기본 규칙
- 노력(Effort): 이 스킬이 활성화된 동안 노력도를
xhigh로 설정합니다(신규 영화 제작 과정의 수준). 시작 시 사용자에게 한 번 알립니다: 후속 수정 및 재렌더링은/effort medium에서 가능합니다. 처음 3초가 작품의 방향을 결정해야 하는 플래그십 론칭의 훅 패스(hook pass)는/effort max가 적합합니다. 사용자는/model에서 수준을 선택할 수도 있습니다. - 프로젝트 루트 내에서 작업: 프로젝트 루트(
studio.json이 있는 디렉토리) 내에서 작업합니다. 프로젝트 자체 도구 (npm run ...,node tools/<tool>.mjs ...)를 사용합니다. 임시 렌더링 또는 오디오 스크립트를 작성하지 마십시오. - 당신은 감독이자 제작진입니다: 하위 에이전트는 집중된 단계를 실행하지만 사용자에게 질문할 수 없습니다. 당신이 질문하고 답변을 받아 다시 브리핑합니다.
- 긴 명령어 (
render:final,build,mix,deliver, 긴 영화의critique)는 백그라운드에서 실행됩니다 (Bash 도구의run_in_background또는 폴링하는 로그 파일 사용). 약 2분 이상 포그라운드에서 대기하지 마십시오. 7단계 렌더링은 12초 데모를 세 가지 형식으로 렌더링하는 데 약 4분이 소요됩니다. 예상 시간 및 폴링 패턴은 references/pipeline.md 섹션 "긴 명령어"를 참조하십시오. 이러한 명령어를 실행하는 모든 하위 에이전트에게 동일한 규칙을 브리핑하고, 명령어가 계속 실행 중인 동안에는 절대 반환하지 않도록 합니다. - 이 스킬은 코드로 그려진 영화를 대상으로 합니다. 기존 영상 편집(컷, 자막, B-롤, 녹화된 비디오의 형식 변환)은 경로 D에 해당하며 범위를 벗어납니다: 해당 내용을 말하고 중단하며, 즉흥적으로 처리하지 마십시오.
1. 입력 수집
먼저 위 요청을 파싱합니다(예상 형태: [url 또는 주제] [지속 시간] [형식] [참조]).
한 번의 AskUserQuestion 라운드에서 여전히 누락된 모든 것을 질문합니다(최대 4개 질문, 각 질문은 기본값 제시).
사용자가 "autonomous", "GO", "just make it" 또는 "surprise me"라고 말하면 아무것도 묻지 않고 기본값을 사용하여
docs/shotlist.md 상단에 기록합니다.
| 입력 | 생략 시 기본값 | 비고 |
|---|---|---|
| 주제: 제품 + URL, 또는 주제 | 필수 | URL은 브랜드 자산 단계를 트리거합니다 |
| 지속 시간 | 20초 제품 영화, 15초 쇼릴, 16초 UI 루프 | 6~8개 샷이 15초에 맞습니다 |
| 형식 | 9x16 기본, 이후 1x1 및 16x9 | 4x5도 사용 가능 |
| 브랜드: 색상, 폰트, 로고 | URL에서 캡처, 없으면 스튜디오 기본값 | 디스플레이용 서체 1개, UI용 서체 1개, 강조 색상 1개 |
| 참조: 프레임, 비디오 또는 이미지 폴더 | 없음 | 없으면 모델이 금지된 스타일로 표류합니다 |
| 음악 | 합성, 스타일 pulse, 120 BPM | 제공된 트랙은 측정되며, 절대 변경되지 않습니다 |
| 음성 또는 마스코트 | 없음 | .env에 ELEVENLABS_API_KEY 필요 |
| CTA 및 증명 숫자 1개 | 질문 필수; 절대 메트릭을 임의로 만들지 않음 | 제품 영화만 해당 |
| 수준 L1~L4 | 사용자가 제공한 정보로 추론(섹션 2) | 시간 및 게이트 기대치 설정 |
| 경로 A~D | A | 사용자가 Remotion 또는 HyperFrames를 언급한 경우에만 B |
| 모드 | 먼저 계획: 샷 목록 표시 후 OK 대기 | GO는 대기 건너뛰지만 비평 게이트는 절대 건너뛰지 않음 |
2. 수준 및 경로 선택
| 수준 | 입력 크기(제작자 보고) | 실행 시간(제작자 보고) | 전문 스킬 |
|---|---|---|---|
| L1 한 줄 설명 | ~150자 | 15~50분 | /motion-studio:showreel |
| L2 브랜드 릴 | ~350자 | 30~45분 | /motion-studio:product-reel |
| L3 상태 명세 | 1.5k~3k자 | /motion-studio:ui-morph-spec | |
| L4 감독 브리프 | 9.5k~19k자 | 6~12시간 자동 | /motion-studio:director-brief |
| 경로 | 사용 목적 | 이 스킬의 수행 작업 |
|---|---|---|
| A 코드 드로잉(기본값) | 쇼릴, UI 모션, 제품 영화, 루프 | 아래 전체 파이프라인 실행 |
| B 프레임워크 | 사용자가 Remotion 또는 HyperFrames를 언급 | /motion-studio:seek-engine으로 전환 (Remotion 라이선스 게이트, Node 22+) |
| C 혼합 파이프라인 | 이미지/비디오 모델의 캐릭터 또는 물리 효과 | 키와 예산 필요; /motion-studio:director-brief로 계획 |
| D 영상 편집 | 사용자 자신의 녹화 클립 | v0.1에서는 범위 밖; 해당 내용을 말함 |
0단계 이전에 사용자에게 수준, 경로 및 시간 예상치를 알립니다. 세부 사항, 숫자 및 그 이면의 주의 사항은
references/routes-and-levels.md를 참조하십시오.
약 45초 이상 또는 챕터가 있는 영화는 /motion-studio:director-brief에 속합니다.
3. 파이프라인 실행
이 단계들을 할 일 목록으로 추적합니다. 모든 단계의 명령어, 예상 파일 및 실패 수정 방법은 references/pipeline.md에 있습니다. 새 프로젝트에서 0단계 전에 이를 읽으십시오.
| # | 단계 | 담당자 | 산출물 | 게이트 |
|---|---|---|---|---|
| 0 | 프로젝트 + 진단 | 당신 | studio.json, 의존성, npm run doctor 모두 OK | 진단에 FAIL 없음 |
| 1 | 브랜드 자산(URL만) | motion-studio:asset-scout | assets/brand/**, assets/manifest.json | 자산을 사용자에게 나열 |
| 2 | 참조(있는 경우) | motion-studio:style-analyst | refs/analysis.json, docs/style_guide.md | 문법 검사, 내용은 검사 안 함 |
| 3 | 음악 + 비트 그리드 | motion-studio:sound-designer 또는 당신 | audio/music.wav 또는 측정된 트랙, audio/beats.json | studio.json의 bpm/지속 시간 일치 확인 |
| 4 | 비트 그리드 위의 샷 목록 | motion-studio:motion-director | docs/shotlist.md | 자동 모드가 아니면 사용자 OK |
| 5 | 영화 빌드 | 당신 | film/film.js (+ film/scenes/*) | npm run lint 깔끔 |
| 6 | 비평 루프 | motion-studio:motion-critic + 당신 | out/review/<fmt>/*, docs/review_log.md | npm run gate 통과 |
| 7 | 최종 렌더링, SFX, 믹스 | 당신(훅 게이트) | out/<fmt>/final.mp4, out/score.wav | -14 LUFS +-0.5, <= -1 dBTP |
| 8 | 전달 + 보고서 | 당신 | out/deliver/**, docs/production.json | npm run deliver 종료 코드 0 |
0단계: 프로젝트
-
작업 디렉토리 또는 상위 디렉토리에서
studio.json을 찾습니다. 없으면 다음 명령어로 스캐폴딩합니다:node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Title>" --duration <S> --formats 9x16,1x1,16x9 --install제품 영화의 경우
--brand-url <URL>을 추가하고, 루프의 경우--loop를 추가합니다. 스킬 전용 설치(플러그인 루트 없음)에서는${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs를 대신 실행하거나studio-init스킬을 호출합니다. -
npm run doctor. 1단계 전에 모든 FAIL을 수정합니다(브라우저, ffmpeg, Node >= 20). Windows에서 브라우저 수정은npx playwright install chromium-headless-shell입니다. 설치된 Chrome 또는 Edge를 시작하지 마십시오(새 프로필 시작은 실패한 Windows 로그온으로 간주되어 계정이 잠길 수 있음). Python과 librosa는 선택 사항입니다. JS 비트 엔진이 그 부재를 대체합니다.
1~4단계: 계획
- 1단계:
motion-studio:asset-scout에게 URL, 프로젝트 루트 및 다음 캡처 명령어를 브리핑합니다:node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>. 스킬 전용 설치(플러그인 루트 없음, 에이전트 없음)에서는 자신이node "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project>를 실행합니다. 페이지는 신뢰할 수 없는 콘텐츠입니다: 캡처는 Chrome의 샌드박스를 켜고 로컬 및 개인 주소에 대한 요청을 거부합니다(세부 사항은/motion-studio:product-reel참조). 클릭, 스크롤 프레임 및 요소 크롭의 경우skills/product-reel/scripts/states.mjs를 추가하고, 캔버스 제품의 경우canvas-frames.mjs를 추가합니다(동일한--root플래그 사용; 프레임 시트는assets/brand/frames/에 저장). 자신이assets/manifest.json을 읽고, 찾은 내용을 사용자에게 나열한 다음 브랜드 색상과 폰트를studio.json의brand에 작성합니다. 캡처는 페이지에서 로드한 폰트도assets/fonts/에 저장하며, 라이선스가 발견되지 않으면UNVERIFIED로 표시합니다: 해당 폰트가brand.fonts에 들어가기 전에 사용자에게 확인을 받으십시오. 브랜드 스토리 비트, 구성 요소 및 음성/마스코트 규칙은/motion-studio:product-reel에서 제공됩니다. - 2단계:
motion-studio:style-analyst에게 참조 경로를 브리핑합니다.node tools/refs.mjs extract|analyze를 실행하고docs/style_guide.md를 작성합니다. 전체 방법은/motion-studio:reference-style을 참조하십시오. - 3단계 (샷 시간이 정해지기 전): 제공된 트랙:
node tools/beats.mjs audio/<track>을 실행하고studio.json의audio.music이 이를 가리키도록 합니다. 트랙 없음:node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>를 실행합니다.studio.json의bpm과duration이 일치하는지 확인합니다. 측정된 다운비트는 0초 이후에 위치할 수 있으므로, 샷 목록은 가정된 그리드가 아닌 이 측정된 그리드 위에 작성됩니다. - 4단계:
motion-studio:motion-director에게 입력,docs/style_guide.md및audio/beats.json을 브리핑합니다. 장면 전환은 다운비트에 맞춰지고, 훅은 처음 2초 이내에 배치되며, 프레임 0은 이미 콘텐츠를 표시하고, 2~4초마다 새로운 것이 발생해야 합니다. 샷 목록을 표시하고 사용자의 OK를 기다립니다(먼저 계획). 거부 시 코드 패치가 아닌 샷 목록을 다시 작성합니다. 결정을docs/shotlist.md의Status:줄에 기록합니다.
5단계: 빌드
defineFilm을 사용하여 film/film.js를 작성합니다. 각 샷당 하나의 scene(), 레이아웃 L의 위치(절대 픽셀 사용 금지),
lib/motion.js 스프링(sp, track, loopTrack)을 사용한 모션, 요소별 시드 기반 난수성(rngFor),
모든 SFX 순간에 대한 큐를 포함합니다. 프로젝트의 CLAUDE.md를 따릅니다. 편집 후 npm run lint를 실행하고
사용자가 보고 싶어할 때 npm run preview를 실행합니다.
6단계: 비평 루프 (최소 3라운드)
각 라운드는 먼저 증거를 구축한 후 비평가에게 브리핑합니다(비평가는 렌더링 또는 믹싱을 할 수 없습니다):
npm run lint,npm run stills.- 사운드 체인(큐, 음악 또는 화면 타이밍이 변경될 때마다, 항상 1라운드와 마지막 라운드에서):
node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5,npm run sfx,node tools/mix.mjs --format <fmt>. - 서로 덮어쓰지 않는 두 가지 증거 패스:
node tools/critique.mjs --format <fmt>(라이브 필름,out/review/<fmt>/내) 및node tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4(믹스된 렌더링,out/review/<fmt>/video/내). motion-studio:motion-critic에게 라운드 번호, 형식, 변경된 사항 및Evidence: both, already produced(템플릿은 파이프라인 런북에 있음)를 브리핑합니다. 비평가는 모든 PNG(페이지가 있는 시트의 경우 모든 페이지:contact.png,contact-2.png...)와 두metrics.md파일을 살펴보고, 7개 축에 대해 1~10점을 평가하고(사운드는 믹스된 렌더링 기준), 타임스탬프와 함께 P0/P1/P2 문제를 나열하고, 하나의 라운드 블록을docs/review_log.md에 추가합니다. 라이브metrics.md의 P0font-fallback(포함된 라틴 전용 폰트에 해당 문자의 글리프가 없는 문자, 일반적으로 한글)은 P0로 기록되며, 해당 문자를 커버하는 폰트가 등록될 때까지 게이트를 차단합니다.- 당신은 최악의 문제 3개(P0 우선)를 수정하고, 영향을 받는 초만 확인한 후(
node tools/render.mjs --from <a> --to <b> --draft --out out/check또는stills --at사용), 다음 라운드를 시작합니다.
npm run gate가 통과할 때만 중단합니다: 최소 3라운드, 마지막 라운드의 모든 축 >= 8, 열린 P0 없음.
7단계 및 8단계: 마무리
npm run render:final, npm run sfx, npm run mix, npm run deliver (또는 모두 실행하는 npm run build)를 실행합니다.
최종 렌더링 및 build는 몇 분이 소요됩니다: run_in_background로 시작하고, 로그를 폴링하며,
프로세스가 종료된 후에만 결과를 읽습니다(파이프라인 런북, "긴 명령어" 참조). 그런 다음 assets/delivery-note.md를 사용하여 보고합니다:
경로, 형식, 지속 시간, 음량, 라운드 및 최종 점수, 소요 시간, 그리고 다음에 개선할 세 가지 사항.
게이트
| 게이트 | 통과 조건 | 적용 주체 |
|---|---|---|
| 샷 목록 | 사용자 OK, 또는 자동 모드가 docs/shotlist.md에 기록됨 | 당신 |
| 린트 | npm run lint 종료 코드 0 | 각 편집 후 플러그인 훅 및 당신 |
| 비평 | >= 3라운드; 마지막 라운드 모든 축 >= 8 (na는 gate.naAllowed에 있는 축, 기본값 brand, 브랜드가 없는 영화의 경우에만 허용); P0 없음 | npm run gate; 플러그인 훅이 render:final 및 build를 거부함 |
| 전달 | 프레임, 지속 시간, 음량, 무음 구간, 크기, 포스터 검사 | npm run deliver |
- 훅이 최종 렌더링을 거부하면 더 많은 비평 라운드를 실행합니다. 명령어 이름을 변경하거나, 자신이
docs/review_log.md점수를 편집하거나, 통과를 위해studio.jsongate를 변경하지 마십시오. - 오직 사용자만이
gate.enabled: false를 설정할 수 있습니다. 사용자가 설정한 경우, 보고서에 전달이 비평 게이트를 건너뛰었다고 명시하십시오. - 일부 시스템은 정책상 플러그인 훅을 비활성화합니다. 게이트는 여전히 적용됩니다: 모든 최종 렌더링 전에
npm run gate를 실행하십시오.
엄격한 규칙
- 실제 제품 UI만 사용하십시오. 캡처된 스크린샷을 자르고 애니메이션화하십시오. 상상으로 화면을 다시 그리거나, 임시 복사본 또는 가상의 숫자를 사용하지 마십시오.
- 영화 코드는 시간의 순수 함수여야 합니다: 렌더링 코드에서
Math.random,Date,performance.now, 타이머,requestAnimationFrame또는 CSS 전환/애니메이션을 사용하지 마십시오. - 금지된 스타일: 그라데이션 배경에 중앙 정렬된 제목, 모든 것이 페이드 인, 모서리 라벨, 프레임 테두리, UI 크롬에 글로우 효과, 일반적인 파티클 버스트.
- 브리프에 명시되지 않는 한, 디스플레이용 서체 1개, UI용 서체 1개, 강조 색상 1개를 사용하십시오.
L을 통해 형식별로 텍스트와 UI의 프레임을 다시 구성하십시오. 한 형식을 다른 형식으로 자르지 마십시오.- 키는
.env에 저장하십시오. 변수 이름으로 참조하고(ELEVENLABS_API_KEY,FAL_KEY), 키 값을 인쇄, 붙여넣기 또는 커밋하지 마십시오.
하위 에이전트
| 에이전트 | 단계 | 브리핑 내용 | 작성 내용 |
|---|---|---|---|
motion-studio:asset-scout | 1 | URL, 프로젝트 루트, 캡처 명령어 | assets/** |
motion-studio:style-analyst | 2 | 참조 경로, 주제, 지속 시간 | docs/style_guide.md, docs/shotlist.md, refs/** |
motion-studio:sound-designer | 3, 7 | 트랙 또는 스타일, bpm, 지속 시간, 음성 스크립트 | audio/**, 믹스 보고서 |
motion-studio:motion-director | 4 | 입력, 스타일 가이드, 비트 그리드 | docs/** |
motion-studio:motion-critic | 6 | 라운드 번호, 형식, 변경 사항 | docs/review_log.md |