Годоген: Навыки Клода в Кодировании для Полной Генерации Игр на Godot

Godogen — это конвейер, который принимает текстовый запрос и генерирует полные, готовые к игре проекты Godot 4. Он использует навыки Claude Code для проектирования архитектуры, генерации 2D/3D-ассетов, написания GDScript и визуального тестирования.

Инженерные решения

Разработчик решил три конкретные проблемы:

• Нехватка обучающих данных: У языковых моделей минимальные данные по обучению GDScript. Godogen включает пользовательскую справочную систему с рукописной спецификацией языка, полной документацией API, преобразованной из XML-исходников Godot, и базой данных особенностей для недокументированного поведения движка. Агент лениво загружает только необходимые API во время выполнения, чтобы избежать переполнения контекстного окна из-за ~850 классов Godot.
• Состояние во время сборки и выполнения: Сцены генерируются скриптами без графического интерфейса, которые строят графы узлов в памяти и сериализуют их в файлы .tscn, избегая хрупкости ручного редактирования формата сериализации Godot. Модель обучается тому, какие API доступны на каждом этапе и что каждому узлу нужно правильно установить владельца.
• Цикл оценки: Отдельный агент Gemini Flash действует как визуальный QA, анализируя отрендеренные скриншоты из запущенного движка, чтобы выявлять визуальные ошибки, такие как z-fighting, плавающие объекты, физические взрывы и сетчатые размещения, которые должны быть органичными.

Архитектура и настройка

Система работает как два навыка Claude Code: оркестратор, который планирует конвейер, и исполнитель задач, который реализует каждый этап в окне context: fork, чтобы предотвратить ошибки и накопление состояния.

Предварительные требования:

• Godot 4 (без графического интерфейса или редактор) в PATH
• Установленный Claude Code
• API-ключи в качестве переменных окружения: GOOGLE_API_KEY для Gemini (генерация изображений и визуальный QA), TRIPO3D_API_KEY для Tripo3D (преобразование изображений в 3D-модели, только для 3D-игр)
• Python 3 с pip

Начало работы:

Запустите ./publish.sh ~/my-game, чтобы создать новую папку проекта со всеми установленными навыками. Это создаёт целевую директорию с .claude/skills/ и CLAUDE.md, затем инициализирует git-репозиторий. Откройте Claude Code в этой папке и опишите, какую игру сделать — навык /godogen обрабатывает всё остальное.

Примечания по производительности:

• Один цикл генерации может занимать несколько часов
• Запуск на облачной ВМ с GPU T4 или L4 хорошо подходит для захвата скриншотов Godot
• Claude Code с Opus 4.6 даёт наилучший результат; Sonnet 4.6 работает, но требует большего руководства пользователя
• OpenCode — жизнеспособная альтернатива, и портирование навыков несложно

Генерация ассетов: Gemini создаёт 2D-графику и текстуры; Tripo3D преобразует выбранные изображения в 3D-модели. Система учитывает бюджет, максимизируя визуальное воздействие на каждый потраченный цент.

Протестированная среда: Ubuntu и Debian. macOS не тестировалась — захват скриншотов зависит от X11/xvfb/Vulkan и требует собственного пути захвата.