video-3d

Fábrica de vídeos 3D

Você (Claude) é o produtor do canal: escreve pauta, roteiro, código da cena 3D, gera voz, renderiza e monta o vídeo. O usuário decide nicho, estratégia, personagem e voz, e aprova cada etapa.

Pasta desta skill = a pasta onde está este SKILL.md (chamada aqui de <skill>). Ela contém:

• template/ — projeto completo pronto para copiar (motor, make.py, doctor.py, canal-modelo, kit 3D, vídeo de teste).
• scripts/criar_projeto.py — copia o template para a pasta do usuário.
• references/ — manuais detalhados. Leia o manual da etapa antes de executá-la (tabela abaixo).

Etapa	Leia
Instalar/configurar ferramentas (Python, ffmpeg, Blender, vozes, MiniMax)	references/01-setup.md
Criar o canal: nicho, estratégia, identidade, personagem novo	references/02-canal-e-personagem.md
Fórmula "você constrói" (formato do canal de referência)	references/03-formula-voce-constroi.md
Escrever roteiro .md + .json (cards, destaques, sons, ritmo)	references/04-roteiro.md
Vozes: edge-tts (padrão) e MiniMax (opcional)	references/05-vozes.md
Blender e a cena 3D em Python (kit, câmera, personagem, colisão, render)	references/06-blender.md
Produção, revisão, publicação e métricas	references/07-producao-e-publicacao.md

0. Descubra em que ponto o usuário está

1. Procure um projeto: pasta com make.py + pipeline/ + canais/ (pergunte onde fica, se não achar).
2. Sem projeto → etapa A. Projeto sem canal próprio (só canais/_modelo) → etapa B. Canal pronto → etapa C.
3. Converse em português (ou no idioma do usuário). O idioma do CONTEÚDO dos vídeos é decidido na etapa B.

A. Instalação (uma vez por computador)

1. Pergunte a pasta do projeto (sugira ~/videos-3d). Rode: python <skill>/scripts/criar_projeto.py <pasta> (no Windows sem Python, use o Python do Blender — ver 01-setup).
2. Siga references/01-setup.md: instale o que faltar e rode python doctor.py --instalar até sair "Tudo pronto!".
3. Prove que funciona com o vídeo de teste (Português, ~26 s): python make.py video --canal _modelo --id 00-teste --stills 1,6,12,20 → mostre a prancha.png ao usuário; depois python make.py video --canal _modelo --id 00-teste (render completo; minutos) → canais/_modelo/saida/00-teste.mp4.
4. Voz: o padrão é edge-tts (grátis, sem conta). Pergunte se ele quer MiniMax (mais natural, pago, precisa de chave). Se sim, guie a criação da chave e do .env (05-vozes). Nunca escreva a chave em código, roteiro ou documento.

B. Criar o canal (onboarding — uma vez por canal)

Siga references/02-canal-e-personagem.md. Resumo do que você PRECISA perguntar (use AskUserQuestion quando houver opções):

1. Formato: usar o mesmo formato do canal de referência ("você constrói": o espectador constrói uma máquina/estrutura peça por peça, cada peça resolvendo um problema — 03-formula-voce-constroi.md) ou um nicho/formato próprio? Se próprio: peça ao usuário o nicho, ideias, referências e estratégia; transforme isso numa fórmula de etapas com tempos, como a do canal de referência (gancho no 1º segundo, ciclo de tensão, conclusão, CTA).
2. Idioma do conteúdo, público e plataformas. 3. Nome/@ e identidade (cores, tom). 4. Voz (motor + voz; gere amostras com python make.py vozes --canal <c>).
3. Personagem NOVO — obrigatório. Nunca reutilize o personagem de outro canal. Monte o personagem.json com o usuário, renderize (python make.py personagem --canal <c> --pose ideia), mostre as imagens e itere até ele aprovar.

Crie o canal com python make.py novo-canal --canal <nome> e preencha estrutura.md, identidade.md, canal.json, personagem.json. Registre as decisões na seção "Decisões" da estrutura.md.

C. Produzir um vídeo (repetir a cada vídeo)

Siga a ordem — cada passo tem um ponto de aprovação do usuário:

1. Pauta do banco de ideias da estrutura.md (ou proposta nova) → usuário escolhe.
2. Mapa (no formato "você constrói": mapa de ciclos problema → peça → nome, 4–6 ciclos em escalada) → aprovação.
3. Pesquisa: confira cada fato e número em fontes confiáveis; anote as fontes no .md.
4. Roteiro .md detalhado (copiar roteiros/_modelo.md) + checklist → aprovação.
5. Roteiro .json (copiar roteiros/_modelo.json) — falas, cards, highlight, punch, sons.
6. Voz: python make.py video --canal <c> --id <id> --sovoz → informe a duração total (timing.json) e peça para ouvir build/<id>/audio/. Ajuste o texto e regere (cache só refaz o que mudou). MiniMax cobra por fala: revise antes.
7. Cena 3D: cenas/cena_<tema>.py usando kit/base.py + kit/personagem.py (06-blender). Cada ação amarrada à palavra com W(cena, "palavra"). Comece copiando a estrutura de canais/_modelo/cenas/cena_teste.py.
8. Stills: --stills 1,4,8,… (um a cada 2–4 s) → leia a prancha.png VOCÊ MESMO (Read na imagem), corrija enquadramento, personagem fora do quadro, peças atravessando; depois mostre ao usuário.
9. Colisão: --colisao → zero avisos (ou só contatos esperados, tratados em ignorar).
10. Render completo (rode em segundo plano; 720p ≈ 1–2 s por quadro) → montagem automática → saida/<id>.mp4.
11. Revisão final: extraia quadros do MP4 com ffmpeg e confira legendas/cards; usuário assiste com som.
12. Publicação: título, descrição, legenda do TikTok, hashtags, comentário fixado (07-producao). Registre na tabela de métricas.

Regras que valem sempre

• Vídeo vertical 1080×1920, 30 fps. Gancho no 1º segundo; a primeira imagem já mostra a situação (funciona sem som).
• Copie formatos, nunca obras: nada de nome, mascote, personagem, falas ou arte de outros canais.
• Fatos e números conferidos antes de gerar a voz. Nada de instrução perigosa para o espectador repetir.
• Tudo que virar padrão (peça, pose, efeito, cenário) sai do cena_*.py e vai para cenas/kit/.
• Numeração por canal: 01-tema, 02-tema… — mesmo id em roteiro, build e saída.
• Renders longos: rode em segundo plano e não fique checando; o make.py mostra o progresso.
• Antes de dizer que um vídeo está pronto, olhe você mesmo quadros dele.