用途
本技能用于构建生产级 GraphQL API，基于 graphql-js。资料说明其覆盖 schema 设计、类型系统、resolver、查询、变更、订阅、认证、授权、缓存、测试与部署策略。
适用场景包括：为 Web 或移动客户端构建需要灵活数据获取的新 API；用更高效的数据访问模式替换或增强 REST API；为具有复杂嵌套数据关系的应用开发 API；创建服务多种客户端类型（Web、移动、桌面）且数据需求不同的 API；构建需要订阅和实时更新的实时应用；设计客户端需要精确指定所需数据的 API；使用 Node.js 和 Express 开发 GraphQL 服务器；实现具有强 schema 校验的类型安全 API；创建带内置 introspection 的自文档化 API；构建需要组合为统一 API 的微服务。
资料也列出应继续使用 REST 的情况：简单 CRUD 操作与标准资源；文件上传/下载（GraphQL 需要 multipart 处理）；HTTP 缓存至关重要（GraphQL 通常使用 POST）；团队不熟悉 GraphQL（存在学习曲线）；现有 REST 基础设施运行良好。
主要能力
类型系统与 Schema 设计
GraphQL 类型系统是基础。每个 GraphQL API 定义：标量类型（String、Int、Float、Boolean、ID）、对象类型、Query 类型（读操作入口）、Mutation 类型（写操作入口）、Subscription 类型（实时更新入口）、输入类型、枚举、接口、联合、非空类型、列表类型。
Schema 定义有两种方式：Schema Definition Language（SDL，声明式、可读）和编程式 API（类型安全、程序化）。资料给出 SDL 示例，定义 User、Post、Query 类型；也给出 GraphQLObjectType 编程式示例。
Resolver
Resolver 是为 schema 字段返回数据的函数，每个字段都可以有 resolver。Resolver 函数签名包含：parent（父 resolver 的结果）、args（传给字段的参数）、context（共享上下文，如数据库、认证）、info（字段特定元数据）。
查询、变更与订阅
查询用于获取数据，变更用于修改数据，订阅用于实时更新。资料分别给出 query GetUser、mutation CreatePost、subscription OnPostCreated 示例。
Schema 设计模式
资料列出多种模式：为变更使用输入类型（便于扩展、组织更好、可复用）；使用接口共享字段；使用联合实现多态返回；分页模式（基于 offset 和基于 cursor 的 Relay 风格）；错误处理（字段级错误、基于联合的错误处理）；使用指令进行版本管理（用 @deprecated 弃用字段而非版本化）。
查询优化与性能
N+1 问题：获取嵌套数据会导致多次数据库查询。DataLoader 解决方案：批处理和缓存请求，资料给出创建 DataLoader、在 resolver 中使用、加入 context 的示例。查询复杂度分析：使用 graphql-query-complexity 限制昂贵查询。深度限制：使用 graphql-depth-limit 防止深层嵌套查询。
变更与输入校验
资料给出变更设计模式（CreatePostInput、CreatePostPayload、UserError、Mutation）以及输入校验示例，在 resolver 中校验 title 和 content 长度，返回 errors、success、post。
订阅与实时更新
使用 graphql-subscriptions 的 PubSub 设置订阅，定义 postCreated、messageReceived 字段；在变更中发布事件；使用 ws、graphql-ws、express 设置 WebSocket 服务器。
认证与授权
基于上下文的认证：使用 jwt 中间件提取用户，加入 GraphQL context。Resolver 级授权：在 resolver 中检查 context.user 和角色。字段级授权：在字段 resolver 中检查作者身份。基于指令的授权：定义 @auth 指令和 Role 枚举，使用 @graphql-tools/utils 的 mapSchema 实现。
缓存策略
内存缓存：使用 lru-cache。Redis 缓存：使用 ioredis，设置缓存键、检查缓存、回源数据库、setex 缓存。缓存失效：在变更中处理。
使用方式
资料未提供安装命令或具体运行步骤，仅提供代码示例与设计模式。使用方式需结合 graphql-js、Node.js、Express 及相关库（DataLoader、graphql-subscriptions、ws、graphql-ws、jsonwebtoken、lru-cache、ioredis、graphql-query-complexity、graphql-depth-limit、@graphql-tools/utils）进行实现。
适用场景
需要灵活数据获取的 Web 或移动客户端；替换或增强 REST API；复杂嵌套数据关系；多客户端类型；实时应用与订阅；客户端精确指定数据；Node.js 与 Express 的 GraphQL 服务器；类型安全 API；自文档化 API；微服务统一 API。
限制
资料明确列出不适合使用 GraphQL 的情况：简单 CRUD 操作与标准资源；文件上传/下载；HTTP 缓存至关重要；团队不熟悉 GraphQL；现有 REST 基础设施运行良好。此外，资料未提供收费、价格、平台或具体部署步骤等信息。