GraphQL
GraphQL 全链路开发与调试专家，从设计到排障一手包办。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：GraphQL。 它的用途是：GraphQL 全链路开发与调试专家，从设计到排障一手包办。 完整的 Skill 内容见：https://321skill.com/skills/graphql-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在设计一个用户和文章的 GraphQL Schema，需要支持游标分页和嵌套查询，但担心 N+1 问题，请帮我规划一下。” 它会提供包含分页参数和 DataLoader 使用建议的 Schema 设计草案。或者，当查询返回“Cannot return null for non-nullable field”错误时，你可以描述查询和 Resolver 逻辑，它会帮你定位是哪个字段可能返回了空值，并给出修复建议。
介绍
这是一个专注于 GraphQL 全链路开发与调试的 AI Agent Skill。它旨在解决开发者在设计、实现、优化和排查 GraphQL 服务时遇到的各种复杂问题。无论是 Schema 设计、Resolver 性能优化（如 N+1 问题）、客户端缓存更新，还是生产环境的安全加固与错误处理，该 Skill 都能提供专业指导。
使用时，你可以向它描述你遇到的 GraphQL 相关问题或你想要实现的功能，例如“如何设计一个支持分页的查询接口？”或“我的 mutation 执行后，Apollo 客户端缓存没有更新，怎么办？”。它会基于 GraphQL 最佳实践和社区经验，提供具体的解决方案、代码示例或排查步骤。
该 Skill 非常适合正在构建或维护 GraphQL API 的开发者，尤其是那些需要处理复杂数据图、关注性能与安全，或在使用 Apollo Federation 等高级功能的团队。它能帮助开发者避免常见陷阱，提升 API 的健壮性和开发效率。
建议在 Schema 设计评审、性能问题排查、生产事故响应等关键节点使用。请注意，它专注于 GraphQL 服务端和客户端开发，而非消费第三方 GraphQL API 或设计 RESTful 接口。对于后者，应使用其他专门的 Skill。
核心特点
与通用 API 开发 Skill 不同，它深度聚焦于 GraphQL 生态特有的问题，如 N+1 查询批处理、非空字段空值错误、订阅连接管理、联邦子图组合等，提供领域专家级的解决方案。
注意事项
不适用于消费他人提供的 GraphQL API（应使用通用 api skill）或设计 RESTful 端点（应使用 rest-api skill）。
常见问题
如何解决 GraphQL 查询中的 N+1 性能问题？
可以使用 DataLoader 对数据库查询进行批处理与缓存，该 Skill 能提供具体实现示例和优化建议。
Mutation 执行后，Apollo Client 缓存为什么不更新？
通常需要正确更新缓存或使用 refetchQueries，该 Skill 可以指导你检查 mutation 返回的数据结构并配置正确的缓存更新策略。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graphql-x/raw/index.md 读取 GraphQL 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graphql-x/raw/index.md（查看排版版本）