SuperAPI AI 工具集

ruby-coder

写作与研究

查看项目

更新于 10-16 00:03

技能介绍

用途:该技能用于指导编写新的 Ruby 代码,强调 Ruby 3.x 现代语法、Sandi Metz 的开发者四规则以及惯用 Ruby 最佳实践。

主要能力:

  1. Ruby 3.x 现代语法,例如键与变量名一致时使用哈希简写:age = 49; name = "David"; user = { name:, age: }。
  2. Sandi Metz 四规则:类不超过 100 行;方法不超过 5 行(每个 if/else 分支计行);方法参数不超过 4 个;控制器只实例化一个对象,其余通过 facade 模式获取。
  3. 代码质量标准:使用 Mutex 处理共享可变状态;设计幂等操作,如 activate_user 中先判断 user.active? 再更新并发送邮件。
  4. 重构触发条件:类超 100 行、职责过多、类名含 And/Or 时提取类;方法超 5 行、条件复杂、嵌套循环或条件、注释解释代码做什么时提取方法;参数超 4 个或相关参数总一起传递时使用参数对象;控制器需要多个对象、视图访问嵌套协作者、需要复杂数据聚合时创建 facade。
  5. 规则例外:Sandi Metz 的 Rule 0 指出,只有经结对批准或有明确理由时才可打破四规则;例外需在代码注释中说明理由。

使用方式:作为编写 Ruby 代码时的参考指南,按上述规则组织类、方法、参数与控制器结构;未提供安装命令或调用方式。

适用场景:新建 Ruby 代码、重构 Ruby 代码、审查代码质量时参考。

限制:资料未提供具体安装、运行、平台或收费信息;规则例外需明确理由,Rails 视图辅助方法如 link_to、form_for 在参数数量上豁免。