用途
GraphQL 技能用于指导 GraphQL API 的设计、实现与集成。其定位是：GraphQL 让客户端恰好获取所需数据——不多也不少，通过单一端点、类型化 schema 和内省机制实现。但资料同时强调，正是这种灵活性使其具有危险性：如果没有适当的控制，客户端可以构造出拖垮服务器的查询。
主要能力
根据资料，该技能覆盖以下方面：
- schema 设计
- resolver
- 使用 DataLoader 防止 N+1 查询
- 面向微服务的 federation
- 与 Apollo/urql 的客户端集成
资料给出的关键洞见是：GraphQL 是一份契约，schema 就是 API 文档，应当谨慎设计。
使用方式
资料说明，在执行该技能前应先阅读详细指南（Detailed Guide），其中保留了完整流程与参考资料；其安全性、前置条件和验证要求应被视为强制性的。对于聚焦型工作，可加载相关章节；对于端到端工作，应完整阅读指南。
该技能在用户提及或暗示以下内容时使用：graphql、graphql schema、graphql resolver、apollo server、apollo client、graphql federation、dataloader、graphql codegen、graphql query、graphql mutation。
示例用户请求为：使用 @graphql 处理该任务。
适用场景
资料给出的 2025 年经验判断是：GraphQL 并非总是答案。对于简单 CRUD，REST 更简单；对于高性能公共 API，带缓存的 REST 更胜一筹。当存在复杂的数据关系和多样的客户端需求时，才使用 GraphQL。
限制
资料明确列出以下限制：
- 仅当任务与上述范围明确匹配时才使用该技能。
- 不得将输出视为环境特定验证、测试或专家评审的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，应停止并请求澄清。
关于该技能的具体安装命令、收费方式、支持平台或实际效果，资料中暂未提供。