用途:分析现有 Rails 应用并给出升级评估,指导从当前版本升级到最新稳定版。
主要能力:验证是否为 Rails 应用(检查 Gemfile、config/application.rb、config/environment.rb);从 Gemfile.lock 或 Gemfile 读取当前版本;用 gh api repos/rails/rails/releases/latest --jq '.tag_name' 获取最新版本并查看近期标签;判定补丁/次要/主要升级;用 WebFetch 获取官方升级指南 https://guides.rubyonrails.org/upgrading_ruby_on_rails.html 与 railsdiff.org/{current}/{target} 的差异;检查 @hotwired/turbo-rails、stimulus、@rails/actioncable、activestorage、actiontext 等 JS 依赖及 importmap 固定版本;输出复杂度评估与推荐步骤。
使用方式:按步骤执行;对 config、bin、public 检测本地定制,将文件分为新建、可安全覆盖、需手工合并、可跳过四类,先展示升级计划再执行;新文件可直接创建,或临时生成新应用提取;需合并的文件保留本地定制并只加必要新功能。
限制:不要直接运行 rails app:update,以免覆盖定制;合并前必须检查并停止确认;结果不能替代针对具体环境的验证、测试或专家复核;gh 未登录需先 gh auth login;railsdiff 无精确版本时可试 major.minor.0。缺失事实暂未提供。