用途:在编写、审查或调试纯 Ruby 代码时提供有主见的 Ruby 3.x+ 惯用约定,重点覆盖智能体默认容易忽略的模式。
主要能力:错误处理方面,遵循 Weirich 的 raise/fail 约定(首次抛异常用 fail,重新抛出用 raise),支持自定义异常层级与结果对象(Result)处理预期失败,以及调用方通过块提供回退逻辑。现代 Ruby 特性方面,涵盖模式匹配(含 find 模式与 pin 操作符)、无尾方法(endless methods)、编号块参数、Data.define 不可变值对象、Hash#except、filter_map、tally 等。性能方面,建议使用 frozen_string_literal、each_with_object、惰性枚举、注意 nil/false 记忆化陷阱、用 << 或 join 替代 += 拼接字符串。惯用写法方面,推荐守卫子句、字面量数组构造、Hash#fetch、安全导航、谓词与感叹号命名约定。文件布局方面,采用 stepdown/报纸式排列,按抽象层级广度优先组织方法。
使用方式:作为技能加载后,在涉及 Ruby 代码的任务中参考其约定与模式;具体命令与安装方式暂未提供。
适用场景:纯 Ruby 代码的编写、审查、调试与重构。
限制:仅针对纯 Ruby,不涉及 Rails 等框架特定内容;部分高级主题(ractor、fiber scheduler、RBS 类型、YJIT、GC 调优等)在引用文档中展开,本资料未提供完整细节。