菜单
Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | avatar-deploy |
| description | Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시. |
| user_invocable | true |
| tags | ["avatar","deploy","vtube","verification","storage"] |
| trigger | Vtube rig 를 ChatterBox 에 새 아바타로 배포·검증할 때 |
| version | 1 |
Vtube mini_cubism rig 를 ChatterBox 에서 선택 가능한 아바타로 꼽는다(배포 → 매니페스트 등록 → 실렌더 검증). 기계적 배포는 scripts/deploy-avatar.mjs 가 하고, 이 스킬은 그 위에 ①발굴(어느 rig=어느 캐릭터, 배포할 만한가) ②렌더 검증(성역) 을 얹는다. 검증 없이 "배포됨"으로 치지 않는다 — 업로드는 성공해도 rig 데이터가 깨져 안 그려질 수 있다.
_mini_rig 는 렌더 필수 — 배포 project.json 에 mini_rig.json 을 _mini_rig 로 인라인 안 하면 loader.ts:normalizeRig 가 아리아형 fallback bbox 로 그려 오작동(rigMath.ts 경고). deploy-avatar.mjs 가 병합하지만, mini_rig.json 이 없는 rig 는 배포 금지.character.json ≠ 배포 형식 — 소스 rig_v0_project/character.json(project_kind mini_cubism_v0)에 _mini_rig 병합해야 배포용 project.json 이 된다(단순 복사 아님). parts source_path 는 상대(parts/x.png), 로더가 base URL 자동 파생.*.supabase.co 를 직접 못 fetch. 렌더 검증은 배포한 것과 동일 병합 번들을 앱 same-origin public/<id>-test/ 로 스테이징 → ?project=/<id>-test/project.json(로더 origin 화이트리스트: same-origin 허용). 검증 후 public/<id>-test/ 삭제./<id>-test/project.json 이 200 이어도 index.html 일 수 있다. content-type 이 application/json 인지, 앞부분이 {"schema_version"... 인지 확인.RigAvatar(src/lib/pixi/rig)·AvatarInspectorPage(/avatar-inspect)는 아무 rig 나 렌더. DEV 는 window.__rigAvatar 노출. "aria" 는 캐릭터명이지 코드 전용 아님.--no-save 임시 설치, 검증 후 npm remove. 시스템 Chrome executablePath: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome, WebGL args --use-gl=angle --use-angle=swiftshader --enable-unsafe-swiftshader..env(VITE_SUPABASE_URL·SUPABASE_SERVICE_ROLE_KEY)에서 값 echo 없이 사용. deploy-avatar.mjs 가 .env 자동 로드.rig_v0_project.bak_*·_BROKEN 는 배포 금지. 캐릭터명은 Vtube/characters/*.yaml·config/pipeline_profile.*.yaml("(배포본)" 마커)로 매핑. character.json mtime 으로 최신 판단.deploy-avatar.mjs·publish-avatar-job.mjs 가 발행 전 scripts/qa-mouth-lips.mjs(립 안료 연속성: mouth_state_* 립안료/closed < 0.35 → FAIL)를 강제한다. AUTORIG 이 열린 입 상태를 입술 안료 없이 생성하면 발화 밴드(MouthOpenY 0.245~0.47)에서만 입술이 사라져 보여 정지 초상 검수로는 못 잡는다. FAIL 시 정공=자산 재생성, 임시=closed_master 크로스페이드(0.30→0.60, poon995 선례). 육안 판정 도구는 scripts/render-mouth-matrix.mjs(상태×각도 몽타주). 비상 우회 QA_MOUTH_SKIP=1.Explore(haiku)로 — 배포가능 rig(rig_v0_project/{character.json,mini_rig.json,parts/}, render_mode mesh) 목록 + 캐릭터명 + 이미 ChatterBox 에 있는지. 어느 걸 배포할지는 사용자 로스터 결정(프로덕션 쓰기라 확인).node scripts/deploy-avatar.mjs <rigDir> <id> <name> (id=소문자·숫자·하이픈). 병합·parts 검증·업로드·매니페스트 갱신·원격 완전성(전 parts 200)까지 자동. 코드 수정 0.templates/render-verify.mjs 참고 — 병합 번들 public/<id>-test/ 스테이징 → vite dev → 헤드리스 /avatar-inspect?project=/<id>-test/project.json → __rigAvatar 생성·setParams 무예외·스크린샷 육안 확인·콘솔에러 0.rm -rf public/<id>-test; pkill -f vite; npm remove --no-save playwright-core.avatars/manifest.json 에 항목 추가됨 → 설정에서 선택 가능. evidence-review 로 결과 기록.__rigAvatar 생성 + 스크린샷을 실제로 열어 캐릭터가 온전히 그려졌는지 육안 확인(parts 조립·색·표정). 업로드 성공만으로 "됨" 처리 금지.package.json 에 playwright 잔존 없음._mini_rig 미병합(함정 1) 또는 parts 누락. 스크립트의 parts 검증·원격 200 재확인.project.json JSON 파싱 실패 → vite SPA fallback(함정 4). 스테이징 실파일 확인.ERR_NAME_NOT_RESOLVED → 프로덕션 URL 직접 로드(함정 3). same-origin 스테이징으로.src/lib/avatars.ts(fetchAvatarPresets = Storage avatars/manifest.json 동적 로드, 재빌드 없이 반영)·isValidAvatarUrl(우리 버킷 project.json 만 저장 허용). 렌더: src/lib/pixi/rig(RigAvatar).avatars/<id>/project.json + avatars/<id>/parts/*. 캐릭터 "aria/akane/ruby/yuki" 는 실제 캐릭터.avatars 테이블, 유저별 avatars/<userId>/.ChatterBox 허브 맵 파이프라인 — 광장/구역 블록·내부 관(館) 원화 생성→핫스팟·앵커 캘리브레이션→manifest 배선→유도 3단 인터랙션→E2E. 새 맵(밤 variant·신규 구역 블록·새 내부 관·다른 씬 허브)을 만들 때 사용. 화풍 고정 생성은 scene-pipeline 참조.
ChatterBox 씬 에셋 파이프라인 — 화풍 고정 이미지 생성(gpt-image edits+레퍼런스)→WebP→매니페스트 등재, 입장 영상(Seedance i2v→Topaz 업스케일→WebM). 새 씬/시간대 variant/씬 영상을 만들 때 사용.
Vtube AUTORIG rig 를 ChatterBox 아바타로 배포(Storage 업로드 + 매니페스트 등록)하고 네이티브 렌더러로 실렌더 검증하는 하네스. character.json+mini_rig.json 병합·_mini_rig 렌더필수·헤드리스 same-origin 스테이징 등 매번 재발견하던 함정을 고정. "아바타 배포/추가/넣기/Vtube 아바타 온보딩/새 캐릭터 슬롯" 요청 시.
ChatterBox 음원 자산 파이프라인 — BGM/앰비언트/SFX 를 프롬프트로 생성(fal Stable Audio 2.5 · CassetteAI SFX) → 주인님 청취 게이트 → loudnorm+AAC → public/sounds/ 안착. "BGM 만들어", "음원 생성", "효과음 뽑아", "앰비언트", "사운드 추가" 요청 시. 2026-07-13 G6 BGM 3곡 세션에서 밟은 함정을 고정.
구현 완료 슬라이스를 프로덕션에 올리고 라이브로 실증한 뒤 문서·커밋까지 닫는 일괄 마감 절차 — db push(서울 pooler)·함수 deploy(재시도·실측)·CF Pages·프로드 통합/2탭 E2E·백로그 §0/GAP/drift 문서 마감. "배포하고 라이브테스트", "라이브로 올려", "페이즈 마감", "배포 몰아치기" 요청 시.
ChatterBox 프론트(Vite SPA)를 Cloudflare Pages 에 배포하고 실렌더로 검증하는 하네스 — 2계정 non-interactive 선택·프로젝트 선생성·account_id env 전용·번들 비밀키 감사·SPA폴백·헤드리스 React 마운트 확인 등 매번 재발견하던 CF 배포 함정을 고정. "CF 배포/프론트 배포/pages 배포/배포판 검증/재배포/ㄱ 배포" 요청 시.