3D 비디오 공장
당신(Claude)은 채널의 프로듀서입니다: 주제, 대본, 3D 씬 코드를 작성하고, 음성을 생성하고, 렌더링하고, 비디오를 조립합니다. 사용자는 니치, 전략, 캐릭터 및 음성을 결정하고 각 단계를 승인합니다.
이 스킬의 폴더 = 이 SKILL.md가 있는 폴더(여기서는 <skill>이라고 함). 여기에는 다음이 포함됩니다:
template/— 복사할 준비가 된 전체 프로젝트 (엔진, make.py, doctor.py, 모델 채널, 3D 키트, 테스트 비디오).scripts/criar_projeto.py— 템플릿을 사용자 폴더로 복사합니다.references/— 상세 매뉴얼. 단계를 실행하기 전에 해당 단계의 매뉴얼을 읽으십시오 (아래 표).
| 단계 | 읽을 문서 |
|---|---|
| 도구 설치/구성 (Python, ffmpeg, Blender, 음성, MiniMax) | references/01-setup.md |
| 채널 생성: 니치, 전략, 아이덴티티, 새 캐릭터 | references/02-canal-e-personagem.md |
| "당신이 만든다" 공식 (참조 채널 형식) | references/03-formula-voce-constroi.md |
대본 .md + .json 작성 (카드, 하이라이트, 사운드, 리듬) | references/04-roteiro.md |
| 음성: edge-tts (기본) 및 MiniMax (선택 사항) | references/05-vozes.md |
| Blender 및 Python 3D 씬 (키트, 카메라, 캐릭터, 충돌, 렌더링) | references/06-blender.md |
| 프로덕션, 검토, 게시 및 메트릭 | references/07-producao-e-publicacao.md |
0. 사용자가 어느 단계에 있는지 확인하십시오
- 프로젝트 찾기:
make.py+pipeline/+canais/폴더 (찾을 수 없으면 위치를 물어보십시오). - 프로젝트 없음 → A단계. 자체 채널이 없는 프로젝트 (
canais/_modelo만 있음) → B단계. 채널 준비 완료 → C단계. - 한국어(또는 사용자 언어)로 대화하십시오. 비디오 콘텐츠의 언어는 B단계에서 결정됩니다.
A. 설치 (컴퓨터당 한 번)
- 프로젝트 폴더를 물어보십시오 (
~/videos-3d권장). 실행:python <skill>/scripts/criar_projeto.py <pasta>(Windows에 Python이 없으면 Blender의 Python 사용 — 01-setup 참조). references/01-setup.md를 따르십시오: 누락된 것을 설치하고python doctor.py --instalar를 실행하여 "모든 준비 완료!" 가 나올 때까지 반복하십시오.- 테스트 비디오(포르투갈어, ~26초)로 작동 확인:
python make.py video --canal _modelo --id 00-teste --stills 1,6,12,20→prancha.png를 사용자에게 보여주십시오; 그 다음python make.py video --canal _modelo --id 00-teste(전체 렌더링, 수 분 소요) →canais/_modelo/saida/00-teste.mp4. - 음성: 기본값은 edge-tts (무료, 계정 불필요). 사용자가 MiniMax (더 자연스럽고 유료, 키 필요)를 원하는지 물어보십시오.
원하는 경우 키 생성 및
.env설정을 안내하십시오 (05-vozes). 코드, 대본 또는 문서에 키를 절대 작성하지 마십시오.
B. 채널 생성 (온보딩 — 채널당 한 번)
references/02-canal-e-personagem.md를 따르십시오. 반드시 물어봐야 할 사항 요약 (선택지가 있을 때 AskUserQuestion 사용):
- 형식: 참조 채널과 동일한 형식("당신이 만든다": 시청자가 문제 해결을 위해 부품을 하나씩 조립하여 기계/구조물을 만드는 형식 —
03-formula-voce-constroi.md) 또는 자체 니치/형식을 사용하시겠습니까? 자체 형식: 사용자에게 니치, 아이디어, 참조 및 전략을 요청하십시오; 이를 참조 채널과 같은 단계별 공식(1초 후크, 긴장 사이클, 결론, CTA)으로 변환하십시오. - 콘텐츠 언어, 대상 및 플랫폼. 3. 이름/@ 및 아이덴티티 (색상, 톤). 4. 음성 (엔진 + 음성;
python make.py vozes --canal <c>로 샘플 생성). - 새 캐릭터 — 필수. 다른 채널의 캐릭터를 재사용하지 마십시오. 사용자와 함께
personagem.json을 구성하고, 렌더링(python make.py personagem --canal <c> --pose ideia)하고, 이미지를 보여주고 사용자가 승인할 때까지 반복하십시오.
python make.py novo-canal --canal <nome>으로 채널을 생성하고 estrutura.md, identidade.md, canal.json,
personagem.json을 채우십시오. 결정 사항을 estrutura.md의 "결정 사항" 섹션에 기록하십시오.
C. 비디오 제작 (비디오마다 반복)
다음 순서를 따르십시오 — 각 단계에는 사용자 승인 지점이 있습니다:
- 주제
estrutura.md의 아이디어 뱅크에서 (또는 새 제안) → 사용자가 선택합니다. - 맵 ("당신이 만든다" 형식: 문제 → 부품 → 이름 사이클 맵, 4~6 사이클 상승) → 승인.
- 조사: 각 사실과 숫자를 신뢰할 수 있는 출처에서 확인하고
.md에 출처를 기록하십시오. - 상세 대본
.md(roteiros/_modelo.md복사) + 체크리스트 → 승인. - 대본
.json(roteiros/_modelo.json복사) — 대사, 카드,highlight,punch,sons. - 음성:
python make.py video --canal <c> --id <id> --sovoz→ 총 지속 시간(timing.json)을 알리고 사용자에게build/<id>/audio/를 듣도록 요청하십시오. 텍스트를 조정하고 재생성하십시오 (캐시는 변경된 부분만 다시 만듭니다). MiniMax는 발화당 비용이 청구됩니다: 미리 검토하십시오. - 3D 씬:
kit/base.py+kit/personagem.py를 사용하는cenas/cena_<tema>.py(06-blender). 각 동작은W(cena, "palavra")로 단어에 연결됩니다.canais/_modelo/cenas/cena_teste.py의 구조를 복사하여 시작하십시오. - 스틸:
--stills 1,4,8,…(2~4초마다 하나) →prancha.png를 직접 읽고 (Read on image), 프레이밍, 캐릭터가 프레임을 벗어난 부분, 부품이 겹치는 부분을 수정한 다음 사용자에게 보여주십시오. - 충돌:
--colisao→ 경고 없음 (또는 예상된 접촉만,ignorar에서 처리). - 전체 렌더링 (백그라운드에서 실행; 720p ≈ 프레임당 1~2초) → 자동 조립 →
saida/<id>.mp4. - 최종 검토: ffmpeg로 MP4에서 프레임을 추출하고 자막/카드를 확인하십시오; 사용자가 소리와 함께 시청합니다.
- 게시: 제목, 설명, TikTok 자막, 해시태그, 고정 댓글 (07-producao). 메트릭 테이블에 기록하십시오.
항상 적용되는 규칙
- 세로 비디오 1080×1920, 30fps. 1초 안에 후크; 첫 이미지가 상황을 보여줍니다 (소리 없이도 작동).
- 형식을 복사하고, 저작물을 복사하지 마십시오: 다른 채널의 이름, 마스코트, 캐릭터, 대사 또는 아트워크는 사용하지 마십시오.
- 음성을 생성하기 전에 사실과 숫자를 확인하십시오. 시청자가 따라 하기에 위험한 지시는 없어야 합니다.
- 표준이 되는 모든 것(부품, 포즈, 효과, 배경)은
cena_*.py에서cenas/kit/로 이동합니다. - 채널별 번호:
01-tema,02-tema… — 대본, 빌드 및 출력에서 동일한 ID를 사용합니다. - 긴 렌더링: 백그라운드에서 실행하고 계속 확인하지 마십시오;
make.py가 진행 상황을 표시합니다. - 비디오가 준비되었다고 말하기 전에 프레임을 직접 확인하십시오.