GS
godot-gdscript-headless-testing
Запускает тесты GDScript через `godot --headless` и завершается с кодом ошибки при сбое, что позволяет блокировать слияние в CI. Полезно для автоматизированного тестирования Godot-проектов без запуска редактора.
Что делает навык
Запускает тесты GDScript через команду godot --headless без графического интерфейса и возвращает код выхода процесса, позволяя CI-системам блокировать слияние при сбое тестов. Решает задачу автоматизированной проверки логики, загрузки ресурсов и состояния autoload в терминале или пайплайне.
Когда применять
- Когда в проекте Godot нет установленного тестового аддона и нужна быстрая проверка GDScript-логики из терминала или CI.
- При настройке CI-задачи, которая должна завершаться ошибкой сборки при падении .gd теста.
- При отладке ситуаций, когда godot --headless зависает, открывает окно или завершается с кодом 0, несмотря на ошибки.
- Для проверки чистых функций, загрузки ресурсов и состояния autoload без необходимости запуска редактора.
Как работает
- Убедитесь, что бинарный файл поддерживает headless-режим, запустив godot --headless --version.
- На чистой копии репозитория выполните godot --headless --path <project_dir> --import для заполнения кэша импорта (.godot/).
- Напишите сценарий-раннер, расширяющий SceneTree, с методом _initialize() для запуска тестов.
- Используйте кастомную функцию assert_eq() для подсчета проходов и падений, вызывая quit(1) при ошибках, а не голый assert().
- Запустите тесты командой godot --headless --path <project_dir> --script res://<runner>.gd и проверьте код выхода процесса.
- При необходимости асинхронных тестов используйте await process_frame перед добавлением узлов в дерево.
Примеры запросов агенту
Напиши GDScript-раннер для headless-тестирования Godot 4, который проверяет корректность сложения чисел и возвращает код ошибки при падении.
Создай CI-шаг для GitHub Actions, который импортирует проект Godot и запускает тесты GDScript через godot --headless, с таймаутом 5 минут.
Объясни, почему тест Godot зависает при использовании assert() в _initialize(), и как переписать раннер на SceneTree с подсчетом результатов.
Что понадобится
- Godot 4.x (поддержка --headless встроена, экспорты не требуются)
- Доступ к терминалу или CI-среде для выполнения команд
- Проект Godot с GDScript-файлами для тестирования
Описание составлено по SKILL.md навыка, сверено 10.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «godot-gdscript-headless-testing» из репозитория:
# https://github.com/gamedev-skills/awesome-gamedev-agent-skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r godot-gdscript-headless-testing/ ~/.claude/skills/godot-gdscript-headless-testing/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.