用途
upgrade-cleanup 是 rails-upgrade 插件的配套技能,负责在 Rails 升级的收尾阶段执行清理,移除双启动脚手架,使代码库对齐到最终保留的版本基线。适用于用户已明确决定结束双启动阶段的场景:要么完成升级(保留 next 版本),要么放弃或暂停本次跳版(保留 current 版本)。部署到生产环境并非硬性前提。
主要能力
- 删除 NextRails.next? 与 NextRails.current? 分支,避免遗留分支。
- 移除双启动脚手架(如 Gemfile.next 等)。
- 清理旧版本代码。
- 对齐 CI 与 Ruby 版本 pin。
- 最终验证并生成清理 PR。
使用方式
激活后需按 workflows/upgrade-cleanup-workflow.md 端到端执行。在任何破坏性步骤之前,先于 Phase 0 Step 1 与用户确认方向:保留 next 版本(完成升级,删除 else / current 分支)还是保留 current 版本(放弃或暂停,删除 if NextRails.next? / next 分支及 Gemfile.next*)。检测新版本时读取 Gemfile(查找 if NextRails.next? / else 块,next? 分支即升级到的版本)或 Gemfile.next.lock,不要仅依赖 Gemfile.lock。
限制与注意事项
- 未确认方向前不得开始删除分支,否则可能丢弃用户想保留的工作。
- 不得在代码树中遗留 NextRails.next? 或 NextRails.current? 分支。
- load_defaults 对齐不在本技能范围内,由 rails-upgrade 技能在其 rails-load-defaults 步骤中处理。
- 双启动插件中较旧的 workflows/cleanup-workflow.md 仅为可选参考;若与本工作流冲突,以本技能的工作流为准。