К основному содержанию
правило CX Codex

tsl-compute-shaders — правило Claude Code: что делает и как установить

Правило tsl-compute-shaders подсказывает агенту, как писать вычислительные шейдеры на Three.js TSL для WebGPU и настраивать GPGPU-симуляции вроде частиц с расчётом физики.

MIT ★ 4 719 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/tsl-compute-shaders.md
Открыть на GitHub

Что делает tsl-compute-shaders

Правило даёт инструкции по написанию вычислительных шейдеров на Three.js Shading Language (TSL) под WebGPU. Агент учится связывать буферы через instancedArray, применять встроенные переменные вроде instanceIndex или deltaTime и вызывать расчёт через renderer.compute(). Это переносит тяжёлые вычисления с CPU на видеокарту.

В правиле собраны спецификации атомарных операций (atomicAdd, atomicStore, atomicLoad) и барьеров синхронизации (workgroupBarrier, storageBarrier). Отдельный блок описывает фолбэк на WebGL с текстурами данных и техникой пинг-понг через THREE.WebGLRenderTarget.

Без поддержки WebGPU в целевом браузере вычислительный пайплайн работать не будет, поэтому для продакшена понадобится запасной WebGL-вариант. Правило советует выбирать размер рабочей группы кратным 64 для оптимальной утилизации GPU.

Какие задачи решает

  • Перенести расчёт физики миллионов частиц на GPU через TSL
  • Синхронизировать чтение и запись в буферы с помощью барьеров
  • Реализовать атомарные операции в буферах хранения WebGPU
  • Настроить WebGL-фолбэк через пинг-понг рендер-таргеты

Примеры запросов агенту

  • Напиши compute-шейдер на TSL для гравитации и отскока 100000 частиц от пола
  • Добавь атомарное обновление счётчика в буфере WebGPU через Three.js TSL
  • Сделай WebGL-фолбэк для GPGPU симуляции с двумя WebGLRenderTarget

Как установить tsl-compute-shaders

Вручную: положить файлы

.claude/rules/tsl-compute-shaders.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о tsl-compute-shaders

Как установить tsl-compute-shaders в Claude Code?

Сохраните файл правила по пути .claude/rules/tsl-compute-shaders.md в корне вашего репозитория. Claude Code применит инструкции автоматически.

Что делает правило tsl-compute-shaders?

Оно даёт модели готовые шаблоны синтаксиса Three.js TSL, перечень встроенных переменных и примеры создания вычислительных шейдеров под WebGPU.

Как в правиле решается проблема отсутствия WebGPU?

В описании приведён пример запасного пути для WebGL с использованием THREE.DataTexture, шейдерного материала THREE.ShaderMaterial и двух сменяющих друг друга рендер-таргетов.

Исходный текст

tsl-compute-shaders.md · MIT
# TSL Compute Shaders

GPU compute shaders using TSL for WebGPU - enables GPGPU operations like particle systems, physics, and simulations.

## Basic Compute Shader

```javascript
import { Fn, instancedArray, instanceIndex, deltaTime } from 'three/tsl';

const COUNT = 1000000; // 1 million particles

// Storage buffers
const positionBuffer = instancedArray(COUNT, 'vec3');
const velocityBuffer = instancedArray(COUNT, 'vec3');

// Define compute shader
const computeParticles = Fn(() => {
  const position = positionBuffer.element(instanceIndex);
  const velocity = velocityBuffer.element(instanceIndex);

  position.addAssign(velocity.mul(deltaTime));
})().compute(COUNT);

// Execute in render loop
renderer.compute(computeParticles);
```

## Atomic Operations

```javascript
// Available atomic functions
atomicAdd(buffer, value)
atomicSub(buffer, value)
atomicMax(buffer, value)
atomicMin(buffer, value)
atomicAnd(buffer, value)
atomicOr(buffer, value)
atomicXor(buffer, value)
atomicStore(buffer, value)
atomicLoad(buffer)
```

