GraphQL
GraphQL全栈开发与调试专家，专注模式设计、性能优化与问题排查。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：GraphQL。 它的用途是：GraphQL全栈开发与调试专家，专注模式设计、性能优化与问题排查。 完整的 Skill 内容见：https://321skill.com/skills/graphql-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的GraphQL查询返回了“Cannot return null for non-nullable field”错误，但数据库里明明有数据，帮我分析一下可能的原因。’ 它会引导你检查解析器的返回逻辑、数据加载顺序以及模式中字段的空值约束，定位是数据未正确获取还是解析器返回了未处理的null。 或者
对AI说：‘我想为我的产品列表实现游标分页，应该如何在GraphQL模式中定义？’ 它会提供包含edges、node、pageInfo等标准字段的类型定义示例，并解释连接模式的最佳实践。
介绍
本Skill是GraphQL全栈开发的得力助手，专注于解决GraphQL服务端与客户端开发中的各类核心问题。它能帮助你设计、调试和加固GraphQL模式、解析器和客户端，处理从N+1查询批处理、空值处理、成本限制到订阅、联邦架构等一系列复杂场景。
当你编写或评审GraphQL模式定义语言（SDL）、设计变更、游标分页、自定义标量、联合类型或输入类型时，它可以提供专业指导。当查询缓慢或触发数百次数据库查询、响应中出现“Cannot return null for non-nullable field”错误、返回错误数组或整个分支被置空时，它能帮你快速定位根因。
本Skill非常适合后端开发、全栈开发以及负责API设计与维护的工程师。无论是处理Apollo、Relay或urql客户端缓存更新失败、订阅连接断开，还是需要添加深度、别名、复杂度限制，或是在组合Apollo Federation子图和实体引用时遇到困难，它都能提供针对性建议。
使用建议：在遇到具体的GraphQL开发或线上问题时，直接描述你的场景、错误信息或设计目标，以获得最精准的解决方案。请注意，它专注于GraphQL服务的构建与维护，而非消费第三方GraphQL API，也不用于设计REST端点。
核心特点
与通用API开发技能不同，它深度聚焦于GraphQL特有的全链路问题，如N+1查询优化、联邦架构组合、订阅稳定性以及客户端缓存一致性等，提供了从模式设计到生产问题排查的垂直解决方案。
注意事项
不适合用于消费他人提供的GraphQL API，也不适用于设计RESTful API端点。
常见问题
如何解决GraphQL查询中的N+1问题？
可以使用DataLoader进行批处理和缓存，或调整解析器逻辑，本Skill能提供具体实现方案。
Apollo客户端缓存如何手动更新？
可通过更新缓存、使用refetchQueries或writeQuery/writeFragment等方法，本Skill会根据你的变更操作给出具体代码示例。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graphql-x-7/raw/index.md 读取 GraphQL 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graphql-x-7/raw/index.md（查看排版版本）