用途：用于设计和实现 GraphQL API，覆盖 Schema 设计、解析器（resolver）模式、错误处理、查询、变更、订阅与性能优化，面向灵活的客户端-服务端通信。
适用时机：设计新的 GraphQL API；创建 Schema 与类型；实现解析器与变更；添加订阅以支持实时数据；从 REST 迁移到 GraphQL；优化 GraphQL 性能。
快速开始：资料给出一个最小 Schema 示例，定义了 User、Post、Comment 等类型与 UserRole 枚举，并提示完整实现见参考指南。必要代码保持原样：
type User { id: ID! email: String! firstName: String! lastName: String! role: UserRole! posts: [Post!]! createdAt: DateTime! updatedAt: DateTime! }
enum UserRole { ADMIN USER MODERATOR }
type Post { id: ID! title: String! content: String! author: User! comments: [Comment!]! publishedAt: DateTime createdAt: DateTime! // ... (see reference guides for full implementation)
参考指南：资料列出 references/ 目录下的详细实现，包括 GraphQL Schema 设计、Node.js Apollo Server 实现、Python GraphQL 实现（Graphene）、查询示例与错误处理。
最佳实践：建议使用清晰描述性的字段名；围绕客户端需求设计 Schema；实现正确错误处理；变更使用输入类型；为实时数据添加订阅；高效缓存解析器；校验输入数据；使用 federation 提升可扩展性。不建议过度深层嵌套查询；暴露内部数据库 ID；未授权返回敏感数据；创建过于复杂的 Schema；忘记处理空值；忽略 N+1 查询问题；跳过错误信息。