SuperAPI AI 工具集

rails-engine-release

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:在把 Rails Engine 作为 gem 发布或准备新版本时使用,目标是让宿主应用的升级可预期。

主要能力:给出发布顺序(确认变更范围、判断兼容性影响、确定版本号、更新 changelog 与升级说明、核对 gemspec、确认测试与安装文档);提供版本规则:Patch 修 bug,Minor 向后兼容的新功能,Major 破坏性变更;要求弃用代码至少保留一个 minor 周期并说明替代与移除计划。

使用方式:按清单操作——gemspec 元数据保持最新、version 常量只更新一次、changelog 记录面向用户的变化(按 Added/Changed/Fixed/Deprecated 分组)、明确迁移或安装变化、校对 README。升级说明应包含宿主必需的代码改动、迁移步骤、配置增删、Rails/Ruby 兼容变化和弃用替代项。示例中升级步骤为 bundle update my_engine。硬性要求:未更新 CHANGELOG 和版本文件不得发布。

适用场景:Rails Engine 的补丁、功能与主版本发布,以及需要迁移指南的破坏性变更。

限制与提醒:无迁移指南不得做 Major 发布;不得未经历弃用周期就移除代码;发布前应做 dry-run 或暂存校验;避免用 git log 代替面向用户的 changelog。与 rails-engine-docs、rails-engine-compatibility、rails-engine-testing 可串联使用。代码、命令与产品名称保持原样,未提供的价格或平台信息暂未提供。