Ruby 语言技能是一套面向编写、审查和调试纯 Ruby 代码的倾向性约定与惯用法集合,重点覆盖智能体默认容易忽略的模式。
用途:帮助在生成或修改 Ruby 代码时采用惯用写法与现代 Ruby 3.x+ 特性,减少非惯用、低性能或易错实现。
主要能力:
- 错误处理约定:首次抛出异常用 fail,仅在重新抛出时用 raise;按业务域组织自定义异常层级(如 MyApp::Error < StandardError 及子类),可按任意粒度 rescue;对预期失败路径使用结果对象(Result 类提供 success/failure、success?/failure?);支持调用方通过块提供回退处理。
- 现代 Ruby 3.x+:模式匹配(含哈希、区间、查找模式、pin 操作符)、无终点方法、编号块参数 _1、Data.define 不可变值对象、Hash#except、filter_map、tally 等。
- 性能要点:每个文件添加 frozen_string_literal: true;用 each_with_object 构建结果;对大或无限序列使用惰性枚举;记忆化时用 defined? 处理 nil/false 结果;字符串构建使用 << 或 join 避免 += 的 O(n²)。
- 惯用法:守卫子句、字面量数组构造(%w、%i)、Hash#fetch 处理必需键、安全导航、谓词 ? 与危险方法 ! 的命名约定,定义 bang 方法时提供非 bang 替代。
- 方法与文件布局:按阅读顺序自上而下逐级下降抽象层级(stepdown/报纸式布局),元素顺序为 extend/include/prepend、常量、attr_* 与类宏、initialize、public 方法(高层入口在前)、protected、private 辅助方法;同一块内按抽象高度广度优先排列,而非按调用者深度优先。
- 常见错误对照:新异常误用 raise、结果可能为 nil/false 时误用 @var ||=、循环中用 += 拼接字符串、rescue Exception、过深的 &. 链、缺少 frozen_string_literal、辅助方法紧贴单一调用者定义等,并给出修正。
- 参考文档:modern_ruby.md、error_handling.md、performance.md、ood-philosophy.md、method_ordering.md,分别覆盖模式匹配与 Ractor/Fiber 调度器/RBS 类型、异常层级与重试模式、YJIT/GC 调优与基准分析、OOD 原则与命名、文件布局与方法排序。
使用方式:作为技能加载后,在编写、审查或调试 Ruby 代码时参照上述约定执行;详细模式见各参考文档。
适用场景:纯 Ruby 代码的开发、代码审查、调试与重构,尤其是希望统一错误处理风格、采用 Ruby 3.x+ 新特性、优化常见性能点以及整理类与方法布局的场合。
限制:资料聚焦纯 Ruby 语言层面的约定,未提供安装命令、运行环境要求、收费或平台信息;示例中的具体业务类名与接口仅为演示,未说明与特定框架的集成方式。