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

setup-use-import-maps — правило для Claude Code

Правило setup-use-import-maps требует подключать Three.js через import map с модулями и точной версией, а не старым тегом <script src> с CDN.

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

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

Что делает setup-use-import-maps

Правило про то, как Three.js попадает на страницу. Вместо тега <script src> с CDN-ссылкой на three.min.js нужен блок <script type="importmap">: в нём three ведёт на three.module.js, а префикс three/addons/ — на каталог examples/jsm/. Дальше код живёт в <script type="module">, и OrbitControls приходит из three/addons/controls/OrbitControls.js.

Что не так со старым паттерном: глобальная THREE засоряет пространство имён, сборщик не выкидывает неиспользуемый код, версии конфликтуют, разрешение модулей ломается. Лечится одной картой с точной версией, в примерах это [email protected].

Для WebGPU в правиле отдельная карта: three указывает на three.webgpu.js, появляется псевдоним three/tsl для three.tsl.js, three/addons/ остаётся на месте. Если проект уже грузит глобальный THREE из r128, подключение придётся переписать целиком — иначе конфликт версий никуда не денется.

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

  • перевести проект с глобального THREE на ES-модули
  • зафиксировать версию Three.js в одном месте
  • подключить OrbitControls без копирования файлов из examples/jsm/
  • понять, почему сборщик не выкидывает неиспользуемый код
  • собрать карту импортов под WebGPU-рендер

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

  • Перепиши подключение Three.js на import map: three из three.module.js, аддоны из examples/jsm/.
  • Замени тег <script src> с three.min.js на <script type="importmap"> и модульные импорты.
  • Добавь в карту импортов three/tsl для WebGPU-сборки.

Как установить setup-use-import-maps

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

.claude/rules/setup-use-import-maps.md

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

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

Вопросы о setup-use-import-maps

Как установить setup-use-import-maps в Claude Code?

Файл правила кладут по пути .claude/rules/setup-use-import-maps.md. Внутри markdown с примерами плохого и хорошего подключения, отдельных команд установки нет.

Что делает setup-use-import-maps?

Заменяет устаревшее подключение Three.js тегом <script src> на import map с модулями и фиксированной версией.

Чем плох старый CDN-паттерн?

Такой тег создаёт глобальную THREE, мешает tree shaking и ломает разрешение модулей. При двух версиях на странице начинаются конфликты.

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

setup-use-import-maps.md · MIT
# setup-use-import-maps

**Use Import Maps instead of old CDN script tags.**

## Why It Matters

The old CDN pattern (`<script src="...three.min.js">`) is outdated and causes:
- Module resolution issues
- No tree shaking
- Global namespace pollution
- Version conflicts

## Bad Example

```html
<!-- WRONG - Outdated pattern (DO NOT USE) -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js"></script>
<script>
  // THREE is global, no modules
  const scene = new THREE.Scene();
</script>
```

## Good Example

```html
<!-- CORRECT - Modern Import Maps pattern -->
<script type="importmap">
{
  "imports": {
    "three": "https://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js",
    "three/addons/": "https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/"
  }
}
</script>
<script type="module">
import * as THREE from 'three';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';

const scene = new THREE.Scene();
</script>
```

## WebGPU Import Map

```html
<script type="importmap">
{
  "imports": {
    "three": "https://cdn.jsdelivr.net/npm/[email protected]/build/three.webgpu.js",
    "three/tsl": "https://cdn.jsdelivr.net/npm/[email protected]/build/three.tsl.js",
    "three/addons/": "https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/"
  }
}
</script>
```

## References

