Communitygithub.com

voxel-walk: uma pessoa, uma caminhada contínua, cada função

Transforma a carreira de uma pessoa em um curta-metragem 3D em estilo voxel, onde um personagem caminha continuamente por cada função, com troca de roupa no meio da caminhada e cenas que surgem e desaparecem do chão.

O que é voxel-walk: uma pessoa, uma caminhada contínua, cada função?

Esta skill permite gerar um filme 3D em estilo voxel que narra a trajetória profissional de uma pessoa de forma cinematográfica e contínua. O personagem principal nunca desaparece da tela: ele caminha de uma cena a outra, enquanto a roupa muda com um efeito de anel de luz e cada capítulo (cargo) surge a partir do chão à sua frente e desaparece atrás. Ideal para criar vídeos para LinkedIn ou portfólio, a skill suporta plataformas como film-engine (render, áudio, finalização) e exige que todas as cenas passem pela auditoria `film-audit` antes de serem enviadas. O fluxo de trabalho inclui uma entrevista inicial para coletar os dados da pessoa (anos, empresas, títulos e o que cada cargo ensinou), a construção das cenas a partir de um template HTML e JSON, e a adição de novos capítulos seguindo regras rigorosas de composição visual, movimentação de câmera e legendas. A skill é baseada no repositório `github.com/thativanng/reels-maker` e deve ser executada a partir da pasta `reels-maker`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thativanng/reels-maker/tree/HEAD/skills/voxel-walk

Perguntar na sua IA favorita

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

Documentação

O que voxel-walk: uma pessoa, uma caminhada contínua, cada função faz?

Onde o kit está: execute todos os comandos desta skill na pasta reels-maker (o clone de github.com/thativanng/reels-maker que contém template/ e tools/). Se o projeto não tiver essas pastas, configure-o primeiro seguindo o SETUP.md desse repositório.

Comece a partir de template/film.html + template/career.json. O template é um filme completo de três capítulos (um café, um depósito, uma mesa noturna com um amigo IA) para uma pessoa fictícia. Substitua os capítulos pelos da pessoa real; mantenha os sistemas.

1 · Entreviste primeiro (reel-intake, depois references/intake.md)

reel-intake executa a entrevista: propósito, formato, o bloco da jornada (cada função e cargo, nome/descrever/esconder, alegações), as referências de estilo e as diretrizes. O references/intake.md desta skill adiciona apenas o que o estilo voxel precisa. O template é apenas 4:5 (suas câmeras são configuradas para isso): para um briefing 9:16, reconfigurar as câmeras e reexecutar cada verificação, ou escolher outro estilo. Antes de qualquer bloco ser colocado, obtenha da pessoa, com suas próprias palavras:

  • Cada função: o ano, empresa, título e a única coisa que essa função ensinou ou provou (o "diferencial").
  • A cena que mostra o trabalho, não o cargo. Um planejador não é uma pessoa sentada em uma mesa; são caminhões saindo de um cais para os depósitos certos. Um barista são xícaras sendo entregues sobre um balcão.
  • A roupa de cada capítulo, o que realmente usavam.
  • O que NÃO pode aparecer: números que não podem publicar, um empregador que preferem não mencionar, alegações que colegas atuais questionariam.
  • O cartão final: nome, slogan, três pontos fortes, uma frase de encerramento.

As palavras deles têm precedência sobre as suas. Você pode revisar as frases deles (gramática, fluência); não pode reescrever o significado.

2 · As regras da casa (references/house-rules.md tem as justificativas)

  1. Uma caminhada contínua. O herói nunca desaparece. Ele caminha de cena em cena; a roupa muda no meio da caminhada com um anel de luz varrendo da cabeça aos pés.
  2. As cenas sobem e afundam. O próximo capítulo surge do chão à frente do herói e o último afunda atrás, de modo que uma caminhada entre capítulos leva 2–4 s, não 20. Objetos em movimento sobem depois dos edifícios e saem antes deles.
  3. A imagem conta a história; a legenda carrega o significado. Sem rótulos em objetos (uma empilhadeira não precisa de uma etiqueta "EMPILHADEIRA"). Rotule apenas um conceito que a imagem não consegue transmitir. As legendas são uma linha de história por batida, nunca uma repetição do banner.
  4. O tempo de tela segue a importância, não a escala real. Os momentos do herói ganham pausas; veículos são coadjuvantes rápidos.
  5. Cor: chão cinza quente, objetos brancos, telhados e estradas escuros, UMA cor de destaque para a UI e os objetos-chave. Luz principal forte mais oclusão ambiente. Branco sobre branco é monótono.
  6. O banner muda quando a cena está na tela, não quando seu código começa.
  7. Nenhum número que você não possa defender diante do seu empregador atual. Anos no banner são aceitáveis; KPIs geralmente não são.
  8. Cada quadro passa por film-audit.

3 · Como o template é construído (encontre estas seções em film.html)

  • CHARACTERS: um personagem é uma lista de retângulos [x, y, w, h, cor, parte, frontOffset, profundidade], extrudados em caixas e agrupados em partes (pernas, tronco, braços, cabeça, cabelo) com pivôs. career.json → looks fornece uma roupa por capítulo. makeMini() cria o elenco; buddyVox() faz o robô.
  • A troca de roupa: cada roupa é um corpo voxel separado cortado por um plano em movimento; WIPES = [[t, de, para]].
  • WALK: IK = [[t, x, z, ryQuandoParado]] waypoints, velocidade trapezoidal, fase da perna a partir da distância. SITS = [[de, para]] para mesas.
  • ZONES: zoneG(tIn, tOut) cria um capítulo que sobe e afunda; qualquer coisa que se move vai em wrap(zone).
  • CAMERA: CK = [[t, A(...) | F(...)]].
  • OVERLAYS: todo texto vem de career.json.
  • AUDIT: AUD_S (sólidos), AUD_M (movedores), HELD (contatos que devem acontecer), window._dbg (o que as sondas podem medir).

4 · Adicionando um capítulo

  1. Escolha um trecho de rua (intervalo x) próximo ao último capítulo. A pista de caminhada é z ≈ 2.6–3.4, os adereços ficam atrás (z < 0), uma mesa fica na frente (z ≈ 5.4) com sua cadeira atrás.
  2. Construa o cenário em um zoneG(tIn, tOut); coloque os movedores em wrap(zone).
  3. Adicione waypoints IK para a caminhada de entrada e a parada, uma entrada WIPES para a roupa, e chaves CK (seguir durante a caminhada, uma pausa absoluta na batida).
  4. Adicione a era a career.json no momento em que o cenário está pronto e a roupa está vestida. Adicione as legendas.
  5. Registre cada sólido em AUD_S e cada movedor em AUD_M. Adicione as dicas de áudio em template/audio.py.
  6. Execute as verificações (folha de stills → node tools/collide.mjs → sondas), depois um auditor independente.

5 · Armadilhas comuns neste estilo

  • Um adereço atrás da cabeça (prateleiras, telas, tampas em uma linha de produção) parece um chapéu ou uma auréola. Verifique com sonda. Corrija com altura da câmera, um passo lateral ou um movimento posterior.
  • Pares de pessoas uma atrás da outra se fundem em uma figura de duas cabeças. Espaçe-os com a largura de um corpo no eixo x.
  • Coisas passadas entre pessoas devem ficar na altura do peito e nunca cruzar um rosto. Roteie-as pela mesa do herói se cruzarem a sala.
  • O herói andando de lado varre os ombros contra coisas ao lado da pista. Mantenha 1,3 unidades de distância.

Habilidades Relacionadas