3Dviz Pro Max — скилл для 3D-визуализации на Three.js и Blender
📂 Исходный код на GitHubAgent 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
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-стадий по пяти главам: анатомия и физиология, математика, физика и механизмы, созданные миры и реквизит, световые исследования
Как это работает
Агент получает на вход одно предложение на естественном языке и проходит десять шагов:
- Намерение и визуальное направление — определение сюжета и стиля
- Рассуждение об объектах — какие формы, материалы, поведение нужны
- Маршрутизация — использовать готовый комплект, адаптировать или создать новый
- Построение первого вида — первичная сборка сцены
- Запуск и захват кадров — реальный рендер на GPU с проверкой через
capture.py - Уточнение — доработка по субъективным и объективным критериям
- Честный отчёт — что построено 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 — положительная динамика, но малая выборка