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

asset-compression — правило для Claude Code: как установить

Правило asset-compression с инструкциями по сжатию 3D-ассетов для Three.js. Помогает настроить Draco, Meshopt, KTX2-текстуры и LOD для ускорения 3D-сцен в вебе.

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

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

Что делает asset-compression

Файл задаёт стандарты сжатия геометрии и текстур в Three.js проектах. Внутри собраны готовые параметры вызова gltf-transform, снижающие вес геометрии на 90–95%, а также правила выбора между алгоритмами Draco и Meshopt в зависимости от критичности скорости распаковки.

Отдельный блок посвящён текстурам в формате KTX2: обычный PNG весом 200 КБ занимает свыше 20 МБ в видеопамяти (VRAM), поэтому правило предписывает переводить материалы в UASTC или ETC1S. Также описана настройка путей к декодерам через setDecoderPath и setTranscoderPath, объединение текстур в атласы и создание уровней детализации THREE.LOD, дающих прирост кадровой частоты до 30–40%.

Для работы алгоритмов на клиенте понадобятся внешние декодеры Draco и Basis по путям /draco/ и /basis/, а на этапе сборки — установленный CLI-пакет gltf-transform.

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

  • сжать геометрию GLB-моделей через Draco или Meshopt
  • сократить потребление видеопамяти переходом на текстуры KTX2
  • настроить пути к декодерам DRACOLoader и KTX2Loader
  • внедрить уровни детализации THREE.LOD для разгрузки рендера

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

  • Оптимизируй модель scene.glb с помощью gltf-transform, используя сжатие Draco и текстуры KTX2
  • Покажи, как настроить DRACOLoader и KTX2Loader в коде загрузки модели
  • Добавь уровни детализации THREE.LOD для высокополигональной сетки

Как установить asset-compression

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

.claude/rules/asset-compression.md

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

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

Вопросы об asset-compression

Как установить правило asset-compression в Claude Code?

Сохраните содержимое правила в файл .claude/rules/asset-compression.md в корне вашего проекта.

Что делает правило asset-compression?

Оно даёт ИИ-агенту чеклист и шаблоны команд для оптимизации 3D-моделей: настройку Draco, сжатие текстур в KTX2 (UASTC/ETC1S), создание атласов и конфигурацию LOD.

Когда использовать UASTC, а когда ETC1S для текстур?

UASTC даёт более высокое качество при большем размере и подходит для normal maps или ключевых текстур объекта. ETC1S сильнее сжимает данные и рассчитан на фоновые текстуры и карты окружения.

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

asset-compression.md · MIT
# Asset Compression

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

Proper asset compression is critical for web performance. Unoptimized assets are the #1 cause of slow 3D web experiences.

## Geometry Compression

### Draco Compression

Achieves 90-95% size reduction with Web Worker decompression.

```bash
gltf-transform draco model.glb compressed.glb --method edgebreaker
```

### Meshopt (Alternative to Draco)

Similar compression ratios with faster decompression. Consider Meshopt when decompression speed is critical.

### Setup Decoder Paths

```javascript
import { DRACOLoader } from 'three/addons/loaders/DRACOLoader.js';

const dracoLoader = new DRACOLoader();
dracoLoader.setDecoderPath('/draco/');
```

## Texture Compression

### Why KTX2?

PNG/JPEG decompress fully in GPU memory:
- 200KB PNG = 20MB+ VRAM

KTX2 stays compressed in GPU memory, dramatically reducing VRAM usage.

### UASTC vs ETC1S

| Format | Quality | Size | Use Case |
|--------|---------|------|----------|
| UASTC | Higher | Larger | Normal maps, hero textures |
| ETC1S | Lower | Smaller | Environment textures, backgrounds |

### KTX2 Setup

```javascript
import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';

const ktx2Loader = new KTX2Loader();
ktx2Loader.setTranscoderPath('/basis/');
```

## CLI Optimization

### gltf-transform (Recommended)

```bash
gltf-transform optimize model.glb output.glb \
  --texture-compress ktx2 \
  --compress draco
```

### Visual Comparison Tool

Use [Shopify's gltf-compressor](https://github.com/Shopify/gltf-compressor) for interactive side-by-side compression preview (keyboard shortcut "C").

## Texture Atlasing

Combine multiple textures into atlases to reduce texture binds:

```javascript
// Update UV coordinates to reference atlas regions
mesh.geometry.attributes.uv.array = atlasUVs;
mesh.geometry.attributes.uv.needsUpdate = true;
```

## Level of Detail (LOD)

Can improve frame rates by 30-40%.

```javascript
const lod = new THREE.LOD();
lod.addLevel(highPolyMesh, 0);
lod.addLevel(mediumPolyMesh, 50);
lod.addLevel(lowPolyMesh, 100);
scene.add(lod);
```

## Summary Checklist

- [ ] Compress geometry with Draco or Meshopt
- [ ] Convert textures to KTX2
- [ ] Use UASTC for quality-critical textures
- [ ] Use ETC1S for secondary textures
- [ ] Atlas textures where possible
- [ ] Implement LOD for complex models
- [ ] Set up decoder paths correctly

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

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

Все правила IDE по теме «Фронтенд и UI» →
threejs-asset-pipeline CloudAI-X Скилл threejs-asset-pipeline для сжатия и проверки glTF-моделей перед загрузкой в three.js: команды gltf-transform, Draco, meshopt, KTX2 и gltfjsx. CX Codex +1 6 500установок threejs-gltf-loading gamedev-skills Скилл threejs-gltf-loading для Claude Code загружает модельные файлы .gltf и .glb в three.js версии r187 и запускает для них анимацию. Агент подключает этот скилл при импорте трёхмерных персонажей или отладке невидимых объектов. CX Codex +1 11 200установок blender-web-pipeline freshtechbro Скилл blender-web-pipeline настраивает экспорт 3D-моделей из Blender в веб-формат glTF 2.0. Он помогает автоматизировать сжатие геометрии, запекание текстур и пакетную обработку сцен. CX Codex +1 4 100установок threejs-loaders CloudAI-X Скилл threejs-loaders обучает ИИ загружать 3D-модели glTF, текстуры и HDR-карты в three.js r186. Пригодится при настройке ассетов, цветовых пространств и шкалы прогресса для WebGL или WebGPU. CX Codex +1 18 400установок threejs-webgl freshtechbro Скилл threejs-webgl для Claude Code учит агента настраивать сцены Three.js, рендереры WebGL и WebGPU, свет, материалы и загрузку glTF-моделей. Описывает настройку Three.js для 3D-визуализаций и конфигураторов. CX Codex +1 5 300установок threejs MengTo Помогает агенту собирать и отлаживать интерактивные 3D-сцены на Three.js: сцена, камера, свет, загрузка glTF, контролы и производительность. CX Codex +1 2 500установок

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

Весь набор →
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звёзд репо tsl-why-use Правило tsl-why-use для Claude Code и Codex: кастомные материалы в Three.js собираются из нод TSL, а не через патч onBeforeCompile. Применяется в проектах со своими шейдерами. 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звёзд репо object-pooling Правило object-pooling учит агента переиспользовать снаряды, частицы и NPC из пула, вместо того чтобы создавать и удалять меши каждый кадр. CX Codex +1 ★ 4 719звёзд репо

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

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