Studio init (코스 스텝 02)
자체 프레임을 렌더링하고, 듣고, 볼 수 있는 필름 프로젝트를 생성합니다. 채팅 앱은 애니메이션을 작성할 수 있지만, 셸을 가진 에이전트만이 렌더링을 닫고, 보고, 루프를 수정할 수 있습니다. 그 루프가 "그냥 그런" 첫 시도와 공유할 가치가 있는 필름을 구분짓는 차이입니다.
요청 인수(비어 있을 수 있음), 한 번 표시:
1. 디렉토리 및 설정 선택
- 디렉토리: 첫 번째 인수; 작업 디렉토리가 비어 있으면
.; 그 외에는 묻습니다(기본값./<제목-슬러그>). 플러그인 디렉토리 안에는 절대 스캐폴드하지 마십시오. - 요청의 설정: 제목, 길이, 포맷, fps, bpm, 루프, 브랜드 URL. 나머지는 템플릿 기본값으로 둡니다(
studio.json: 12초, 60fps, 4서브프레임, 120BPM,9x16기본).
2. 스캐폴드
node "${CLAUDE_SKILL_DIR}/scripts/init.mjs" <dir> --title "<Title>" [--duration S] [--fps N] [--bpm N] [--formats a,b] [--loop] [--brand-url URL] [--install] [--json]
| 플래그 | 효과 |
|---|---|
<dir> | 대상; 없으면 생성 |
--title T | studio.json 제목 및 전달 파일 슬러그 |
--duration S, --fps N, --bpm N | 타이밍 |
--formats a,b | 9x16, 1x1, 16x9, 4x5의 하위 집합(또는 all); primaryFormat은 목록에 없어도 유지됨 |
--loop | 끊김없는 루프 필름(UI 변형) |
--brand-url URL | 제품 URL을 brand.url에 저장합니다. user:password@ 및 비밀처럼 보이는 매개변수(쿼리, ;matrix, 프래그먼트: token, key, secret, password, auth, sig, session, code ...)는 기록되기 전에 제거됩니다. stderr에 제거된 내용이 이름으로 출력되고 --json은 redacted에 나열합니다. 여전히 일반 공개 URL을 전달하십시오: bare 경로 세그먼트(/reset/<토큰>)인 비밀은 인식할 수 없습니다. 일반 URL은 입력된 그대로 저장됩니다. |
--install | 새 프로젝트에서 npm install을 실행합니다(Windows에서 npm.cmd 처리) |
--force | 기존 프로젝트를 현재 템플릿으로 새로고침합니다(아래 표 참조) |
--json | stdout에 하나의 JSON 결과 줄을 출력합니다 |
기존 비어 있지 않은 디렉토리는 병합됩니다: 누락된 파일만 추가되고 건너뛴 파일은 나열됩니다. 건너뛴 목록을 사용자에게 보고하십시오. 절대 그들의 파일을 삭제하지 마십시오.
기존 프로젝트에 --force(init.mjs에 대해 확인):
| 경로 | --force 사용 시 |
|---|---|
studio.json, film/**, docs/**, assets/fonts/fonts.json | 유지되고 kept로 나열됨; 누락된 것은 여전히 생성됩니다. --bpm과 같은 플래그는 여전히 studio.json을 패치합니다 |
package.json | 병합되며, 절대 대체되지 않음: type: module 설정, private, engines 및 프로젝트에 없는 모든 템플릿 스크립트 또는 종속성을 추가합니다. 명령이 다른 템플릿 스크립트는 템플릿 명령으로 재설정됩니다(init는 각각 was ..., now ...로 출력하고 packageReset에 반환). 종속성 버전은 절대 변경되지 않으며, 템플릿 종속성도 포함됩니다: 기존 범위는 유지되며, 더 새롭거나, 오래되었거나, 고정되어 있어도 마찬가지입니다. 이름, 버전, 다른 스크립트 및 다른 필드는 유지됩니다 |
.gitignore | 병합됨: 누락된 템플릿 줄이 # motion-studio 아래에 추가되며, 아무것도 제거되지 않음 |
그 외 모든 것(CLAUDE.md, lib/**, tools/**, prompts/**, index.html, .env.example, 번들 폰트) | 덮어쓰기되고 overwritten으로 나열됨. 이 파일에 대한 로컬 편집 내용은 손실됩니다: 먼저 커밋하거나 복사하십시오 |
| 사용자 자신의 추가 파일 | 건드리지 않음 |
--force 없이, package.json 및 .gitignore는 동일하게 병합되지만, 다른 스크립트는 사용자의 명령을 유지합니다. Init는 템플릿과 다른 모든 스크립트 및 종속성 버전을 kept your package.json values, which differ from the template 아래에 나열합니다(--json 결과에서 packageKept): 해당 npm run 이름은 사용자의 명령을 실행하며, --force는 템플릿 스크립트를 재설정합니다(종속성 버전은 절대 변경되지 않음). 객체가 아닌 scripts, devDependencies 또는 optionalDependencies 섹션은 경고와 함께 그대로 둡니다. docs/**가 유지되므로, 최신 템플릿 문서는 기존 프로젝트에 도달하지 않습니다: 업데이트 후 플러그인의 template/docs/와 수동으로 비교하십시오.
3. 설치, 브라우저, 닥터
--install없이, 프로젝트 내에서npm install을 실행합니다.playwright는 유일한 필수 종속성입니다.ffmpeg-static은 선택 사항이며 프록시 뒤에서 다운로드에 실패할 수 있습니다.- 브라우저(
npm run setup:browser는npx줄과 동일한 명령):- Windows:
npx playwright install chromium-headless-shell을 실행합니다(약 115MB 다운로드, 디스크 270MB).studio.jsonbrowser: "auto"는 번들된 헤드리스 셸만 시작하며, 설치된 Chrome이나 Edge는 절대 시작하지 않습니다. 이유: 설치된 Chrome이나 Edge를 새 프로필(모든 도구 실행 시)로 시작하면 Chrome이 Windows 계정의 빈 암호를 테스트하여 로그온 실패로 간주합니다. 측정된 랩탑은 10분 내에 10회의 로그온 실패 시 계정을 잠그며 24시간 동안 464회를 기록했습니다. 사용자가 요청하고 위험을 수락하지 않는 한browser를chrome또는msedge로 전환하지 말고,MOTION_CHROME_PATH를chrome.exe또는msedge.exe로 설정하지 마십시오. 위험을 수락하면 실행 시 경고를 출력하고 10분 내 4번째 실행은 거부되며, 3번은 통과합니다(실행 가드). 셸은 서명되지 않았으므로 실시간 안티바이러스가 모든 도구 실행을 15~25초 느리게 만들 수 있습니다(측정됨): 사용자에게 한 번 알리십시오.%LOCALAPPDATA%\ms-playwright에 대한 안티바이러스 제외는 사용자 또는 IT의 결정입니다. - macOS 및 Linux:
auto는 설치된 Chrome, 그 다음 Edge, 그 다음 번들 브라우저를 경고 없이 시도합니다. 아무것도 설치되지 않은 경우npx playwright install chromium-headless-shell을 실행합니다(Linux:npx playwright install --with-deps chromium-headless-shell), 또는MOTION_CHROME_PATH를 Chromium 계열 실행 파일로 설정합니다.
- Windows:
npm run doctor. 인계하기 전에 모든 FAIL 행을 수정하고, Windows에서는 WARN 브라우저 행도 수정합니다(설치된 Chrome 또는 Edge가 선택된 경우: 지우고 헤드리스 셸 설치); OS별 수정 사항은 references/troubleshooting.md에 있습니다. librosa가 포함된 Python은 선택 사항입니다(JS 비트 엔진이 대체). Node 22+는 경로 B 도구에만 필요합니다.- 증명:
npm run stills를 실행한 다음out/review/9x16/contact.png를 열고(긴 필름은 페이지로 나뉩니다:contact.png는 1페이지, 그 다음contact-2.png..., 페이지 높이가 1800px를 넘지 않음; 모든 페이지를 열어보십시오) 확인합니다. 제공된 12초 데모는 0초에 구성된 프레임과 모든 다운비트에서 변경 사항을 보여주어야 합니다.npm run preview는 라이브 미리보기를 엽니다(Space 재생/일시정지, 화살표 프레임 이동, F 포맷 순환, G 안전 영역 가이드).
4. 사용자에게 프로젝트 설명
몇 줄로 요약한 다음 참조를 안내하십시오:
- 레이아웃 및 편집 주체: references/project-layout.md
- 모든 명령: references/commands.md
- 모든
lib/서명 및 기본값: 새 프로젝트의docs/API.md(전체 참조는 플러그인 저장소의docs/ARCHITECTURE.md) - 하우스 룰은 프로젝트의
CLAUDE.md에 있으며, Claude Code가 실행될 때마다 읽습니다.
Init가 ★ 별 줄을 출력한 경우(--json 결과에서 starHint; 머신당 한 번, 첫 번째 새 프로젝트에서 나타남), 그 한 줄을 그대로 요약 끝에 추가하십시오. 저장소에 별표를 주거나 사용자를 위해 gh를 실행하지 마십시오.
| 명령 | 기능 |
|---|---|
npm run preview | 브라우저에서 라이브 미리보기 |
npm run stills | 비트당 하나의 스틸 이미지를 연락처 시트로 |
npm run critique | 연락처, 스트립, 폰 테스트, 메트릭, 리뷰-로그 블록 |
npm run gate | 비평 게이트: 3라운드, 모든 축 >= 8, P0 없음 |
npm run render:final | 모든 포맷, 최종 품질(게이트 적용) |
npm run sfx / npm run mix | 큐 SFX 합성 / -14 LUFS로 믹싱 및 먹싱 |
npm run deliver | 전달 확인 및 out/deliver/ 패키지 |
npm run build | 점수 없으면 생성, sfx, 최종 렌더링, 믹스, 전달 |
5. 노력 및 경로
| 작업 | 노력 | 설정 방법 |
|---|---|---|
| 작은 수정, 재렌더링 | medium | /effort medium |
| 새 필름 | xhigh | /effort xhigh(motion-reel 스킬이 자동 설정) |
| 플래그십 첫 3초 런칭 | max | /effort max |
/model은 Opus 5.5를 선택할 때 노력 선택도 제공합니다. 경로 A(이 엔진)가 기본값입니다. 사용자가 이름을 지정할 때만 Remotion 또는 HyperFrames를 사용하십시오. /motion-studio:seek-engine에는 Remotion 라이선스 게이트를 포함한 핸드오프가 있습니다.
6. 키
키가 필요할 때만 .env.example을 .env로 복사하십시오(음성: ELEVENLABS_API_KEY; 경로 C 이미지/비디오: FAL_KEY). 사용자에게 값을 .env에 직접 붙여넣도록 안내하십시오. 프롬프트 및 로그에서는 변수 이름만 참조하십시오. .env는 이미 프로젝트 .gitignore에 있습니다.
7. 선택적 동반자
관련이 있을 때만 언급하십시오. 설치 명령 및 주의사항: references/companions.md.
| 동반자 | 용도 | 참고 |
|---|---|---|
| claude-animation (buildwithhanif) | 손그림, 브러시, 스토리북 스타일 | MIT; 별도의 Node Canvas 렌더러 |
| HyperFrames (heygen-com) | HTML + GSAP 구성 | Apache-2.0; Node 22+ |
| Remotion | React 시리즈 및 템플릿 | 3명 초과 직원의 영리 조직은 회사 라이선스 필요 |
다음: /motion-studio:showreel로 엔진을 테스트하거나 /motion-studio:motion-reel로 실제 필름을 만드십시오.