用途:作为 Godot 项目引擎版本升级的编排中枢,负责升级路径管理;具体 API 由各 Domain Skill 记录,本技能只管迁移路线。库目标为 Godot 4.7+。
主要能力:识别项目版本(读取 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 小版本升级时,每次只跳一个小版本(当前+0.1),打开目标版本官方升级页,仅加载项目中实际存在的子系统模块笔记,修复后在新编辑器打开、试玩、重复。模块笔记位于 references/<topic>.md,可用 sync_godot_version_migration.py --all 同步。
限制:禁止跳过主版本(须 1.x→2.x→最新3.x→4.0 再进入 4.x 小版本阶梯);禁止跳过 4.x 小版本;不得声称可自动完成 1.x→4.x 转换或位精确自动驾驶;不得把 Domain Skill 正文当作迁移变更日志;不得一次性加载全部模块笔记;高层多人游戏不得混用服务端/客户端小版本(尤其 4.2→4.3 SceneMultiplayer 协议变更);Mesh“Restart & Upgrade”与 3→4 转换器均须先做完整备份。相关技能包括 godot-master、godot-analyst、godot-auditor、godot-builder 等。