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

tsl-why-use — правило для Claude Code: TSL вместо onBeforeCompile

Правило tsl-why-use для Claude Code и Codex: кастомные материалы в Three.js собираются из нод TSL, а не через патч onBeforeCompile. Применяется в проектах со своими шейдерами.

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

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

Что делает tsl-why-use

Правило задаёт, как агент пишет кастомные материалы в Three.js. Вместо onBeforeCompile — где униформы и куски шейдера вставляются в fragmentShader заменой строк — он собирает материал из нод three/tsl.

Что это даёт на практике: анимация цвета через sin(time) в colorNode, смещение вершин в positionNode, повторяющаяся формула в Fn. Ноды складываются друг с другом, поэтому вторая текстура просто умножается на готовый colorNode, без поиска нужного токена #include.

Примеры импортируют three/tsl и создают MeshStandardNodeMaterial, так что код по этому правилу требует сборки Three.js с нодовыми материалами. На старой версии он не запустится. Патчи на замене строк ломаются при обновлении Three.js, и это как раз причина держать правило в проекте.

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

  • переписать кастомный материал на ноды TSL вместо патча fragmentShader
  • добавить вторую текстуру в стандартный материал без правки шейдера
  • сделать анимацию цвета материала синусоидой по времени
  • сместить вершины геометрии в positionNode
  • вынести повторяющуюся формулу в Fn и переиспользовать её

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

  • Добавь в материал текстуру детализации через TSL, без onBeforeCompile.
  • Сделай анимацию цвета материала синусоидой по времени на colorNode.
  • Перепиши этот патч fragmentShader на ноды из three/tsl.

Как установить tsl-why-use

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

.claude/rules/tsl-why-use.md

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

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

Вопросы о tsl-why-use

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

Положите файл правила по пути .claude/rules/tsl-why-use.md. Текст берётся из репозитория zebbern/claude-code-guide.

Что делает tsl-why-use?

Направляет агента: кастомные материалы Three.js собираются из нод three/tsl и MeshStandardNodeMaterial, а не через замену строк в onBeforeCompile.

Чем TSL отличается от onBeforeCompile?

Ноды TSL работают и в WebGL, и в WebGPU, типизированы и складываются друг с другом. Патч через замену строк в fragmentShader ломается при обновлении Three.js и плохо сочетается с другими правками.

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

tsl-why-use.md · MIT
# tsl-why-use

**Use TSL instead of onBeforeCompile hacks for custom materials.**

## Why It Matters

TSL (Three.js Shading Language) is the modern approach to shader creation in Three.js:

- Works with both WebGL and WebGPU backends
- No string manipulation or onBeforeCompile hacks
- Type-safe, composable shader nodes
- Automatic optimization and tree shaking
- Easier to maintain and debug

## Bad Example

```javascript
// OLD - onBeforeCompile (fragile, hard to maintain)
const material = new THREE.MeshStandardMaterial();
material.map = colorMap;
material.onBeforeCompile = (shader) => {
  shader.uniforms.detailMap = { value: detailMap };

  let token = '#define STANDARD';
  let insert = `uniform sampler2D detailMap;`;
  shader.fragmentShader = shader.fragmentShader.replace(token, token + insert);

  token = '#include <map_fragment>';
  insert = `diffuseColor *= texture2D(detailMap, vMapUv * 10.0);`;
  shader.fragmentShader = shader.fragmentShader.replace(token, token + insert);
};
```

Problems:
- String manipulation is error-prone
- Breaks with Three.js updates
- Hard to combine multiple modifications
- No type safety
- Difficult to debug

## Good Example

```javascript
// NEW - TSL (clean, composable)
import { texture, uv } from 'three/tsl';

const detail = texture(detailMap, uv().mul(10));

const material = new THREE.MeshStandardNodeMaterial();
material.colorNode = texture(colorMap).mul(detail);
```

Benefits:
- Clean, readable code
- Composable nodes
- Works with WebGL and WebGPU
- Type-safe with TypeScript
- Automatic optimization

## More TSL Examples

