Agent Skills
返回列表
💻

Godot 引擎版本迁移

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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」幻想,而是按检测到的时代走强制路由:

  1. 版本识别:读 project.godot 的 config_version / config/features,或遗留 engine.cfg;含糊时向用户确认,并对照 references/era-index.md 映射时代。
  2. 工作流路由: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 正文。
  3. 语料与约束:以官方 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 与联机发布策略,避免混版本联调