Skills · Claude Code · Agent Skills

智能体严格遵循、不容妥协的 Ruby 工程标准。

带着本家底线的 Ruby/Rails 后端:密钥不入 bundle、参数化的 ActiveRecord、strong params、服务端 auth、作为独立应用的 IAM,以及承载编译器给不了的安全性的测试。

维护者 Lucas Andrade

schematize-ruby · v0.1.2bash
$ schematize install ruby
GitHub →下载技能 (.zip)/ruby-help · github.com/schematizeme/schematize-cli

不可妥协的底线

绝不为“求快”而关闭。完整清单见技能。

Ruby 凭 fit + ADR

受批准清单中的语言,凭 fit + ADR 选择(原型、脚本、Rails 产品 DX)。绝不用清单外的后端,也绝不缺 fit 的 ADR。

密钥不入 bundle

绝不放进代码、Gemfile 或已服务的 asset,也不放进前端的 NEXT_PUBLIC_/VITE_。只经 Rails credentials / ENV / secret manager。

参数化的 ActiveRecord

不用插值 SQL;用 strong params 防 mass-assignment;token 用 SecureRandom;用 YAML.safe_load;不用受 input 驱动的 eval/send。

服务端 auth,IAM 独立

tenant_id/role 取自已验证的 token(完整 JWT,无 alg=none)。Auth 是 auth.<domain> 上独立的 Ruby 应用——单靠 Devise 不是本家的 IAM。

测试承载安全性

Ruby 的动态性没有编译器;RSpec/Minitest + RBS/Sorbet 捕获 NoMethodError/拼写错误。绝不为通过 CI 而让测试噤声。

精简代码 + 归档

文件 ≤750 行(有效 >300 即 flag),每文件一个类,YARD 文档,frozen_string_literal。MAP 与归档每次都生成。

命令

安装在 .claude/commands/。随时运行 /ruby-help。

/ruby-help列出所有命令。
/ruby-load强制加载全部规范并开始应用。
/ruby-claude用技能当前版本创建/更新(覆盖)根目录的 CLAUDE.md。
/ruby-ccContext compact:将 context.md + checklist.md 写入归档并运行 /compact。
/ruby-handoff生成交接文档而不压缩——会话结束或任务切换。
/ruby-qa计划优先 QA:先规划、生成 MD、请求批准,然后执行。
/ruby-review对 diff 执行 DoD 与反模式门禁:文件 >750 阻断,有效 >300 标记,方法缺 YARD,插值 SQL,token 用 rand,索引。
/ruby-iam将 IAM(ID≠email、≥2 因素、多租户 ReBAC、不可逆登出)作为 auth.<domain> 上独立的 Ruby 应用强制/审计/搭建,或迁移遗留 auth。
/ruby-index根据 YARD 文档注释(重新)生成微函数索引。
/ruby-ops审计/搭建 <项目>_ops(唯一入口):环境流程、并行安装(nproc)、独立性。

面向 AI 智能体

无需人工即可安装。元数据见 llms.txt。

  • 运行:git clone https://github.com/schematizeme/skill-ruby.git && ./skill-ruby/install.sh
  • 或下载:https://github.com/schematizeme/skill-ruby/releases/latest/download/skill-ruby.zip 并解压到 .claude/skills/
  • 将 assets/CLAUDE.md 复制到仓库根目录(常开规则)。
  • 用 /ruby-help 确认。

不想安装?

阅读完整规范并直接复制到你的项目——或安装该技能,让智能体自动执行。