GraphQL
GraphQL全栈开发与调试专家，专注于模式设计、性能优化与问题排查。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：GraphQL。 它的用途是：GraphQL全栈开发与调试专家，专注于模式设计、性能优化与问题排查。 完整的 Skill 内容见：https://321skill.com/skills/graphql-x-9/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的GraphQL查询突然变慢，怀疑是N+1问题，这是我的schema和查询示例……’，它会分析你的查询模式，识别出潜在的N+1查询点，并建议使用DataLoader进行批处理或调整解析器逻辑。或者，当你遇到‘Apollo客户端在mutation后缓存不更新’时，可以描述你的变更和查询结构，它会指导你检查缓存策略、写入策略或使用refetchQueries。
介绍
本Skill是GraphQL开发的瑞士军刀，专门解决GraphQL服务端与客户端开发中的各类棘手问题。它覆盖了从模式设计、解析器编写、性能调优到客户端缓存、错误处理和安全加固的全流程。
当你遇到N+1查询问题导致性能瓶颈，或收到“Cannot return null for non-nullable field”这类错误时，可以召唤它来诊断和修复。它也能帮你设计复杂的变更、分页、联合类型和自定义标量，并处理Apollo、Relay等客户端缓存更新失败或订阅连接中断等问题。
它非常适合后端、全栈及智能体开发者，尤其是那些正在构建、维护或重构GraphQL API的工程师。无论是编写新代码还是审查现有实现，它都能提供专业指导。
建议在遇到具体GraphQL开发问题时，提供详细的错误信息、模式定义或查询示例，以便获得更精准的解决方案。注意，它不适用于单纯消费他人GraphQL API或设计REST端点。
核心特点
与通用API开发技能不同，它深度聚焦于GraphQL特有的问题域，如N+1查询优化、联合类型/接口设计、客户端缓存一致性、订阅机制调试以及Apollo Federation子图编排，提供了从模式设计到生产问题排查的端到端支持。
注意事项
不适用于消费第三方GraphQL API（应使用api技能）或设计RESTful API端点（应使用rest-api技能）。
常见问题
如何解决GraphQL查询返回大量null或错误数组的问题？
可帮你检查模式中字段的空值性定义、解析器错误处理逻辑，并定位导致整个分支为null的根因。
如何优化GraphQL查询性能，避免N+1问题？
可指导你使用DataLoader进行批处理，或分析查询复杂度，实施深度、别名和成本限制。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graphql-x-9/raw/index.md 读取 GraphQL 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graphql-x-9/raw/index.md（查看排版版本）