3Dviz Pro Max — скилл для 3D-визуализации на Three.js и Blender

· 1 мин чтения
3d threejs blender ai-skill visualization
📂 Исходный код на GitHub

Agent skill for creative 3D visualization: turn an idea into a Three.js/Blender scene worth exploring. Claude Code + Codex plugin, 223 recipes, 440 knowledge records, 22 proved kits, 37 runnable studies.

3Dviz Pro Max — скилл для 3D-визуализации на Three.js и Blender

3Dviz Pro Max

3Dviz Pro Max — это standalone-навык (skill) для творческой 3D-визуализации, который превращает одну фразу на естественном языке в интерактивную сцену на Three.js или Blender. Навык работает как плагин для Claude Code и Codex, предоставляя агенту десятишаговый workflow, каталог рецептов и набор готовых компонентов для построения 3D-миров.

Что внутри

Навык поставляется как папка skills/3dviz-pro-max/ — её нужно копировать целиком, а не отдельный SKILL.md. Структура включает:

  • SKILL.md — основной файл с десятишаговым workflow
  • Рецепты — 223 рецепта, охватывающих 24 направления (от анатомии и математики до фэнтезийных деревень и механизмов)
  • Записи знаний — 440 записей с проверенными источниками; 69 из них содержат числовые параметры по умолчанию (палитры, освещение, камеры, материалы)
  • Комплекты (kits) — 22 проверенных blueprint'а с четырьмя реальными скриншотами и SHA-256 верификацией
  • Шаблоны — Vite + Three.js каркас с пятью ригами (орбитальная камера, солнце, ночные фонари, студия, пост-обработка)
  • Примеры — 37 запускаемых Three.js-стадий по пяти главам: анатомия и физиология, математика, физика и механизмы, созданные миры и реквизит, световые исследования

Как это работает

Агент получает на вход одно предложение на естественном языке и проходит десять шагов:

  1. Намерение и визуальное направление — определение сюжета и стиля
  2. Рассуждение об объектах — какие формы, материалы, поведение нужны
  3. Маршрутизация — использовать готовый комплект, адаптировать или создать новый
  4. Построение первого вида — первичная сборка сцены
  5. Запуск и захват кадров — реальный рендер на GPU с проверкой через capture.py
  6. Уточнение — доработка по субъективным и объективным критериям
  7. Честный отчёт — что построено vs что реально отображается

Ключевой принцип — кадры, а не обещания. Скрипт capture.py прогоняет сцену через именованные виды и делает скриншоты PNG. Агент проверяет, что реально появилось на экране, а не описываемый результат.

Направления

Навык покрывает 24 направления, каждое с набором авторских тем:

  • Среды: фэнтезийные деревни, пещеры, ночные рынки, парящие архипелаги
  • Персонажи и анимация: кукольные спектакли, патрулирование существ, полёт крылатых
  • Продукты и сборки: динамики, лампы, камеры, велосипеды, мебель
  • Архитектура и интерьеры: разрезы домов, расстановка мебели, освещение
  • Анатомия: разрезы сердца, слои колена, скелет, мозговые атласы
  • Математика: линейная алгебра, анализ, топология, теория вероятностей
  • Физика: жёсткая механика, волны, оптика, тепловые модели
  • Алгоритмы: BFS, Dijkstra, сортировки, структуры данных
  • Робототехника: прямая и обратная кинематика, траекторное управление
  • И многие другие

Установка

Claude Code

# Симлинк в папку навыков
ln -s "$(pwd)/skills/3dviz-pro-max" ~/.claude/skills/3dviz-pro-max

# Или загрузить как плагин из чекаута
claude --plugin-dir /path/to/3dviz-pro-max

# Или из упакованного ZIP
claude --plugin-dir 3dviz-pro-max-0.1.0-plugin.zip

Codex

Скопируйте папку 3dviz-pro-max в директорию навыков Codex и укажите имя навыка в первом промпте.

Зависимости

  • Playwright (опционально) — pip install playwright && playwright install chromium — нужен для захвата скриншотов
  • Blender 4.2+ (рекомендуется, не обязательно) — без него комплекты ограничиваются уровнем T2

Примеры запуска

В папке examples/ находятся 37 готовых стадий:

cd examples
pnpm install
pnpm dev        # открыть http://localhost:4180/heart/

Веб-сайт

Проект имеет лендинг 3dviz.dev, который собирается из репозитория на Vite + React и показывает все 37 стадий как демо-карточки.

Честные ограничения

  • Рецепты описывают, как моделировать и проверять тему, но не гарантируют, что каждый рецепт был отрендерен
  • Записи знаний — это редакционно проверенные руководства, а не наблюдения в рантайме
  • Из 22 комплектов T2 (процедурные текстуры) доказан на 18; T3 (Blender bake) — 2 штуки; T4 нигде не поставляется
  • В контролируемом тесте навык показал результат 25 из 30 против baseline 21 — положительная динамика, но малая выборка

Ссылки

Источник: https://github.com/viettranx/3dviz-pro-max