用途:在编写 Ruby 与 Rails 代码时,按 DHH 与 37signals 的鲜明风格应用约定与模式。核心哲学是“最好的代码是不写的代码”,主张原生 Rails 足够用:富领域模型优先于服务对象,CRUD 控制器优先于自定义动作,用 concerns 做横向共享,用记录而非布尔列表示状态,尽量数据库化(不用 Redis),先自建方案再引入 gem。
主要能力:覆盖控制器(REST 映射、concerns、Turbo 响应、API 模式)、模型(concerns、状态记录、回调、scope、PORO、授权、广播)、视图与前端(Turbo、Stimulus、CSS、partials)、架构(路由、多租户、认证、任务、缓存)、测试(Minitest、fixtures、集成测试)、gem 与依赖取舍、代码审查与通用约定。
使用方式:按任务类型读取对应参考文件,如控制器读 controllers.md,模型读 models.md,前端读 frontend.md,架构读 architecture.md,测试读 testing.md,依赖读 gems.md;代码审查则读取全部参考后再审查。随后把模式应用到用户代码。
命名与模式要点:动词用 card.close、board.publish;谓词用 card.closed?;concerns 用能力形容词(Closeable、Publishable);控制器用资源名词(Cards::ClosuresController);scope 用 chronologically、preloaded、active 等业务词。REST 映射上,用新资源替代自定义动作,如 POST /cards/:id/close 改为 POST /cards/:id/closure。状态用记录表示:Card.joins(:closure) 为已关闭,Card.where.missing(:closure) 为未关闭。授权逻辑放在 User 模型,如 can_administer?。
限制:资料明确说明这是 LLM 生成的指南,可能包含不准确之处;示例代码来自 Fizzy,采用 O'Saasy License;与 37signals 无关联,也未获其背书。其他具体安装或运行方式暂未提供。