SuperAPI AI 工具集

ruby-refactor

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:该技能汇总社区 Ruby 重构最佳实践,在重构、评审或调整 Ruby 代码结构时参考,目标是降低复杂度、改善设计。包含 45 条规则,分 8 类并按影响优先级排序,可用于指导自动化重构与代码生成。

适用时机:减少复杂度、抽取方法/类/值对象、简化复杂条件与深层嵌套、降低类与模块间耦合、采用惯用 Ruby 与现代 Ruby 3.x 特性时。

规则分类与优先级:结构与拆分(CRITICAL,前缀 struct-,含抽取方法、抽取类、参数对象、方法组合、以方法对象替换复杂方法、单一职责、扁平化嵌套);条件简化(CRITICAL,cond-,含卫语句、分解条件、以多态替换 case/when、空对象、模式匹配、合并重复条件片段);耦合与依赖(HIGH,couple-,含迪米特法则、特性依恋、构造器默认值注入依赖、组合优于继承、告诉而非询问、领域逻辑避免类方法);Ruby 惯用法(HIGH,idiom-,含优先 Enumerable、关键字参数、respond_to? 优于 is_a?、谓词方法 ? 后缀、method_missing 配 respond_to_missing?、简单块用 yield、省略显式 return);数据与值对象(MEDIUM-HIGH,data-,含值对象替代基本类型、Data.define 不可变值对象、封装集合、消除数据泥团、查询与命令分离);设计模式(MEDIUM,pattern-,含策略、工厂方法、模板方法、装饰器、完整协议的 Null Object);现代 Ruby 3.x(MEDIUM,modern-,含 case/in 模式匹配、deconstruct_keys、无尽方法定义、带卫语句的模式匹配、右向赋值);命名与可读性(LOW-MEDIUM,name-,含意图揭示命名、统一词汇、避免缩写、以重命名替代注释)。

使用方式:按需阅读各参考文件获取详细说明与代码示例;references/_sections.md 为分类定义与排序,assets/templates/_template.md 为新规则模板,metadata.json 为版本与参考信息。

限制:资料仅给出规则名称与分类,未提供每条规则的完整示例、安装命令、收费方式或适用 Ruby 版本下限,此类信息暂未提供。