코부타이 캐릭터

코부타이 캐릭터은(는) 무엇을 하나요?

코부타이(小舞台)는 브라우저 확장 프로그램이자 데스크톱 앱입니다: 음악, 비디오, 라이브 스트리밍 또는 팟캐스트가 재생되는 동안 페이지 위에서 작은 치비 캐릭터가 공연합니다. 이 스킬은 사용자가 좋아하는 캐릭터 이미지(또는 설명)를 코부타이가 가져올 수 있는 캐릭터로 변환합니다:

업로드 ─► 캐릭터 카드 ─► 프로필 시트 + 기본 포즈 ─► 상태 GIF ─► make_pack.py ─► pet.json + spritesheet.webp

사용자의 언어(영어, 일본어 또는 중국어)로 답변하세요. 이미지 프롬프트는 영어로 유지하세요.

필요한 단계에 도달하면 다음을 읽으세요:

• references/kobutai-contract.md - 시트 형상, 어떤 GIF가 어떤 코부타이 상태가 되는지, 가져오기 및 공유 규칙
• references/prompts.md - 모든 이미지 프롬프트, 스타일 블록, 공연별 동작 목록
• references/originality.md - 타사 캐릭터, 오리지널 캐릭터(OC), 펫 및 실제 인물을 처리하는 방법

이미지 생성

모든 그림에 대해 호스트의 내장 이미지 생성 기능을 사용하세요:

• Codex: $imagegen 시스템 스킬(내장 image_gen 도구). 사용자가 명시적으로 요청하지 않는 한 Image API나 CLI를 호출하지 마세요; 그 경로는 사용자의 API 키가 필요합니다.
• ChatGPT: 기본 이미지 생성.

Images 2.6(2026년 11월)은 애니메이션 GIF를 반환할 수 있습니다. 모든 애니메이션 상태에 대해 GIF를 요청하세요. 호스트가 정적 이미지를 반환하거나 GIF 출력을 거부하거나 GIF를 사용할 수 없는 경우, references/prompts.md의 그리드 대체를 사용하세요(8프레임을 4×2 그리드 PNG로); make_pack.py가 이를 슬라이스합니다.

모든 상태 생성에 base.png(그리고 사용자의 업로드, "신원 참조용"으로 레이블 지정)를 첨부하세요. base를 첨부하지 않고 생성된 상태는 유효하지 않습니다: 다시 생성하세요.

진행 체크리스트

이 체크리스트를 표시하고 업데이트하세요(호스트에 작업 목록이 있는 경우 사용):

1. 캐릭터 읽기
2. 프로필 시트 그리기
3. 상태 애니메이션
4. 코부타이용 패킹
5. 검수 및 배달

워크플로

1. 캐릭터 읽기

모든 업로드된 이미지를 보고 RUN/character.json을 작성하세요(RUN = 워크스페이스의 kobutai-<id>/; ChatGPT에서는 /mnt/data/kobutai-<id>/). 필드와 예시는 references/prompts.md § 캐릭터 카드에 있습니다. 다음을 결정하세요:

• 모드 - references/originality.md에 따라 original / own / personal. 인식 가능한 타사 캐릭터의 기본값은 original입니다: 분위기, 색상 및 역할에서 영감을 받은 오리지널 캐릭터이지 복사본이 아닙니다.
• 스타일 - kobutai(하우스 치비 스타일, 내장 캐스트와 일치; 기본값) 또는 keep(업로드의 아트 스타일 유지, 여전히 작고 전신).
• 씬 - 콘텐츠가 재생되는 동안 캐릭터가 하는 일(노래, 춤, DJ, 악기 연주, 아늑하게 듣기, 시청 및 반응, 노트 필기...). § 공연 씬에서 선택하세요.
• 장르 / 유형 - 제안된 코부타이 태그, 나중에 확장 프로그램의 공유 대화상자에서 사용됩니다.
• 크로마 - #00FF00, 또는 캐릭터에 녹색이 포함된 경우 #FF00FF.

사용자에게 카드(이름, 한 줄 설명, 모드, 스타일, 씬, 태그)와 함께 하나의 짧은 메시지를 보내고 확인 또는 변경을 요청하세요. 사용자가 "go"라고 말하거나 신경 쓰지 않으면 기본값으로 진행하세요. 업로드에 명확한 단일 캐릭터가 없으면 어떤 캐릭터인지 물어보세요.

2. 프로필 시트 및 기본 포즈

1. § 프로필 시트로 RUN/profile.png를 생성하세요: 정면, 3/4면, 측면 및 후면 뷰, 네 가지 표정 및 팔레트 스트립, 텍스트 없음. 이것은 사용자의 모델 시트입니다. 사용자에게 보여주세요.
2. § 기본 포즈로 RUN/base.png를 생성하세요. profile.png를 첨부하세요: 평평한 크로마 배경 위에 하나의 편안한 전신 서 있는 포즈, 3/4면 뷰. 모든 상태는 이것에서 그려집니다.

