Communitygithub.com

linegel/threejs-complete-set-of-skill

25 habilidades especializadas para agentes que criam cenas Three.js WebGPU/TSL ambiciosas — oceanos processuais, nuvens, planetas, óptica de água, pipelines de imagem e validação visual baseada em capturas de tela. Para Claude Code, Codex, Cursor e qualquer agente ciente de skills.

O que é threejs-complete-set-of-skill?

Este skill capacita agentes de IA (como Claude Code, Codex e Cursor) a implementar efeitos de Bloom de alto nível em cenas Three.js usando o pipeline WebGPU/TSL mais moderno. Ele ensina a arquitetura correta: bloom como um efeito de pós-processamento alimentado pela saída seletiva de emissividade do MRT (Multiple Render Targets), preservando o sinal HDR até a transformação final e utilizando `BloomNode` da biblioteca TSL. O skill cobre desde a configuração inicial com o `WebGPURenderer`, passando pela criação de materiais com `NodeMaterial` e roteamento da emissividade, até o ajuste fino de parâmetros como `strength`, `radius`, `threshold` e `setResolutionScale()`. Inclui verificações de capacidade (WebGPU obrigatório), orçamentos de qualidade para diferentes dispositivos, e uma clara separação de responsabilidades com outros skills de pipeline de imagem, grade de cores e validação visual. É projetado para desenvolvedores que desejam um bloom limpo, performático e seletivo, evitando armadilhas comuns como vazamento de albedo, ajuste de threshold pós-mapeamento de tom ou sistemas concorrentes de conversão de cor.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add linegel/threejs-complete-set-of-skill

Perguntar na sua IA favorita

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

Documentação

Bloom

Bloom é uma resposta da câmera/tela a um sinal HDR brilhante. Ensine-o como um efeito de pipeline de nó único, alimentado pela luminância da cena criada pelo autor, não como a única forma visível de um objeto ou efeito.

Arquitetura Primeiro

O caminho de produção é o WebGPURenderer mais recente do Three.js, de three/webgpu, TSL de three/tsl, RenderPipeline, pass(), mrt({ output, emissive }) e BloomNode de bloom().

Construa bloom seletivo a partir da saída MRT emissiva do passe de cena:

passe de cena com MRT output + emissive
  -> nó de textura de cor da cena
  -> nó de textura de contribuição emissiva
  -> bloom(emissive).setResolutionScale(...)
  -> cor da cena + bloom
  -> único proprietário de renderOutput / outputColorTransform

Esta é a arquitetura de ponta para esta skill: uma renderização de cena, contribuição seletiva direta via MRT, sinal HDR preservado até a transformação final de saída e escalonamento de resolução por passe para o trabalho caro de desfoque.

Leia references/hdr-bloom-system.md para o esqueleto WebGPU/TSL da era r185, gate de capacidade, níveis de qualidade, orçamentos, regras de cor, diagnósticos e notas de substituição.

Exemplo canônico WebGPU/TSL: examples/node-selective-bloom/.

Fluxo de Trabalho

  1. Execute $threejs-choose-skills como pré-verificação quando bloom fizer parte de um pipeline de imagem maior.
  2. Crie a contribuição emissiva com materiais NodeMaterial e encaminhe-a para MRT emissive.
  3. Alimente BloomNode a partir do nó de textura emissiva, não de uma renderização de cena separada.
  4. Ajuste strength, radius, threshold, smoothWidth e setResolutionScale() em HDR pré-mapeamento de tom.
  5. Mantenha exatamente um proprietário de mapeamento de tom e conversão de saída.
  6. Valide as visualizações de base, contribuição emissiva, bloom apenas e saída final nos orçamentos de desktop discreto, desktop integrado e móvel.

Gate de Capacidade

Qualquer implementação que use MRT ou recursos de armazenamento deve passar pelo gate após a inicialização do renderizador:

await renderer.init();

if ( renderer.backend.isWebGPUBackend !== true ) {
  throw new Error(
    'Backend WebGPU necessário para threejs-bloom. Se o usuário perguntar explicitamente como aplicar fallback quando WebGPU não estiver disponível, encaminhe para threejs-compatibility-fallbacks.'
  );
}

// As camadas WebGPU podem reduzir bloomScale, pixelRatioCap, número de contribuidores ou
// desabilitar o bloom enquanto preservam uma cena base legível.

Implementação WebGL legada (obsoleta, não estenda): nenhuma nesta pasta de skill; solicitações explícitas de fallback devem ser encaminhadas para $threejs-compatibility-fallbacks.

Condições de Falha

  • bloom cria a única forma visível de um efeito;
  • albedo comum ou superfícies iluminadas vazam para o alvo de contribuição emissiva;
  • todos os materiais brilhantes compartilham um multiplicador de emissão arbitrário;
  • threshold é ajustado após o mapeamento de tom ou conversão de exibição;
  • múltiplos sistemas são donos do mapeamento de tom ou conversão de cor de saída;
  • o passe de bloom roda em resolução total por padrão em dispositivos com largura de banda limitada;
  • caminhos de redimensionamento omitem setSize() ou validação de escala de resolução;
  • realces se tornam cinza porque a energia HDR é limitada antes do bloom.

Limite de Roteamento

Use $threejs-exposure-color-grading para medição, adaptação, mapeamento de tom e LUTs. Use $threejs-image-pipeline quando o bloom precisar compartilhar profundidade, normais, oclusão de ambiente (AO), TAA ou outros recursos de espaço de imagem. Use $threejs-visual-validation para diagnósticos de passe de visão fixa e evidência de tempo de GPU.

Habilidades Relacionadas