用途:用于在实现 GraphQL 功能时提供开发规范与实现指导,涵盖类型安全 API 开发、schema 设计、resolver 优化和 federation 架构。核心要求是先核验再实现:需对照 Apollo Server 4+ 官方文档、GraphQL 规范、DataLoader 用法与联邦指令,禁止猜测配置选项、臆造指令或假设 resolver 签名;不确定度超过阈值时应先查证并说明来源。
主要能力与原则:TDD 优先,先写失败测试再实现 resolver、schema 类型与集成;Schema-First 设计,先用 SDL 定义类型;默认安全,包括查询深度与复杂度限制、字段授权、输入校验;端到端类型安全,借助 GraphQL Code Generator;启动时校验 schema,错误信息清晰。
使用方式示例:测试可用 pytest 的图式测试;实现可用 Ariadne 的 QueryType、MutationType、ObjectType 与 @query.field、@mutation.field、@post_type.field 装饰器;性能上使用 DataLoader 批处理、cost_validator 限制查询代价、NoSchemaIntrospectionCustomRule 关闭生产环境内省、异步客户端 httpx 避免阻塞、游标分页替代 offset 分页。
适用场景:GraphQL 服务端开发、resolver 与性能优化、查询安全防护、schema 与联邦设计。
限制:资料未提供具体版本兼容矩阵、安装命令、定价与部署细节;具体实现须以官方文档为准。