# godot-version-migration

Скилл godot-version-migration ведёт проект по лестнице версий Godot по одной ступени: с 1.x и 2.x до 3.x, потом мост 3→4 и минорные шаги до 4.7.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 190 установок · ★ 983 у репозитория
- Автор: thedivergentai
- Лицензия: LGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-version-migration/SKILL.md
- Обновлён: 2026-10-16
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/godot-version-migration

## Что делает

Скилл определяет эру проекта по `project.godot` (`config_version`, `config/features`) или по старому `engine.cfg` и выдаёт маршрут: 1.x и ранние 2.x, затем 2→3, остановка на последней 3.x, мост 3→4 и дальше лестница минорных версий до 4.7.

Шаги жёсткие. Из 4.x за проход берётся ровно один шаг `current + 0.1`, после каждого — открыть проект в новом редакторе и поиграть. Заметки по подсистемам лежат в `references/<topic>.md`, грузить их все сразу не нужно: только те, что есть в проекте. Скрипт `sync_godot_version_migration.py --all` обновляет зеркала этих заметок.

Конвертер 3→4 своих копий не делает, поэтому без полного бэкапа его не запускают. Смена формата меша на 4.1→4.2 через «Restart & Upgrade» тоже требует чистого состояния в VCS. Для высокоуровневого мультиплеера сервер и клиент держат на одной минорной версии: протокол SceneMultiplayer меняется между 4.2 и 4.3.

## Требования
- Работает с: Godot

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/godot-version-migration/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/godot-version-migration/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/godot-version-migration/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/godot-version-migration/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-version-migration
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/godot-version-migration/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-version-migration
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/godot-version-migration/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-version-migration -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-version-migration/SKILL.md

## Когда брать
- перевести проект с Godot 3 на 4.0 без пропуска обязательной остановки на 3.x
- найти ломающие изменения для подсистем, которых касается конкретный минор
- определить версию движка по `project.godot` или старому `engine.cfg`
- расписать лестницу 4.0 → 4.7 с плейтестом после каждого шага
- согласовать версии сервера и клиента перед апгрейдом мультиплеера

## Примеры запросов агенту
- Определи версию Godot по `project.godot` и распиши маршрут миграции до 4.7
- У нас проект на 4.1 — какие шаги нужны до 4.7 и какие заметки по 2D-физике читать?
- Составь план перехода с 3.x на 4.0 и скажи, что сохранить перед запуском конвертера

## Похожие
- [godot](https://affpapa.org/nevibecode/rules/godot.md) — правило · ★ 3589 у репозитория
- [godot-gdscript-patterns](https://affpapa.org/nevibecode/skills/godot-gdscript-patterns.md) — скилл · 17396 установок
- [godot-ui-control](https://affpapa.org/nevibecode/skills/godot-ui-control.md) — скилл · 13100 установок
- [godot-signals-groups](https://affpapa.org/nevibecode/skills/godot-signals-groups.md) — скилл · 12300 установок
- [spritecook-use-assets-in-godot](https://affpapa.org/nevibecode/skills/spritecook-use-assets-in-godot.md) — скилл · 773 установки
- [godot-export](https://affpapa.org/nevibecode/skills/httpsgithubcomarjun988-godot-export.md) — скилл · 537 установок

Из того же набора: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 100 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
