GraphQL
GraphQL全栈开发与调试专家，专注于模式设计、性能优化与问题排查。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：GraphQL。 它的用途是：GraphQL全栈开发与调试专家，专注于模式设计、性能优化与问题排查。 完整的 Skill 内容见：https://321skill.com/skills/graphql-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的GraphQL查询突然变慢，返回了大量嵌套数据，怀疑是N+1问题，Schema是这样的……’，它会分析你的Schema和查询结构，指出可能导致N+1问题的Resolver，并建议使用DataLoader进行批处理的实现方案。或者，当你说‘客户端缓存在我执行Mutation后没有更新’，它会帮你检查Mutation的返回值是否符合客户端缓存更新策略，并提供修改建议。
介绍
这是一个专为GraphQL全栈开发设计的AI技能，旨在解决从模式设计到生产部署中遇到的各种复杂问题。它能够帮助开发者设计健壮的Schema、编写高效的Resolver，并诊断和修复常见的GraphQL性能与错误问题。
当你需要编写或审查GraphQL Schema、SDL或Resolver时，或者当查询缓慢、触发N+1问题、返回非空字段为null的错误时，都可以使用它。它还能协助设计变更、分页、自定义标量等高级功能，并解决Apollo、Relay等客户端缓存更新失败、订阅断开等疑难杂症。
该技能非常适合负责GraphQL服务端和客户端开发的全栈工程师、后端工程师，以及需要确保API稳定性和性能的运维开发人员。对于正在构建或维护中大型GraphQL API的团队来说，它是一个强大的辅助工具。
使用建议：在遇到具体的GraphQL错误信息或性能瓶颈时，提供详细的上下文（如错误日志、Schema片段、查询示例）能获得更精准的解决方案。注意，它不适用于单纯消费第三方GraphQL API或设计RESTful端点。
核心特点
与通用API设计技能不同，它深度聚焦于GraphQL特有的痛点，如N+1查询批处理、联合类型设计、订阅机制调试以及Apollo Federation子图组合，提供从Schema设计到客户端缓存更新的端到端解决方案。
注意事项
不适用于消费第三方GraphQL API或设计RESTful API端点。
常见问题
如何解决GraphQL查询返回‘Cannot return null for non-nullable field’错误？
可以帮你分析Resolver逻辑、数据源返回值和Schema定义，定位空值来源并提供修复方案。
如何优化GraphQL查询性能，避免N+1问题？
可以指导你使用DataLoader进行批处理，或调整Resolver和数据获取逻辑来减少数据库查询次数。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graphql-x-5/raw/index.md 读取 GraphQL 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graphql-x-5/raw/index.md（查看排版版本）