CommunityImagemgithub.com

vector-avator

Transforme uma única ilustração de personagem em um avatar vetorial 2D em movimento para este repositório (vector-avator): reformate o estilo e crie duas folhas de personagem com Codex imagegen, faça o Fable 5.2 desenhar partes SVG apenas com preenchimento e regiões ocultas completas, verifique-as e reproduza gestos, viradas de cabeça, piscadas e sincronização labial no visualizador. Use quando o usuário quiser adicionar um novo personagem, refazer as partes de um personagem ou perguntar como o personagem de exemplo foi feito.

O que é vector-avator?

Este skill define o fluxo de trabalho completo para criar um avatar vetorial 2D animado a partir de uma única ilustração de personagem, no repositório vector-avator. Ele orienta o agente de IA (como Claude Code) através de etapas que incluem: definir as características do personagem, regenerar a arte em um estilo consistente com Codex imagegen (incluindo a criação de duas folhas de referência: uma com vistas de 360° e formas de mão, e outra com variações faciais), usar o Fable 5.2 para desenhar as partes vetoriais preenchidas (completando regiões ocultas como atrás do cabelo, orelhas e braços), realizar verificações estruturais automatizadas e validação visual, e finalmente testar o avatar em um visualizador interativo para avaliar gestos, viradas de cabeça, piscadas e sincronização labial. O skill também cobre a exportação de vídeo com ou sem áudio TTS. É essencial para adicionar novos personagens ao repositório, refinar partes existentes ou entender o processo de criação do personagem de exemplo (um coelho chamado 'usagi'). O roteiro otimiza o trabalho manual para apenas revisão, com o agente lidando com a maior parte da geração e correção.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/grmchn/vector-avator/tree/HEAD/.claude/skills/vector-avator

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

De uma ilustração a um avatar vetorial animado

Este é o procedimento para adicionar um novo personagem a este repositório (vector-avator). A partir de uma única ilustração do personagem, crie uma pose frontal em pé e uma folha de personagem com o estilo alinhado, faça o Fable 5.2 desenhar as partes vetoriais, verifique-as e, em seguida, mova o avatar no visualizador.

O exemplo é o coelho temporário (ID do personagem usagi. A arte original está em inputs/kariusagi/). Os arquivos concluídos de cada etapa estão em public/characters/usagi/vector/ e tools/vector/sheets/characters/usagi.*, então compare-os se tiver dúvidas.

0. Pré-requisitos

O diretório de trabalho é a raiz deste repositório. Todos os comandos abaixo são caminhos relativos à raiz.