### Animated Color

```javascript
import { color, time, sin } from 'three/tsl';

const material = new THREE.MeshStandardNodeMaterial();
material.colorNode = color(0x00ff00).mul(sin(time).mul(0.5).add(0.5));
```

### Vertex Displacement

```javascript
import { positionLocal, sin, time } from 'three/tsl';

const material = new THREE.MeshStandardNodeMaterial();
material.positionNode = positionLocal.add(
  sin(time.add(positionLocal.y)).mul(0.1)
);
```

### Custom Function

```javascript
import { Fn, vec3, float } from 'three/tsl';

const oscSine = Fn(([t = time]) => {
  return t.add(0.75).mul(Math.PI * 2).sin().mul(0.5).add(0.5);
});

material.colorNode = vec3(oscSine(), 0, 0);
```

## References

- [Three.js TSL Documentation](https://threejs.org/docs/#api/en/nodes/TSL)
- [TSL Examples](https://threejs.org/examples/?q=tsl)

© 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установок webgpu-claude-skill podo Учит агента рендерить Three.js через WebGPU: материалы на TSL, compute-шейдеры, постобработка и WGSL. Решает задачи GPU compute и авторских материалов. CX Codex +1 202установок threejs-fundamentals CloudAI-X Скилл threejs-fundamentals помогает настроить базовую сцену Three.js r186: рендерер, камеры, цикл анимации с THREE.Timer и import map для WebGL или WebGPU с TSL. CX Codex +1 24 100установок threejs-shaders CloudAI-X Скилл threejs-shaders помогает писать кастомные GLSL-шейдеры и материалы для Three.js r186, настраивать униформы и переводить код на TSL для WebGPU. CX Codex +1 22 000установок three-best-practices three-agent-skills Скилл three-best-practices для Claude Code с правилами оптимизации Three.js. Срабатывает при написании, ревью и отладке кода с 3D-сценами, WebGL/WebGPU, шейдерами и TSL. CX Codex +1 1 700установок threejs mrgoonie Собирает 3D-сцены, шейдеры и VR-опыты на Three.js. Закрывает задачи с WebGL и WebGPU. CX Codex +1 1 300установок

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

Весь набор →
security-reviewer Субагент security-reviewer проверяет код на уязвимости, отслеживая путь непроверенных параметров до опасных вызовов. Не вносит правок в проект. CX Codex ★ 4 719звёзд репо runtime-verifier Субагент runtime-verifier проверяет готовые изменения через интерфейсы CLI, сервисов или файловой системы, фиксируя побочные эффекты без правок кода. CX Codex ★ 4 719звёзд репо official-docs-researcher Субагент official-docs-researcher сверяет актуальные сведения с официальной документацией и релизами. Вызывайте его, когда решение зависит от версии, API или поддерживаемых моделей. CX Codex ★ 4 719звёзд репо change-implementer Субагент change-implementer проводит одно заранее утверждённое изменение до конца: правит код, проверяет его в реальном запуске и докладывает, что увидел. CX Codex ★ 4 719звёзд репо asset-compression Правило asset-compression с инструкциями по сжатию 3D-ассетов для Three.js. Помогает настроить Draco, Meshopt, KTX2-текстуры и LOD для ускорения 3D-сцен в вебе. CX Codex +1 ★ 4 719звёзд репо perf-never-set-state-in-useframe Правило perf-never-set-state-in-useframe для react-three-fiber: не вызывать setState внутри useFrame, потому что это даёт перерисовку на каждом кадре. Вместо состояния React — мутация ref. CX Codex +1 ★ 4 719звёзд репо frame-delta-time Правило frame-delta-time требует умножать движение на delta в useFrame, чтобы скорость анимации не зависела от частоты кадров. CX Codex +1 ★ 4 719звёзд репо draw-call-optimization Правило draw-call-optimization для Claude Code описывает оптимизацию сцены Three.js: снизить число вызовов отрисовки до 100 на кадр инстансингом, батчингом и слиянием геометрий. CX Codex +1 ★ 4 719звёзд репо

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

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