如何使用 AI 分析并评估 Rails 框架升级方案

解决 Rails 版本升级时盲目更新导致配置丢失或依赖冲突的问题：通过 AI 自动化分析当前版本、检索最新版本及官方 Diff，为开发者提供一份详细的升级风险评估和分步迁移计划。

为什么需要这个技能

升级 Ruby on Rails 框架并非简单的修改 Gemfile 版本号。大版本更新通常伴随着破坏性变更（Breaking Changes）、配置文件的结构调整以及与之配套的 JavaScript 库（如 Turbo, Stimulus）的同步更新。

如果直接运行 rails app:update，极易覆盖掉项目中精心定制的配置文件。本技能让 AI 扮演“升级专家”，在执行操作前先进行全方位的静态分析，识别哪些文件需要直接覆盖，哪些需要手动合并，从而将升级风险降至最低。

环境验证与版本识别：AI 扫描 Gemfile.lock 确定精确的当前版本，并通过 GitHub API 获取最新的稳定版本。
多维数据检索：
- 访问 guides.rubyonrails.org 提取针对该版本跳跃的官方升级指南。
- 通过 railsdiff.org 获取具体配置文件的差异对比。
JS 依赖审计：检查 package.json 或 importmap.rb，分析 @rails 和 @hotwired 相关包的更新需求。
复杂度量化评估：根据版本跳跃幅度、破坏性变更数量及依赖复杂度，将升级难度评级为“小、中、大”。
制定选择性更新计划：
- 新文件：直接创建。
- 无定制文件：安全覆盖。
- 有定制文件：AI 提供“本地版本 vs 默认版本 $\to$ 建议合并版本”的对比方案，拒绝盲目覆盖。
验证与收尾：引导运行测试集，逐步启用 new_framework_defaults，最后更新 config.load_defaults。

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

暂无推荐