godot-autoload-architecture — скилл для Claude Code
Скилл про архитектуру AutoLoad в Godot: порядок инициализации, шины событий, сервис-локатор и типичные ошибки. Пригодится, когда в проекте больше одного синглтона.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-autoload-architecture -a claude-codeЧто делает godot-autoload-architecture
Скилл задаёт агенту набор правил и готовых скриптов для синглтонов Godot. Внутри — autoload_init_order_diag.gd для проверки порядка загрузки, singleton_dependency_diagram.gd для карты зависимостей, global_event_bus.gd для шины событий между системами, safe_scene_switcher.gd для переходов между сценами из AutoLoad, а также service_locator.gd и service_registry.gd для регистрации не-Node сервисов через Engine.register_singleton.
Отдельно описано, чего делать нельзя. AutoLoad-ы инициализируются сверху вниз по списку в Project Settings, поэтому верхний синглтон не должен обращаться к нижнему в _ready(). Круговые зависимости между синглтонами вешают Godot ещё на splash screen. Обращаться к AutoLoad из _init() тоже нельзя: сосед может быть ещё не создан.
Есть скрипты для данных, которые должны пережить change_scene_to_file() — инвентарь, настройки, — и для ленивой загрузки синглтона вместо затрат на старте. Для фоновых потоков, трогающих глобальное состояние, приложен thread_safe_global_access.gd с мьютексом и call_deferred. Проверки регистрации и значений по умолчанию лежат в autoload_reference_checker.gd и singleton_health_check_test.gd — их стоит включать в debug и CI.
Какие задачи решает
- разложить порядок инициализации AutoLoad-ов и не поймать null в
_ready() - развести шину событий и хранилище состояния между системами
- переключать сцены из синглтона без висячих ссылок
- зарегистрировать не-Node сервис через
Engine.register_singletonи снять его в_exit_tree - сохранить инвентарь и настройки при смене сцены
Примеры запросов агенту
- Проверь порядок инициализации AutoLoad-ов в проекте и скажи, где верхний синглтон зовёт нижний в
_ready() - Собери шину событий для достижений, UI и сохранений через
global_event_bus.gd - Сделай переход между сценами из AutoLoad через
safe_scene_switcher.gd, без ручногоfree()
Как установить godot-autoload-architecture
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-autoload-architecture -a claude-code2Вручную: положить файлы
~/.claude/skills/godot-autoload-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/godot-autoload-architecture/
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-autoload-architecture -a codex2Вручную: положить файлы
.agents/skills/godot-autoload-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-autoload-architecture -a cursor2Вручную: положить файлы
.cursor/skills/godot-autoload-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-autoload-architecture2Вручную: положить файлы
.github/skills/godot-autoload-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-autoload-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-autoload-architectureВручную: положить файлы
.devin/skills/godot-autoload-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-autoload-architecture -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о godot-autoload-architecture
Как установить godot-autoload-architecture в Claude Code?
Выполните npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-autoload-architecture -a claude-code. Файл скилла окажется по пути ~/.claude/skills/godot-autoload-architecture/SKILL.md.
Что делает этот скилл?
Даёт агенту правила и скрипты для синглтонов Godot: порядок загрузки, зависимости, шина событий, переходы между сценами, сервис-локатор и проверки здоровья синглтонов.
Чем отличается шина событий от хранилища состояния?
Шина шлёт события в прошедшем времени и не хранит изменяемое состояние. Текущее состояние прогона держите в persistent_data_holder.gd или global_game_state.gd.
