用途:在编写或重构 Rails 控制器、模型、视图、API 端点、数据库迁移与后台任务时,提供按影响优先级排列的 45 条社区最佳实践规则,用于指导代码生成与自动化重构。
主要能力与分类(按优先级):数据库与 ActiveRecord(CRITICAL,db-,含预加载关联消除 N+1、加索引、只选所需列、find_each 批处理、避免循环内查询、作用域、可逆零停机迁移、exists? 代替 count);控制器与路由(CRITICAL,ctrl-,瘦控制器、强参数、RESTful 路由、before_action 限定、respond_to、rescue_from);安全(HIGH,sec-,参数化查询、白名单、先认证后授权、CSRF、按当前用户限定查询);模型与业务逻辑(HIGH,model-,模型层校验、避免回调副作用、服务对象、scope 代替类方法、枚举、concern、查询对象);缓存与性能(HIGH,cache-,片段缓存、俄罗斯套娃、Rails.cache.fetch、计数器缓存、stale? 条件 GET);视图与前端(MEDIUM-HIGH,view-,集合渲染、Turbo Frames/Streams、form_with、逻辑移出视图);API 设计(MEDIUM,api-,序列化器、分页、版本化、结构化错误、避免 Jbuilder 热点路径);后台任务与异步(LOW-MEDIUM,job-,幂等、传 ID、重试与错误处理、唯一任务)。
使用方式:编写新控制器/模型/视图、优化 ActiveRecord 查询与缓存、构建或重构 API、加 Turbo、审查 N+1 与安全、设计 Sidekiq/Active Job、编写迁移时参考。详细说明与代码示例见各参考文件(references/_sections.md、assets/templates/_template.md、metadata.json)。
限制:官方文本暂未提供;本资料未说明适用 Rails 版本、安装命令、定价与平台信息。