## Barriers

```javascript
// Synchronization barriers
workgroupBarrier()   // Sync within workgroup
storageBarrier()     // Sync storage buffer access
textureBarrier()     // Sync texture access
barrier()            // Full barrier
```

## Compute Variables

| Variable | Description |
|----------|-------------|
| `workgroupId` | ID of current workgroup |
| `localId` | Local invocation ID |
| `globalId` | Global invocation ID |
| `numWorkgroups` | Total number of workgroups |
| `subgroupSize` | Size of subgroup |

## Particle System Example

```javascript
import {
  Fn, instancedArray, instanceIndex, deltaTime,
  If, float, vec3
} from 'three/tsl';

const COUNT = 100000;

const positionBuffer = instancedArray(COUNT, 'vec3');
const velocityBuffer = instancedArray(COUNT, 'vec3');

// Initialize positions
for (let i = 0; i < COUNT; i++) {
  positionBuffer.array[i * 3 + 0] = (Math.random() - 0.5) * 100;
  positionBuffer.array[i * 3 + 1] = Math.random() * 100;
  positionBuffer.array[i * 3 + 2] = (Math.random() - 0.5) * 100;

  velocityBuffer.array[i * 3 + 0] = 0;
  velocityBuffer.array[i * 3 + 1] = -9.81; // Gravity
  velocityBuffer.array[i * 3 + 2] = 0;
}

// Compute shader with physics
const computeParticles = Fn(() => {
  const position = positionBuffer.element(instanceIndex);
  const velocity = velocityBuffer.element(instanceIndex);

  // Apply velocity
  position.addAssign(velocity.mul(deltaTime));

  // Bounce off ground
  If(position.y.lessThan(0), () => {
    velocity.y.assign(velocity.y.negate().mul(0.8)); // Damping
    position.y.assign(0);
  });
})().compute(COUNT);

// In render loop
function animate() {
  renderer.compute(computeParticles);
  renderer.render(scene, camera);
}
```

## GPGPU with Render Targets (WebGL Fallback)

For WebGL without compute shaders:

```javascript
// Create position texture
const size = 256; // 256x256 = 65536 particles
const data = new Float32Array(size * size * 4);
for (let i = 0; i < size * size; i++) {
  data[i * 4 + 0] = Math.random() * 100 - 50; // x
  data[i * 4 + 1] = Math.random() * 100 - 50; // y
  data[i * 4 + 2] = Math.random() * 100 - 50; // z
  data[i * 4 + 3] = 1; // w
}

const positionTexture = new THREE.DataTexture(
  data, size, size,
  THREE.RGBAFormat, THREE.FloatType
);
positionTexture.needsUpdate = true;

// Ping-pong render targets
const rtA = new THREE.WebGLRenderTarget(size, size, {
  type: THREE.FloatType,
  format: THREE.RGBAFormat
});
const rtB = rtA.clone();

// Update shader
const updateMaterial = new THREE.ShaderMaterial({
  uniforms: {
    positions: { value: positionTexture },
    time: { value: 0 }
  },
  fragmentShader: `
    uniform sampler2D positions;
    uniform float time;
    varying vec2 vUv;

    void main() {
      vec4 pos = texture2D(positions, vUv);
      pos.y += sin(time + pos.x * 0.1) * 0.01;
      gl_FragColor = pos;
    }
  `
});
```

## Performance Comparison

| Method | Particles at 60fps |
|--------|-------------------|
| CPU | ~50,000 |
| GPGPU (WebGL) | ~500,000 |
| Compute Shaders (WebGPU) | 1,000,000+ (<1ms update) |

## Best Practices

1. **Workgroup Size**: Use multiples of 64 for optimal GPU utilization

2. **Memory Access**: Coalesce memory access patterns when possible

3. **Barriers**: Only use barriers when synchronization is necessary

4. **Buffer Types**: Use appropriate buffer types for your data

