用途：在 Rails 项目中端到端构建 GraphQL 功能，从领域建模到 Schema、测试驱动开发与安全审查。触发词包括 GraphQL API、GraphQL schema、mutation、query、graphql-ruby。
主要能力与流程：
- 领域建模：把每个领域实体与动作映射为 GraphQL 类型或 mutation，并归属到单一限界上下文；实体关系映射为 connection 或嵌套类型，并明确归属。
- Schema 设计：列表字段使用游标或偏移分页，不返回无界数组；敏感类型与字段通过 authorized? 做字段级授权；mutation 响应包装为带结构化 errors 字段的结果对象。可用 graphql-ruby 内置工具校验 Schema，例如定义 rake 任务后执行 bundle exec rake graphql:validate，检查无循环类型引用、类型字段与参数完整、敏感字段授权规则已定义。
- TDD 实现：为每个 resolver 或 mutation 先写失败的 spec，再实现代码，最后跑全量测试确认无回归。
- 安全审查：逐字段审计授权；在 Schema 类配置查询深度与复杂度限制（资料建议深度 ≤ 10）；在应用层实现限流；用 GraphQL::Batch 或 dataloader 消除 N+1；用 rescue_from 捕获 StandardError 并返回通用错误信息。
适用场景：Rails 应用中使用 graphql-ruby 构建 GraphQL API、Schema、查询与变更，并需要授权、限流与性能控制的团队。
限制与注意：资料未提供具体安装命令、版本要求、收费信息或平台支持范围。反模式包括单一文件的神级 Schema（应拆分到 app/graphql/types、mutations、resolvers 目录）、直接暴露 ActiveRecord 列名、以及把业务逻辑塞进 resolver（应抽取到 service object）。