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

shader-mobile — правило для Claude Code: что делает и как установить

Правило shader-mobile для Claude Code содержит приёмы оптимизации GLSL и Three.js шейдеров под мобильные GPU, помогающие избежать просадок FPS на смартфонах.

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

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

Что делает shader-mobile

Правило фиксирует практические приёмы разработки под мобильные графические процессоры. В инструкциях заложено требование использовать точность mediump вместо highp, так как мобильные чипы считают её примерно вдвое быстрее. Также правило предписывает упаковывать интерполируемые данные в vec4, чтобы число переменных varying не превышало трёх, и собирать несколько масок в каналы одной RGBA-текстуры ради сокращения чтений из памяти на 75%.

В шейдерном коде заменяются ветвления if/else на функции mix() и step(), динамические циклы переводятся на константный размер с ранним выходом через #define, а инструкция discard вытесняется свойством alphaTest. Часть расчётов выносится на CPU, а для кроссплатформенности предлагается задействовать Three.js Shading Language (TSL). Без поддержки GLSL или WebGL-материалов в проекте от этих директив пользы не будет.

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

  • заменить медленные ветвления if/else на step() и mix()
  • упаковать несколько varying в единый vec4
  • сократить обращения к текстурам за счёт упаковки в RGBA
  • избавиться от динамических циклов в шейдере
  • заменить инструкцию discard на свойство alphaTest

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

  • Оптимизируй фрагментный шейдер в CustomMaterial.js под мобильные GPU
  • Упакуй varying-переменные в waterShader.glsl, чтобы уложиться в лимит
  • Перепиши динамический цикл расчёта освещения на фиксированный с константой

Как установить shader-mobile

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

.claude/rules/shader-mobile.md

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

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

Вопросы о shader-mobile

Как установить shader-mobile в Claude Code?

Создайте файл правила по пути .claude/rules/shader-mobile.md и сохраните в него содержимое инструкции.

Что делает правило shader-mobile?

Оно направляет ИИ-ассистента на оптимизацию шейдерного кода под ограничения мобильных чипов: задаёт дефолтную точность mediump, ограничивает число varying и убирает дорогостоящие операции ветвления.

Почему правило запрещает использовать discard во фрагментных шейдерах?

Вызов discard нарушает работу раннего теста глубины на мобильных чипах, поэтому инструкция советует переходить на material.alphaTest с отключённой прозрачностью transparent = false.

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

shader-mobile.md · MIT
# Shader Optimization for Mobile

> Source: [100 Three.js Tips - Utsubo](https://www.utsubo.com/blog/threejs-best-practices-100-tips)

Mobile GPUs have specific constraints that require careful shader optimization.

## Use `mediump` Precision

Mobile processes `mediump` ~2x faster than `highp`:

```glsl
precision mediump float;

// Or per-variable
mediump vec3 color;
highp float depth; // Use highp only when necessary
```

## Minimize Varying Variables

Keep under 3 varyings for mobile GPUs by packing data:

```glsl
// BAD: 5 varyings
varying vec3 vPosition;
varying vec3 vNormal;
varying vec2 vUv;
varying vec3 vColor;
varying float vAlpha;

// GOOD: 2 varyings with packed data
varying vec4 vPositionAlpha; // xyz = position, w = alpha
varying vec4 vNormalUv;      // xy = normal.xy, zw = uv
// Reconstruct normal.z in fragment shader
```

## Replace Conditionals with `mix()` and `step()`

Branching is expensive on mobile GPUs:

```glsl
// BAD: Conditional
if (value > 0.5) {
  color = colorA;
} else {
  color = colorB;
}

// GOOD: Branchless
color = mix(colorB, colorA, step(0.5, value));
```

## Pack Data into RGBA Channels

Reduces texture fetches by 75%:

```glsl
// BAD: 4 texture fetches
float value1 = texture2D(tex1, uv).r;
float value2 = texture2D(tex2, uv).r;
float value3 = texture2D(tex3, uv).r;
float value4 = texture2D(tex4, uv).r;

// GOOD: 1 texture fetch
vec4 data = texture2D(dataTex, uv);
float value1 = data.r;
float value2 = data.g;
float value3 = data.b;
float value4 = data.a;
```

## Avoid Dynamic Loops

Use fixed loop bounds to enable compiler optimization:

```glsl
// BAD: Dynamic loop
for (int i = 0; i < numLights; i++) {
  // ...
}

// GOOD: Fixed loop with early exit
#define MAX_LIGHTS 4
for (int i = 0; i < MAX_LIGHTS; i++) {
  if (i >= numLights) break;
  // ...
}
```

## Avoid `discard`

Use `alphaTest` instead:

```javascript
// Instead of discard in shader
material.alphaTest = 0.5;
material.transparent = false; // Avoid transparent sorting
```

## Use TSL for Cross-Platform

TSL automatically optimizes for the target platform:

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

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

## Precompute on CPU

Move constant calculations out of shaders:

```javascript
// CPU: Compute once
const inverseViewMatrix = camera.matrixWorld.clone();
material.uniforms.uInverseView = { value: inverseViewMatrix };

// Update only when camera moves
camera.addEventListener('change', () => {
  material.uniforms.uInverseView.value.copy(camera.matrixWorld);
});
```

## Mobile Shader Checklist

- [ ] Use `mediump` precision by default
- [ ] Limit varyings to 3 or fewer
- [ ] Pack data into vec4 where possible
- [ ] Replace conditionals with mix/step
- [ ] Use fixed loop bounds
- [ ] Pack multiple values into single texture
- [ ] Avoid `discard`, use `alphaTest`
- [ ] Precompute constants on CPU
- [ ] Use TSL for automatic optimization

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

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
shader-glsl iart-ai Скилл shader-glsl помогает писать фрагментные шейдеры GLSL для генеративного фона, переходов между картинками и эффектов в Three.js. CX Codex +1 2 300установок shader-dev MiniMax-AI Скилл shader-dev для Claude Code содержит руководства по 36 техникам GLSL и генерирует шейдеры для ShaderToy и WebGL2. Техники охватывают процедурное 3D, рей-марчинг и визуальные эффекты в коде. CX Codex +1 2 800установок shader-noise Bbeierle12 Скилл shader-noise для Claude Code даёт GLSL-функции процедурного шума для генерации текстур, ландшафтов, облаков и клеточных узоров в шейдерах. CX Codex +1 121установок threejs-shaders CloudAI-X Скилл threejs-shaders помогает писать кастомные GLSL-шейдеры и материалы для Three.js r186, настраивать униформы и переводить код на TSL для WebGPU. CX Codex +1 22 000установок threejs mrgoonie Собирает 3D-сцены, шейдеры и VR-опыты на Three.js. Закрывает задачи с WebGL и WebGPU. CX Codex +1 1 300установок 3d-ultra-realistic-water MengTo Скилл 3d-ultra-realistic-water для Claude Code и Cursor: собирает открытое море в Three.js с волнами Герстнера, бликами солнца, пеной и кильватерным следом. Работает со сценами, где есть горизонт и движущаяся камера. CX Codex +1 771установок

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

Весь набор →
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звёзд репо object-pooling Правило object-pooling учит агента переиспользовать снаряды, частицы и NPC из пула, вместо того чтобы создавать и удалять меши каждый кадр. CX Codex +1 ★ 4 719звёзд репо drei-use-gltf Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber. CX Codex +1 ★ 4 719звёзд репо perf-zustand-selectors Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных. CX Codex +1 ★ 4 719звёзд репо geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо webgpu-renderer Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU. CX Codex +1 ★ 4 719звёзд репо

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

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