신원(얼굴, 머리카락, 의상, 팔레트)이 잘못된 경우 여기서 수정하세요. 이후 모든 단계는 base.png를 복사합니다.

3. 상태 애니메이션

RUN/states/에 생성하세요. 파일당 하나의 작업, 매번 base.png를 첨부하세요:

파일	코부타이 용도	필수
idle.gif	대기 중, 아무것도 재생되지 않음	예
playing.gif	콘텐츠 재생 중 공연 루프(가장 중요)	예
paused.png	하나의 정지된 "당신을 기다리는" 포즈(코부타이는 단일 프레임 유지)	권장
appear.gif	등장, 캐릭터가 그려질 때 한 번 재생	권장
click.gif	톡톡 두드릴 때 반응, 한 번 재생	권장
error.gif	혼란 / 슬픈 루프	선택
walk.gif, review.gif	팩이 Codex 펫이기도 할 때만 사용	선택

선택한 씬의 동작 목록과 함께 § 상태 GIF를 사용하세요. 순서: idle과 playing을 먼저 하고, 확인한 다음 나머지를 하세요. 각 파일 후에 빠르게 확인: 같은 캐릭터, 약 8개의 고유한 프레임, 하나의 평범한 배경, 프레임 안의 전신, 동일한 기준선의 발, 텍스트 없음, 떠다니는 효과 없음. 실패한 상태를 § 수정으로 단독 재생성하세요. 하나의 나쁜 상태 때문에 전체 실행을 다시 시작하지 마세요.

ChatGPT 또는 $CODEX_HOME/generated_images/에서 다운로드한 GIF/PNG는 정확히 이 이름으로 RUN/states/에 복사되어야 합니다.

4. 패킹

python3 <skill_dir>/scripts/make_pack.py RUN                 # 코부타이 (행당 최대 8프레임)
python3 <skill_dir>/scripts/make_pack.py RUN --target codex  # 정확한 Codex 펫 프레임 수

Pillow + numpy가 필요합니다(pip install pillow numpy, scipy는 선택 사항). 스크립트는 배경을 키 아웃(또는 실제 투명도 유지)하고, 중복 프레임을 제거하고, GIF 간 스케일을 일치시키고, 발을 정렬하고, 1536×1872 Petdex/Codex 시트를 작성하고 코부타이 임포터가 하는 것과 정확히 동일하게 검증합니다. 옵션: --grid playing=4x2는 다른 레이아웃의 그리드 이미지용, --scale click=0.9는 하나의 소스가 너무 크거나 작게 나왔을 때, --key-low/--key-high는 고집스러운 배경용.

종료 코드 2는 검증 실패를 의미합니다. out/qa/report.json을 읽고 소스를 수정한 후 다시 실행하세요.

호스트가 Python을 실행할 수 없는 경우(일부 ChatGPT 설정), profile.png, base.png, 상태 파일 및 character.json을 zip으로 제공하고 사용자에게 로컬에서 동일한 명령을 실행하라고 알리세요.

5. 검수 및 배달

out/qa/contact.png와 out/qa/preview.gif를 열어 확인하세요. 다음과 같은 경우 거부하고 수정하세요:

• 행에서 얼굴, 머리카락, 의상, 팔레트 또는 소품이 변경된 경우
• 캐릭터가 프레임 간 또는 상태 간에 크기가 튀거나 옆으로 점프하는 경우
• 포즈가 셀 가장자리에서 잘리거나 배경에 색상 프린지나 반점이 남은 경우
• playing 루프가 시각적으로 정적이거나 idle이 큰 동작인 경우
• 약 120px 높이(코부타이가 표시하는 크기)에서 캐릭터를 더 이상 알아볼 수 없는 경우

그런 다음 배달:

1. <id>/pet.json + <id>/spritesheet.webp가 포함된 kobutai-<id>.zip
2. 보고 공유할 profile.png 및 preview.gif
3. 사용 방법(references/kobutai-contract.md § 가져오기 참조): 코부타이 → 가져오기 → pet.json과 spritesheet.webp를 함께 선택하세요. 선택 사항: 폴더를 ~/.codex/pets/<id>/에 복사하여 Codex 펫으로도 사용할 수 있습니다.
4. original 및 own 모드에만 해당: 확장 프로그램에서 주간 커뮤니티 라이브러리에 제출할 수 있습니다(내 가져온 캐릭터 → 모두와 공유, CC BY 4.0, 크레딧 이름 필요). 카드의 장르가 포함됩니다. personal 모드의 경우 본인만 사용할 수 있다고 말하세요.

RUN/(카드, 프로필, 기본, 상태)을 유지하여 나중에 "춤 더 빠르게" 또는 "클릭 재실행"이 하나의 상태만 재생성하도록 하세요.

비용

전체 실행은 약 8번의 이미지 생성(프로필, 기본, idle, playing, paused, appear, click, 선택적 error)과 수정 작업입니다. 두 번째 전체 실행을 시작하기 전에 사용자에게 알리세요.