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

godot-debugging-profiling — скилл для Claude Code: отладка Godot

Скилл для отладки и профилирования игр на Godot: утечки, осиротевшие узлы, GPU-профилировщик, headless-проверки в CI.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-debugging-profiling -a claude-code
Открыть на GitHub

Что делает godot-debugging-profiling

Скилл ведёт агента по цепочке «симптом → монитор → скрипт». Утечки памяти, рост ObjectDB, всплески GPU в Visual Profiler, нестабильные выходы headless-сборок, гонки потоков в логах — под каждый симптом в каталоге лежит готовый GDScript-файл, который агент подключает в проект.

Внутри около двадцати скриптов: детектор осиротевших узлов, алерт по порогу памяти, дамп дерева сцены, высокоточный бенчмаркер на Time.get_ticks_usec, набор для автоматизированной проверки в CI, перехватчик ошибок движка, потокобезопасный логгер, кастомные мониторы для вкладки Debugger и удалённая консоль для мобильных сборок. Есть и список того, чего делать нельзя: профилировать в debug-сборке бессмысленно, потому что она в разы медленнее релизной, а OBJECT_ORPHAN_NODE_COUNT в релизе всегда возвращает 0 и утечку просто не покажет.

Часть приёмов работает только в debug-сборках. Engine.capture_script_backtraces(true) захватывает локальные переменные и сам может мешать объектам освобождаться, так что включать его стоит точечно. Плагин EditorDebuggerPlugin нужно снимать с регистрации в _exit_tree(), иначе в цикле отладки останутся висячие подключения. Профилировать советует релизные сборки с выключенным V-Sync.

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

  • найти осиротевшие узлы, из-за которых растёт потребление памяти
  • отловить нестабильный выход headless-сборки в CI
  • замерить время логики с точностью до микросекунд
  • собрать логи из нескольких потоков без порчи строк
  • вывести метрики движка на вкладку Debugger

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

  • Память растёт, хотя узлы удаляются — проверь OBJECT_ORPHAN_NODE_COUNT и подключи детектор осиротевших узлов
  • Headless-сборка в CI иногда падает с ненулевым кодом — нужен набор для автоматизированной проверки
  • Замерь этот участок через Time.get_ticks_usec, миллисекунд не хватает

Как установить godot-debugging-profiling

1Через Skills CLI (Vercel)

npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-debugging-profiling -a claude-code

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

~/.claude/skills/godot-debugging-profiling/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/godot-debugging-profiling/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Из того же набора50

godot-performance-optimization Набор правил по профилированию и устранению просадок FPS, утечек памяти и лишних вызовов отрисовки в Godot. Пригодится при поиске узких мест в физике, рендере и скриптах. CX Codex +1 483установок godot-state-machine-advanced Скилл для иерархических конечных автоматов и pushdown-автоматов в Godot: готовые скрипты для вложенных состояний, стеков и валидации переходов. CX Codex +1 486установок godot-tweening Скилл с правилами программной анимации в Godot через Tween. Помогает настроить переходы интерфейса, кривые сглаживания и безопасный жизненный цикл твинов. CX Codex +1 475установок godot-economy-system Скилл внедряет архитектуру игровой экономики в Godot: кошельки, таблицы лута и магазины. Он пригодится при разработке RPG и торговых симуляторов. CX Codex +1 455установок godot-3d-lighting Скилл для ИИ-агентов, который подсказывает, как настроить 3D-освещение в Godot: каскады теней, затухание источников, VoxelGI, SDFGI и запекание лайтмапов. CX Codex +1 449установок godot-rpg-stats Скилл для ИИ-агента, который помогает собрать систему характеристик персонажа в Godot: атрибуты, модификаторы, уровни и формулы урона. CX Codex +1 446установок godot-dialogue-system Скилл для ветвящихся диалогов в Godot: графы на Resource, портреты, условия, эффект печатной машинки. CX Codex +1 443установок godot-genre-roguelike Архитектурный свод правил и готовые компоненты для сборки рогаликов на Godot. Помогает настроить процедурные уровни, сиды и разделение мета-прогрессии. CX Codex +1 429установок

Похожие

godot-gdscript-headless-testing gamedev-skills Скилл помогает настроить запуск тестов GDScript в Godot 4 через консоль с флагом --headless. Он нужен для проверки логики в CI без запуска графического редактора. CX Codex +1 3 100установок godot-mcp-enhanced wgt19861219 Даёт агенту 46 MCP-инструментов, чтобы читать, писать, запускать и проверять проекты Godot 4.5–4.7 без открытия редактора. CX Codex +1 ★ 103звёзд репо godot-nodes-scenes gamedev-skills Учит агента собирать проект Godot 4.7 из узлов и сцен: делать переиспользуемые .tscn, ставить инстансы в рантайме и не падать на удалённых узлах. CX Codex +1 6 400установок cli-anything-godot HKUDS Управляет проектами Godot из командной строки: создаёт сцены, запускает GDScript и собирает экспорт. Пригодится для задач, которые агент должен выполнять в проекте. CX Codex +1 548установок godot-best-practices agent-skills Задаёт правила архитектуры и стандарты GDScript для Godot 4.x. Помогает агенту связывать узлы через сигналы, типизировать переменные и настраивать загрузку ресурсов. CX Codex +1 2 100установок godot-prompter jame581 Набор скиллов по разработке игр на Godot 4.x: агент подгружает нужный раздел и следует практикам движка, а не общим советам. ★ 867звёзд репо

Рядом в теме «Геймдев и 3D: Unity, Unreal, Godot, Blender»

Всё по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →

Вопросы о godot-debugging-profiling

Как установить godot-debugging-profiling в Claude?

Выполните npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-debugging-profiling -a claude-code. Скилл появится в ~/.claude/skills/godot-debugging-profiling/SKILL.md.

Что делает godot-debugging-profiling?

Помогает агенту разбираться с утечками, ростом ObjectDB, всплесками GPU, гонками потоков и нестабильными headless-сборками в Godot. Под каждый симптом в скилле есть отдельный GDScript.

Чем этот скилл отличается от обычных туториалов по print и точкам останова?

Он про профилирование и мониторы движка: Visual Profiler, Performance.get_monitor, кастомные вкладки Debugger, перехват ошибок движка. Базовые print и breakpoints здесь не разбираются.

Смотрите также

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

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