- [Three.js Installation Guide](https://threejs.org/manual/#en/installation)
- [MDN Import Maps](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap)

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

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

Все правила IDE по теме «Фронтенд и UI» →
threejs-fundamentals CloudAI-X Скилл threejs-fundamentals помогает настроить базовую сцену Three.js r186: рендерер, камеры, цикл анимации с THREE.Timer и import map для WebGL или WebGPU с TSL. CX Codex +1 24 100установок threejs-interaction CloudAI-X Скилл threejs-interaction учит агента настраивать выбор объектов, перемещение по плоскости и управление камерой в three.js для WebGL и WebGPU. CX Codex +1 20 100установок threejs-webgl freshtechbro Скилл threejs-webgl для Claude Code учит агента настраивать сцены Three.js, рендереры WebGL и WebGPU, свет, материалы и загрузку glTF-моделей. Описывает настройку Three.js для 3D-визуализаций и конфигураторов. CX Codex +1 5 300установок webgpu-threejs-tsl dgreenheck Скилл webgpu-threejs-tsl помогает писать Three.js-приложения с WebGPU, TSL-материалами, вычислительными шейдерами и постобработкой. CX Codex +1 1 800установок 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

Весь набор →
server-auth-actions Правило server-auth-actions требует проверять аутентификацию и права внутри каждой Server Action. Оно защищает серверные мутации, которые можно вызвать напрямую. CX Codex +1 ★ 4 719звёзд репо render-delta-time Правило render-delta-time предписывает использовать delta time в циклах анимации, чтобы скорость движения не зависела от частоты кадров. CX Codex +1 ★ 4 719звёзд репо memory-dispose-geometry Правило memory-dispose-geometry для Claude Code напоминает освобождать геометрию при удалении объектов из сцены. Оно срабатывает при работе с ресурсами Three.js. CX Codex +1 ★ 4 719звёзд репо root-cause-debugger Субагент root-cause-debugger воспроизводит сбои и находит первопричину багов без правок в коде. Помогает локализовать поломку до начала написания фикса. CX Codex ★ 4 719звёзд репо code-reviewer Субагент code-reviewer для Claude Code проверяет готовые изменения на ошибки и регрессии. Запускается после реализации или при проверке существующего diff. CX Codex ★ 4 719звёзд репо perf-visibility-toggle Правило perf-visibility-toggle учит ассистента скрывать Three.js-компоненты через свойство visible, а не удалять их из дерева React, чтобы видеокарта не пересобирала шейдеры. CX Codex +1 ★ 4 719звёзд репо perf-r3f-perf Правило perf-r3f-perf добавляет в Claude Code знания о r3f-perf — библиотеке для отслеживания производительности Three.js сцен в реальном времени. Помогает находить узкие места: низкий FPS, утечки памяти, лишние пересчёты матриц. CX Codex +1 ★ 4 719звёзд репо codebase-mapper Субагент codebase-mapper исследует структуру репозитория, потоки данных и точки входа перед внесением правок, не меняя рабочий код. CX Codex ★ 4 719звёзд репо

Ещё в каталоге

import-organizer rohitg00 Плагин import-organizer автоматически организует, сортирует и очищает импорты в коде. Экономит время на ручной рефакторинг и делает импорты консистентными. ★ 2 858звёзд репо es-module-nodejs-guidelines-cursorrules-prompt-fil PatrickJS Правило es-module-nodejs-guidelines-cursorrules-prompt-fil настраивает Cursor на работу с современным Node.js и синтаксисом ES-модулей. Оно требует коротких ответов и запрещает пустые извинения за баги. CX Codex +1 ★ 41 178звёзд репо sveltekit-tailwindcss-typescript-cursorrules-promp PatrickJS Правило sveltekit-tailwindcss-typescript-cursorrules-promp задаёт стандарты стека SvelteKit 2, Tailwind CSS и TypeScript для Cursor. Помогает генерировать типизированные компоненты с правильной структурой файлов. CX Codex +1 ★ 41 178звёзд репо tanstack-router-react-cursorrules-prompt-file PatrickJS Правило tanstack-router-react-cursorrules-prompt-file задаёт стандарты TanStack Router v1 в React: файловую маршрутизацию, валидацию search-параметров схемами Zod, загрузчики данных и защиту маршрутов через beforeLoad. CX Codex +1 ★ 41 178звёзд репо

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

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