5. **Fallback**: Provide WebGL fallback for browsers without WebGPU support

## References

- [Three.js WebGPU Compute Examples](https://threejs.org/examples/?q=compute)
- [WebGPU Compute Shaders Spec](https://www.w3.org/TR/webgpu/#compute-pass-encoder)

© zebbern · MIT · zebbern/claude-code-guide

Похожие правила IDE

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
webgpu-threejs-tsl dgreenheck Скилл webgpu-threejs-tsl помогает писать Three.js-приложения с WebGPU, TSL-материалами, вычислительными шейдерами и постобработкой. CX Codex +1 1 800установок threejs-fundamentals CloudAI-X Скилл threejs-fundamentals помогает настроить базовую сцену Three.js r186: рендерер, камеры, цикл анимации с THREE.Timer и import map для WebGL или WebGPU с TSL. CX Codex +1 24 100установок threejs-webgpu cesartevisual Скилл threejs-webgpu для Claude Code помогает создавать и переносить проекты Three.js на WebGPURenderer, настраивать материалы TSL и вычисления на GPU. Он подключается к задачам, где нужно учесть ограничения выбранного графического backend. CX Codex +1 585установок threejs-shaders CloudAI-X Скилл threejs-shaders помогает писать кастомные GLSL-шейдеры и материалы для Three.js r186, настраивать униформы и переводить код на TSL для WebGPU. CX Codex +1 22 000установок webgpu-claude-skill podo Учит агента рендерить Three.js через WebGPU: материалы на TSL, compute-шейдеры, постобработка и WGSL. Решает задачи GPU compute и авторских материалов. CX Codex +1 202установок r3f-shaders EnzeD Скилл r3f-shaders для Claude Code, помогает писать кастомные GLSL- и TSL-шейдеры в React Three Fiber вместо стандартных PBR-материалов. CX Codex +1 2 200установок

Из того же набора86

Весь набор →
migration-checklist Правило migration-checklist подсказывает агенту, как мигрировать код при обновлении Three.js. Перечисляет breaking changes с r125 и актуальные пути импортов. CX Codex +1 ★ 4 719звёзд репо audio-spatial Правило audio-spatial для Claude Code задаёт шаблоны настройки 3D-звука в Three.js: позиционирование источников, затухание и реакцию на действия пользователя. CX Codex +1 ★ 4 719звёзд репо debug-devtools Правило debug-devtools для Claude Code и Codex добавляет в Three.js-проект средства диагностики производительности, сцены и потери WebGL-контекста. Находит узкие места и проверяет параметры вживую. CX Codex +1 ★ 4 719звёзд репо tsl-post-processing Правило tsl-post-processing для Claude Code описывает постобработку Three.js на TSL: эффекты подключаются к postProcessing.outputNode без цепочки проходов EffectComposer. Агент обращается к нему при написании кода сцены. CX Codex +1 ★ 4 719звёзд репо animation-system Правило animation-system объясняет систему анимации Three.js: от запуска и смешивания клипов до морфинга и управления костями. Пригодится при работе с анимированными 3D-моделями. CX Codex +1 ★ 4 719звёзд репо gltf-loading-optimization Правило gltf-loading-optimization для Claude Code содержит сниппеты и команды для загрузки glTF в Three.js, настройки декодеров, прогресса, ленивой подгрузки и сжатия моделей. CX Codex +1 ★ 4 719звёзд репо physics-integration Правило physics-integration задаёт правила связки Three.js с физическими движками Rapier и Cannon-es: настройка Vite, коллайдеры и синхронизация позиций. CX Codex +1 ★ 4 719звёзд репо raycasting-optimization Правило raycasting-optimization для Claude Code описывает, как ускорить поиск пересечений и выбор объектов в Three.js. Сокращает проверки Raycaster в интерактивных сценах и на сложных мешах. CX Codex +1 ★ 4 719звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой