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