Godot 引擎版本迁移
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-version-migration。
技能介绍
你想解决什么问题
老项目停在 Godot 1.x、2.x 或 3.x,要升到当前库目标 Godot 4.7+,但官方文档按「当前 API」写,领域技能也只描述现行用法。真正可怕的是:一次跳多个大版本、4.x 之间乱升,或把 Domain Skill 正文当成迁移 changelog——改完编译不过、多人联机协议对不上、Mesh 资源被「Restart & Upgrade」毁在无备份环境里。
技能如何工作
本技能扮演版本升级编排器,不承担「一键 1.x→4.x」幻想,而是按检测到的时代走强制路由:
- 版本识别:读
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 则按子系统加载对应references/*.md,且只加载项目里实际存在的模块迁移笔记(来自各技能references/migration-notes.md镜像),而非整块 Domain Skill 正文。 - 语料与约束:以官方 docs changelog、interactive changelog、下载归档、GitHub releases、migrating index 为参照;大版本链 1→2→最新 3→4.0,再在 4.0→4.1→…→4.7 上逐 minor hop,每跳后稳定;混用服务端/客户端 4.x minor(尤其 4.2↔4.3 SceneMultiplayer)与高等级多人游戏场景需格外谨慎。
边界与注意点
- 3→4 转换工具不会自动备份,运行前需完整备份;4.1→4.2 Mesh 格式变更时,无 VCS 备份勿选 Mesh「Restart & Upgrade」。
- 迁移完成后,当前 API 的日常开发应切到 godot-master 等领域技能;架构评估、Never-list 审计、CI 无头烘焙等由下游技能在目标版本上接力。
本技能解决的是有纪律的升级路径,不是替代你读 changelog 与做回归测试。
使用场景
- 仓库里的 `project.godot` 仍指向 Godot 3.x,计划升到 4.7,需要按官方桥接文档逐段改 API 而非直接套用当前领域技能示例。
- 团队在 4.2 上跑 SceneMultiplayer,要升到 4.3+,需要查清协议变更并避免服务端与客户端 minor 版本混搭。
- 2.x 遗留工程要先落到最新 3.x 稳定版,再决定是否进入 3→4 转换器,避免从大版本中间状态硬跳 4.x。
- 4.0 到 4.7 之间只需跨几个 minor,需要在每一跳后跑通导出与 CI,并只加载项目里实际用到的物理、2D、网格等子系统迁移笔记。
适合人员
- 维护十年期 Godot 商业项目的技术负责人,要把 2.x/3.x 分支按规定大版本链升到 4.7 且每跳可回滚
- 独立开发者手头的开源 Demo 卡在 Godot 3.4,想用 AI 协助对照 era-index 与 bridges 文档而不是幻觉式「全自动转换」
- 工作室 DevOps 负责人在每次 4.x minor 升级后要用无头引擎跑 CI,并确认与 godot-builder 技能衔接的烘焙目标
- 多人游戏客户端程序员,在 4.2↔4.3 升级窗口需要核对 SceneMultiplayer 与联机发布策略,避免混版本联调