shader-mobile — правило для Claude Code: что делает и как установить
Правило shader-mobile для Claude Code содержит приёмы оптимизации GLSL и Three.js шейдеров под мобильные GPU, помогающие избежать просадок FPS на смартфонах.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/shader-mobile.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/shader-mobile.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/shader-mobile.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/shader-mobile.mdВручную: положить файлы
.clinerules/shader-mobile.mdПо шагам, с командами для каждой платформы: 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