review-rails 是一个面向 Ruby/Rails 代码的审查与重构指南类技能,用于分析代码中不必要的自定义对象、类膨胀以及对 Ruby 通用数据结构利用不足的问题,并提供具体的重构步骤与修改前后代码示例。
用途方面,该技能适用于用户要求“审查 Rails 代码”“审计 Rails 应用”“查找 Rails 中的过度工程”“简化 Rails 服务”“审查……”等场景,目标是发现并减少不必要的抽象,使代码更简洁。
范围确定方面,技能根据用户请求确定审查范围:若给出文件路径(如 app/models/user.rb),仅分析这些文件;若给出目录路径(如 app/services/),分析该目录下所有 Ruby 文件;若给出分支名,则对比当前分支与该分支,仅审查变更文件;若未指定范围,则执行全代码库审计;若指定关注领域(如“服务对象”“值对象”),则优先分析该方面。
使用方式上,技能要求强制加载 simplifying-ruby-code 技能,并在整个分析过程中应用其原则,同时明确引用具体模式(例如“模式 1:命令对象 -> 模块函数”)。
主要能力体现在反模式扫描上,包括:服务对象泛滥,如仅含单个方法(call、perform、execute)的服务类、无状态或实例变量的服务、仅包装其他方法的服务;值对象过度使用,如为简单数据对(坐标、范围)创建自定义类、无行为或校验的值对象、缺少 Ruby 协议实现(to_h、to_a、to_json);自定义 DSL 与不必要抽象,如重新发明 ActiveRecord 模式、超过 3 层的深继承层次、仅有单一实现的抽象基类;反函数式模式,如有状态但可改为模块的工具类、仅含类方法的类(应改为模块)、可变对象但不可变即可满足的场景。
输出格式方面,对每个发现的问题,技能提供文件与位置(含行号)、问题说明(为何违反简洁原则)、修改前代码、修改后代码、迁移步骤(如何安全重构)以及测试注意事项(哪些测试需要更新)。发现结果按关键问题(优先修复)、改进项(考虑重构)、发现的良好模式以及含推荐重构顺序的总结进行组织。
Rails 特定考虑包括:ActiveRecord 模型应保持为类以利用面向对象特性(关联、校验、回调),但业务逻辑应提取为纯函数/模块,concern 用于跨模型共享行为而非堆放杂项;Rails 服务对象中,单方法无状态的可移至模型类方法或模块函数,复杂编排可保留为服务对象但需分离决策与副作用,后台任务因需要序列化而适合使用服务对象;Rails 辅助方法与模块方面,视图辅助方法仅用于视图特定格式化,业务逻辑应放在使用 module_function 的独立模块中,不要混用视图格式化与业务规则。
限制方面,该技能聚焦于 Ruby/Rails 代码的简洁性与重构审查,资料未提供其他语言支持、自动化修复执行或性能基准等信息。