用途
Godot Version Migration 是一个面向引擎版本升级的编排型技能（orchestrator），帮助把 Godot 项目从早期版本一路升级到该技能库的目标版本。库目标为 Godot 4.7+。领域技能（Domain Skills）记录的是当前 API，本中枢负责升级路径。
其语料来源包括：文档更新日志、交互式更新日志、下载归档、GitHub 发行版以及迁移索引（链接见原文）。
主要能力
- 版本检测：通过读取 project.godot 中的
config_version、config/features，或旧版 engine.cfg 判断项目版本；文件不明确时向用户询问；再映射到 references/era-index.md 中的世代。 - 工作流路由：按检测到的世代加载对应参考文件，例如 1.x/早期 2 加载 legacy/pre-2-context.md；2.x 先加载 legacy/2-to-3.md 并稳定在最新 3.x；3.x 加载 bridges/3-to-4.md 加官方 3→4 指南；4.x（低于 4.7）加载官方逐跳指南与 hop-index.md 模块笔记；已达 4.7+ 则转向 godot-master / 领域技能。
- 逐跳升级步骤（针对 4.x 次版本）：当 current < 4.7 时，每次只跳一个次版本到 current + 0.1；打开目标版本的官方升级页面；仅从 hop-index.md 打开项目中实际存在子系统的模块笔记；应用修复、在新编辑器中打开、试玩，然后重复。
使用方式
- 先做版本检测，再按工作流路由表选择加载资源。
- 逐跳表包含大版本/桥接资源（1.x 考古、2.x→3.x、3.x→4.0、阶梯总览）与 4.x 各次版本官方指南（4.0→4.1 至 4.6→4.7 的链接）。
- 跨技能清单见 references/hop-index.md。
- 模块目录中的镜像领域技能迁移笔记位于 references/<topic>.md（如 references/2d-physics.md）；中枢自有的 legacy/、bridges/ 和 era-index.md 不属于领域技能镜像。
- 同步命令：
sync_godot_version_migration.py --all
重要约束（NEVER Do）
- 绝不跳过主版本：须按 1.x → 2.x → 最新 3.x → 4.0 的顺序，之后才进入 4.x 次版本阶梯。
- 绝不跳过 4.x 各跳：4.0 → 4.1 → … → 4.7 逐次升级，每跳后需稳定。
- 绝不声称可自动完成 1.x→4.x 转换或逐位精确的自动驾驶式迁移。
- 绝不把领域技能正文当作迁移变更日志——应加载 references/<topic>.md。
- 绝不一次性加载全部模块笔记，只加载项目涉及的子系统。
- 高级多人游戏不要混用服务端/客户端的 4.x 次版本（尤其在 4.2→4.3 的 SceneMultiplayer 协议变更前后）。
- 没有版本控制备份时，不要对 Mesh 选择 “Restart & Upgrade”（4.1→4.2 网格格式）。
- 运行 3→4 转换器前必须有完整备份（该工具不会自动备份）。
适用场景
适用于任何需要将 Godot 项目升级到 4.7 目标的场合，包括旧世代（1.x/2.x）项目迁移、3→4 大版本转换，以及 4.x 次版本逐跳升级；也适用于查找按领域技能划分的迁移笔记。
限制
不提供 1.x→4.x 的自动转换。不负责当前 API 的教学（那是领域技能与 godot-master 的职责）。不提供比文中列出的更多细节；价格、收费、平台等事实暂未提供。
相关技能
- Master：godot-master——迁移完成后当前领域技能模块的库路由。
- Downstream / consumers：godot-analyst（按目标 API 评估架构）、godot-auditor（升级后校验禁用清单/旧语法）、godot-builder（每次跳转后对新引擎目标做 CI/无头构建）。
- Complements：godot-project-foundations（目标版本上的项目设置/结构）、godot-gdscript-mastery（3→4 及 4.x 语言跳转后的类型化 GDScript 2.0 写法）、godot-export-builds（每次涉及平台的跳转后重新验证导出）。
参考资料
官方文档包括：迁移到新版本、从 Godot 3 升级到 Godot 4、文档更新日志（链接见原文）。