Communitygithub.com

linegel/threejs-complete-set-of-skill

25 Experten-Agent-Skills für ambitionierte Three.js WebGPU/TSL-Szenen – prozedurale Ozeane, Wolken, Planeten, Wasseroptik, Bildpipelines und Screenshot-gestützte visuelle Validierung. Für Claude Code, Codex, Cursor und jeden Skill-bewussten Agenten.

Was ist threejs-complete-set-of-skill?

Dieses Skill-Paket enthält 25 spezialisierte Agenten-Fähigkeiten für die Erstellung anspruchsvoller Three.js-Szenen mit WebGPU/TSL. Es deckt prozedurale Ozeane, Wolken, Planeten, Wasseroptik, Bildverarbeitungspipelines und visuelle Validierung per Screenshot ab. Die Skills sind für den Einsatz mit KI-gesteuerten Entwicklungstools wie Claude Code, Codex und Cursor optimiert. Sie nutzen die neuesten Three.js-Features wie `WebGPURenderer`, TSL (Three Shading Language), `RenderPipeline`, MRT (Multiple Render Targets) und `BloomNode`. Der Fokus liegt auf einer korrekten Architektur, bei der Effekte wie Bloom selektiv über MRT-Emission gesteuert werden, HDR-Signale bis zur finalen Ausgabe erhalten bleiben und Ressourcen durch Auflösungsskalierung geschont werden. Das Paket bietet klare Qualitätsstufen, Budgetvorgaben und Fehlerbehandlungsroutinen für verschiedene Hardware-Tiers (Desktop-diskret, Desktop-integriert, Mobil).

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Bloom

Bloom ist eine Kamera-/Display-Reaktion auf helle HDR-Signale. Lehre es als Einen Node-Pipeline-Effekt, der von der autorierten Szenenluminanz gespeist wird, nicht als die einzige sichtbare Form eines Objekts oder Effekts.

Architektur zuerst

Der Produktionspfad ist der aktuelle Three.js WebGPURenderer aus three/webgpu, TSL aus three/tsl, RenderPipeline, pass(), mrt({ output, emissive }), und BloomNode aus bloom().

Baue selektives Bloom aus dem Szenen-Pass-MRT-Emissionsausgabe:

Szenen-Pass mit MRT output + emissive
  -> Szenen-Farb-Texture-Node
  -> Emissionsbeitrags-Texture-Node
  -> bloom(emissive).setResolutionScale(...)
  -> Szenenfarbe + bloom
  -> Einzelner renderOutput / outputColorTransform-Eigentümer

Dies ist die Top-Level-Architektur für diesen Skill: Ein einziger Szenen-Render, direkter MRT-selektiver Beitrag, HDR-Signal bis zur finalen Ausgabe-Transformation erhalten, und passweise Auflösungsskalierung für die teure Unschärfearbeit.

Lies references/hdr-bloom-system.md für das r185-Ära WebGPU/TSL-Skelett, Fähigkeiten-Gate, Qualitätsstufen, Budgets, Farbenregeln, Diagnostik und Ersetzungshinweise.

Kanonisches WebGPU/TSL-Beispiel: examples/node-selective-bloom/.

Arbeitsablauf

  1. Führe $threejs-choose-skills Preflight aus, wenn Bloom Teil einer größeren Bildpipeline ist.
  2. Autorisiere Emissionsbeiträge mit NodeMaterial-Materialien und leite sie zum MRT emissive.
  3. Speise BloomNode aus dem Emissions-Texture-Node, nicht aus einem separaten Szenen-Render.
  4. Stimme strength, radius, threshold, smoothWidth und setResolutionScale() im Pre-Tone-Map-HDR ab.
  5. Behalte genau einen Tone-Map- und Ausgabe-Konvertierungseigentümer.
  6. Validiere Basis-, Emissionsbeitrags-, Bloom-only- und finale Ausgabe-Ansichten mit Desktop-diskreten, Desktop-integrierten und mobilen Budgets.

Fähigkeiten-Gate

Jede Implementierung, die MRT- oder Speicherressourcen verwendet, muss nach der Renderer-Initialisierung ein Tor haben:

await renderer.init();

if ( renderer.backend.isWebGPUBackend !== true ) {
  throw new Error(
    'WebGPU-Backend erforderlich für threejs-bloom. Wenn der Benutzer explizit fragt, wie ein Fallback anzuwenden ist, wenn WebGPU nicht verfügbar ist, leite zu threejs-compatibility-fallbacks weiter.'
  );
}

// WebGPU-Stufen können bloomScale, pixelRatioCap, Beitragszähler reduzieren oder
// Bloom deaktivieren, während eine lesbare Basisszene erhalten bleibt.

Legacy-WebGL-Implementierung (veraltet, nicht erweitern): Keine in diesem Skill-Ordner; explizite Fallback-Anfragen werden an $threejs-compatibility-fallbacks weitergeleitet.

Fehlerbedingungen

  • Bloom erzeugt die einzige sichtbare Form eines Effekts;
  • gewöhnliche Albedo- oder beleuchtete Oberflächen lecken in das Emissionsbeitragsziel;
  • alle hellen Materialien teilen sich einen willkürlichen Emissionsmultiplikator;
  • Threshold wird nach Tone Mapping oder Display-Konvertierung eingestellt;
  • mehrere Systeme besitzen Tone Mapping oder Ausgabe-Farbkonvertierung;
  • der Bloom-Pass läuft standardmäßig in voller Auflösung auf bandbreitenbegrenzten Geräten;
  • Größenänderungs-Pfade lassen setSize() oder Auflösungsskalen-Validierung aus;
  • Spitzen werden grau, weil HDR-Energie vor Bloom abgeschnitten wird.

Routing-Grenze

Verwende $threejs-exposure-color-grading für Belichtungsmessung, Anpassung, Tone Mapping und LUTs. Verwende $threejs-image-pipeline, wenn Bloom Tiefe, Normalen, AO, TAA oder andere Bildraum-Ressourcen teilen muss. Verwende $threejs-visual-validation für Fixansicht-Pass-Diagnostik und GPU-Zeitmessungsnachweise.

Verwandte Skills