Communitygithub.com

linegel/threejs-complete-set-of-skill

25 個專業級 AI 代理技能,用於建構雄心勃勃的 Three.js WebGPU/TSL 場景——程式化海洋、雲層、行星、水體光學、影像管線,以及基於螢幕截圖的視覺驗證。適用於 Claude Code、Codex、Cursor 及任何支援技能的 AI 代理。

threejs-complete-set-of-skill 是什麼?

這是一個專為 Three.js 開發者設計的 AI 代理技能套件組合,包含 25 個獨立技能,涵蓋從程式化生成(海洋、雲層、行星)、進階渲染(泛光、影像管線)到品質保證(視覺驗證)等完整工作流程。技能核心是基於最新的 Three.js WebGPU 渲染器與 TSL(Three.js Shading Language),並特別強調架構優先的設計原則,例如選擇性泛光(Selective Bloom)必須透過 MRT(多重渲染目標)的 emissive 通道來實現,而非直接渲染整個場景,以維持 HDR 動態範圍直到最終色調映射。此套件支援 Claude Code、Codex 和 Cursor 等主要 AI 程式碼代理平台,透過統一的技能選擇前檢查(`$threejs-choose-skills`)來確保正確的管線組合,並提供詳細的診斷指南、效能預算與失敗條件檢查,幫助開發者避免常見的陷阱(如色調映射多重擁有、HDR 能量被過早截斷)。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add linegel/threejs-complete-set-of-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Bloom

Bloom(泛光)是攝影機/顯示器對明亮 HDR 訊號的反應。請將其視為一個由場景亮度驅動的節點管線效果,而非物體或效果的唯一可見形式。

架構優先

生產路徑使用最新的 Three.js WebGPURenderer(來自 three/webgpu)、TSL(來自 three/tsl)、RenderPipeline、pass()、mrt({ output, emissive }),以及來自 bloom() 的 BloomNode。

透過場景傳遞的 MRT emissive 輸出來建立選擇性泛光:

scene pass with MRT output + emissive
  -> scene color texture node
  -> emissive contribution texture node
  -> bloom(emissive).setResolutionScale(...)
  -> scene color + bloom
  -> single renderOutput / outputColorTransform owner

這是本技能的最高層級架構:一次場景渲染、直接的 MRT 選擇性貢獻、HDR 訊號保留至最終輸出轉換,以及針對昂貴模糊工作的逐通道解析度縮放。

請閱讀 references/hdr-bloom-system.md 以了解 r185 時代的 WebGPU/TSL 骨架、能力閘、品質分級、預算、色彩規則、診斷與替代方案說明。

標準 WebGPU/TSL 範例:examples/node-selective-bloom/。

工作流程

  1. 當泛光屬於較大影像管線的一部分時,執行 $threejs-choose-skills 前檢查。
  2. 使用 NodeMaterial 材質建立 emissive 貢獻,並將其路由至 MRT emissive。
  3. 從 emissive 紋理節點(而非單獨的場景渲染)饋送 BloomNode。
  4. 在色調映射前的 HDR 空間中調整 strength、radius、threshold、smoothWidth 與 setResolutionScale()。
  5. 維持剛好一個色調映射與輸出轉換擁有者。
  6. 分別在桌上型獨立顯卡、桌上型整合顯卡與行動裝置的預算限制下,驗證基礎場景、emissive 貢獻、僅泛光與最終輸出等四個視圖。

能力閘

任何使用 MRT 或儲存資源的實作,必須在渲染器初始化之後進行能力檢查:

await renderer.init();

if ( renderer.backend.isWebGPUBackend !== true ) {
  throw new Error(
    'WebGPU backend required for threejs-bloom. If the user explicitly asks how to apply fallback when WebGPU is unavailable, route to threejs-compatibility-fallbacks.'
  );
}

// WebGPU 分級可能降低 bloomScale、pixelRatioCap、貢獻者數量,或
// 停用泛光但保留可讀的基礎場景。

舊版 WebGL 實作(已棄用,請勿擴展):此技能資料夾中沒有;明確的降級請求請路由至 $threejs-compatibility-fallbacks。

失敗條件

  • 泛光成為效果的唯一可見形式;
  • 一般反照率或光照表面洩漏至 emissive 貢獻目標;
  • 所有明亮材質共享一個任意的自發光乘數;
  • 在色調映射或顯示轉換之後調整 threshold;
  • 多個系統擁有色調映射或輸出色彩轉換;
  • 在某些頻寬有限的裝置上,泛光通道預設以全解析度運行;
  • resize 路徑遺漏 setSize() 或解析度縮放驗證;
  • 因為 HDR 能量在泛光之前被截斷,導致高光變成灰色。

路由邊界

使用 $threejs-exposure-color-grading 進行測光、適應、色調映射與 LUT。當泛光需要與深度、法線、AO、TAA 或其他影像空間資源共用時,使用 $threejs-image-pipeline。對於固定視圖通道診斷與 GPU 時間證據,使用 $threejs-visual-validation。

相關技能