FerramentaUsoEtapaComo verificar
Claude Code + Fable 5.2Obrigatório5. Divisão em partes (subagente)O modelo do subagente pode ser definido como Fable 5.2
Codex CLI (imagegen)Obrigatório2. Conversão de estilo, 4. Folhascodex --version, codex login concluído (funciona com o plano ChatGPT, nenhuma chave de API necessária)
Node 22, npmObrigatório7. Visualizador, 8. Vídeonpm install concluído
Python 3.10+Obrigatório2–6python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
resvgObrigatório6. Imagem de verificaçãoresvg --version (ex.: cargo install resvg)
Chromium do Playwright, ffmpegObrigatório7–8. Captura/Vídeonpx playwright install chromium, ffmpeg -version
MiniMax H3 (ComfyUI)Opcional3. Amostras de ânguloAPI do ComfyUI (padrão http://127.0.0.1:8188). Pule a etapa 3 se não tiver
TTSOpcional8. Áudio para sincronização labialSe não tiver, mova o avatar com sincronização labial de texto

Se o Fable 5.2 ou Codex imagegen não estiverem disponíveis, informe o usuário e pare. Substituir a divisão em partes por outro modelo resulta em qualidade insuficiente, conforme constatado.

Porta do servidor de desenvolvimento: O padrão é 5280 (npm run dev). Se estiver em uso, inicie com npx vite --port <porta> --strictPort e anexe VIEWER_URL=http://127.0.0.1:<porta>/ a todos os comandos de captura e exportação de vídeo (viewer_shots.mjs, record.mjs). Inclua essa URL na solicitação ao Fable.

Custos e tempo estimado (medições reais)

Medições reais ao criar o coelho temporário (47 partes). Para o segundo personagem em diante, incluindo tempo de espera, levou de 1 a 1,5 horas por personagem. O trabalho humano envolve apenas a listagem de características e a revisão.

EtapaResponsávelTempoTentativas
1. Notas do personagemClaude (principal)Aprox. 10 min—
2. Pose frontal em péCodex imagegenAprox. 4,7 min2 gerações, 1 adotada
3. Amostras de ângulo (opcional)MiniMax H3Aprox. 7 min1 vez
4. Duas folhas de personagemCodex imagegenAprox. 5 min1 cada
5. Divisão em partesFable 5.2Aprox. 16 min + correção aprox. 2,5 min1 + 1 correção
6–7. Verificação, confirmação, ajusteClaude (principal)Aprox. 20 min—
  • Codex imagegen leva cerca de 2 a 2,5 minutos por imagem. Se o limite de uso do plano ChatGPT for atingido, pode levar várias horas de espera. Para um personagem, são necessárias 1 a 2 imagens frontais e 2 folhas.
  • A divisão em partes do Fable 5.2 levou cerca de 22 minutos (49 partes) e 24 minutos (61 partes) para outros dois personagens.
  • Quando um agente sem conhecimento prévio criou um personagem (63 partes) usando apenas este Skill, pulou as amostras de ângulo e levou cerca de 43 minutos no total (4 imagegen, 1 Fable com aprox. 24 min e ~280k tokens, 0 retrabalhos).
  • Tokens e custos não foram medidos.

Fluxo geral

EtapaConteúdoFerramentaSaída
1Escreva as notas do personagem (características a preservar)Escrita manualtools/vector/sheets/characters/<id>.md · .json
2Converta a arte original para um estilo comum e crie uma pose frontal em pé (pose A)make.py gen <id> restyleref/front.png
3Extraia quadros de um vídeo de rotação de 360° (opcional)turntable.sh <id>ref/turntable.mp4, ref/angle_*.png
4Duas folhas (vistas de 360° + formas de mão, variações faciais)make.py gen <id> sheet_turnaround · sheet_faceref/sheet_turnaround.png, ref/sheet_face.png
5Desenhe partes apenas com preenchimento, completando regiões ocultasFable 5.2 + references/fable-brief.mdvector.json
6Verificação estrutural e inspeção visual das imagens de verificaçãocheck_parts.py <id>0 erros
7Mova e ajuste no visualizadornpm run dev, viewer_shots.mjsvector.json ajustado
8Exportação de vídeo e sincronização labialrecord.mjs, lipsync.pyMP4

ref/ é public/characters/<id>/vector/ref/. O ID do personagem deve ser alfanumérico em minúsculas (ex.: usagi). Imagens de teste e arquivos de trabalho do Fable são armazenados em var/vector/<id>/ (não comprometidos).

1. Escreva as notas do personagem

Em tools/vector/sheets/characters/<id>.md, liste em tópicos as características que devem ser preservadas mesmo após a mudança de estilo. Em <id>.json, escreva o caminho da arte original e sua função. Coloque a arte original em inputs/<id>/, etc.

  • O formato e o exemplo estão em references/character-notes.md. Exemplo do coelho temporário: tools/vector/sheets/characters/usagi.md · usagi.json.
  • Escreva as cores como valores aproximados (#RRGGBB).
  • O estilo comum (tools/vector/sheets/style_base.md) faz o personagem ser desenhado como "animal/criatura". Se isso mudar o personagem (ex.: pelos aparecendo em personagens sem pelos, redesenhar um personagem não humano como animal), anule mencionando especificamente "não desenhar ~" ou "não aplicar ~" nas notas. Não altere o arquivo de estilo comum.
  • Mesmo que a arte original esteja em uma pose em movimento (torção do corpo, braços dobrados), o redesenho para a pose frontal A é instruído por layouts/restyle.md. Não precisa escrever nas notas; adicionar "não usar a pose como referência" em roles do <id>.json ajuda a estabilizar.

Ao mesmo tempo, registre o personagem no visualizador. Isso é necessário quando o Fable verificar no visualizador na etapa 5. data/characters/<id>.json:

{ "id": "<id>", "label": "<Nome do Personagem>", "vector": { "url": "characters/<id>/vector/vector.json" } }

2. Pose frontal em pé (Codex imagegen)

.venv/bin/python tools/vector/sheets/make.py gen <id> restyle --count 2
.venv/bin/python tools/vector/sheets/make.py log <id>
.venv/bin/python tools/vector/sheets/make.py adopt <id> restyle <número>
  • O prompt é montado combinando "estilo comum + notas do personagem + o que desenhar (layouts/restyle.md)" e passado para o imagegen via codex exec. As tentativas são salvas em var/vector/<id>/gen/ com o prompt e o tempo gasto.
  • Sempre inspecione visualmente as imagens geradas, comparando-as lado a lado com a arte original. Pontos a verificar: reconhecível como o personagem, proporção de 2 a 2,5 cabeças, pose frontal A com espaço nas axilas, sem destaque nos olhos, sem olhos vesgos.
  • Se não corresponder, corrija com --note "instrução adicional" ou reescreva as notas do personagem (ex.: o coelho temporário parecia um personagem diferente devido ao "volume de pelo" comum, então foi anulado nas notas). Mantenha a correção registrada nas notas.
  • adopt coloca a imagem adotada em ref/front.png (1024×1536).

3. Amostras de ângulo (opcional: MiniMax H3)

bash tools/vector/sheets/turntable.sh <id>          # Altere a URL do ComfyUI com COMFY_SERVER
  • Primeiro, escreva tools/vector/sheets/h3/<id>.txt (o prompt do vídeo de rotação) usando h3/usagi.txt como modelo. Substitua apenas a parte da descrição do personagem.
  • As saídas angle_045.png, angle_090.png, angle_180.png são automaticamente adicionadas como imagens de referência na geração da folha da etapa 4. Como a rotação do H3 não é uniforme, os ângulos são aproximados.
  • Se não tiver ComfyUI e H3, pule esta etapa. A divisão em partes pode ser feita apenas com as folhas.

4. Duas folhas de personagem (Codex imagegen)

.venv/bin/python tools/vector/sheets/make.py gen <id> sheet_turnaround
.venv/bin/python tools/vector/sheets/make.py adopt <id> sheet_turnaround 1
.venv/bin/python tools/vector/sheets/make.py gen <id> sheet_face
.venv/bin/python tools/vector/sheets/make.py adopt <id> sheet_face 1
  • A primeira folha contém 4 vistas (frontal, oblíqua, lateral, traseira) e 4 formas de mão (aberta, apontando, punho, palma). A segunda folha contém variações faciais (olhos: abertos, semiabertos, fechados; boca: fechada, a, i, u, e, o; expressões: normal, sorriso, surpresa, preocupação).
  • A vista oblíqua e lateral devem ser desenhadas com o rosto voltado para a esquerda da tela (mesma direção da rotação do H3).
  • Inspecione visualmente para verificar se é o mesmo personagem da pose frontal e se as variações são consistentes (ex.: a íris não está achatada nos olhos semiabertos). Se não corresponder, corrija com --note e gere novamente.

5. Divisão em partes (subagente Fable 5.2)

  1. No modelo de references/fable-brief.md, insira o ID do personagem, nome do personagem, observações específicas do personagem e a URL do visualizador (padrão http://127.0.0.1:5280/), e salve em var/vector/<id>/fable/brief.md. O formato e o exemplo (coelho temporário) para as observações específicas estão em references/character-notes.md.
  2. Inicie um subagente com Fable 5.2 especificado e passe o conteúdo completo de brief.md. O Fable, seguindo references/parts-spec.md, cria public/characters/<id>/vector/vector.json com um script de desenho, verifica a si mesmo e relata.
  3. Leia o relatório, realize a verificação da etapa 6 e a confirmação da etapa 7. Se houver pontos a corrigir, solicite ao mesmo subagente em sequência (iniciar um novo perde o contexto).

O que deve ser garantido (escrito no modelo):

  • Desenhe as partes do zero como unidades de significado. Não use recorte de pixels ou traçado automático para determinar formas.
  • Desenhe apenas com preenchimento. As linhas são desenhadas automaticamente durante a renderização.
  • Complete as regiões ocultas (testa sob a franja, cabeça sob a base das orelhas, tronco sem braços, pescoço, base da cauda, etc.).
  • Não desenhe a imagem dos braços (eles são gerados durante a renderização). Em vez disso, meça e anote os marcadores do esqueleto e a espessura/cor dos braços.
  • _L e _R referem-se aos lados esquerdo e direito do próprio personagem (na vista frontal, _L está à direita da tela).

6. Verificação

.venv/bin/python tools/vector/check_parts.py <id>
  • Aprovado com 0 erros. Julgue os avisos com base no conteúdo.
  • Inspecione visualmente as imagens de verificação (var/vector/<id>/check/). Os pontos a verificar estão em references/visual-qa.md. Em particular, verifique se há buracos ou cortes com as partes da frente ocultas (qa_*.png), se as variações (variants.png · expressions.png) correspondem às folhas, e se as articulações do esqueleto (skeleton.png) correspondem ao desenho.
  • As imagens de verificação não incluem linhas de contorno automáticas ou braços gerados. A aparência final é confirmada na etapa 7.

7. Mova no visualizador

  1. Verifique se data/characters/<id>.json (criado na etapa 1) existe.

  2. Inicie o servidor de desenvolvimento com npm run dev e abra http://localhost:5280/?char=<id> (se houver 2 ou mais personagens, um seletor aparecerá na tela).

  3. Confirme capturando imagens (com o servidor de desenvolvimento em execução):

    DSF=2 node tools/capture/viewer_shots.mjs var/vector/<id>/check/viewer \
      neutral="char=<id>" face30="char=<id>&framing=face&yaw=30&blink=0" faceM30="char=<id>&framing=face&yaw=-30&blink=0" \
      explain="char=<id>&motion=explain&t=1.0" spread="char=<id>&motion=spread&t=1.2" \
      half="char=<id>&framing=face&eye=half&blink=0" point="char=<id>&motion=point&t=1.5"
    
  4. Pontos a verificar: linhas extras indesejadas nas bordas das partes de personagens brancos, olhos não saindo do contorno do rosto ao virar a cabeça ±30°, orelhas/cabelo não se soltando da cabeça, espessura/cor dos braços e mãos consistentes, movimento de objetos que balançam.

  5. Os ajustes são feitos nos valores de vector.json. Teste os valores com parâmetros de URL antes de gravá-los. Uma lista de valores ajustáveis está em references/tuning.md, e problemas comuns com soluções estão em references/troubleshooting.md.

8. Exportação de vídeo e sincronização labial

# Vídeo (com o servidor de desenvolvimento em execução)
node tools/vector/record.mjs --out out/<id>_explain --motion explain --query "char=<id>"

# Sincronização labial: a partir de um arquivo wav e texto (hiragana para japonês). O tipo de TTS não importa
.venv/bin/python tools/lipsync/lipsync.py line.wav --text "こんにちは、よろしくおねがいします。" -o line.json
node tools/vector/record.mjs --out out/<id>_hello --motion talk_demo --lipsync line.json --audio line.wav --query "char=<id>"
  • Se não houver TTS, você pode criar um vídeo com sincronização labial de texto: node tools/vector/record.mjs --out out/<id>_hello --motion talk_demo --seconds 6 --query "char=<id>&say=こんにちは、よろしくね。". O diálogo é repetido conforme o relógio, e a duração do vídeo é determinada pela duração do movimento (para movimentos que não se repetem, use --seconds). Para parar exatamente na duração do diálogo, especifique --seconds (estimativa: 0,15 segundos por mora, 0,3 segundos para pontuação).
  • Para diálogo em inglês, use --lang en. Para apenas volume sem texto, use --method rms. Se houver timestamps de palavras do Whisper, use --whisper whisper.json.
  • A cor de fundo pode ser definida com --query "bg=ffd3e0". Linhas de traço manual podem ser definidas com vHand=0~4 (nenhum, fraco, médio, forte, traço manual +; o padrão é forte).
  • No visualizador, você também pode carregar o JSON de sincronização labial e o arquivo de áudio para reprodução.

Ao finalizar

Relate ao usuário:

  • Os arquivos criados (imagens ref/, vector.json, data/characters/<id>.json) e os locais das imagens de verificação e vídeo
  • O tempo gasto em cada etapa e o número de gerações/retrabalhos
  • O resultado da verificação e quaisquer problemas restantes (partes com baixa confiança, aparência que não pôde ser totalmente corrigida)

Habilidades Relacionadas