GraphQL
GraphQL Schema 设计、调试与加固专家
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：GraphQL。 它的用途是：GraphQL Schema 设计、调试与加固专家 完整的 Skill 内容见：https://321skill.com/skills/graphql-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我审查这个GraphQL schema，找出潜在的性能问题和安全漏洞'，它会分析schema中的查询深度、别名、复杂度、非空字段、N+1风险等，并给出优化建议。
对AI说：'我的GraphQL查询执行了500次数据库查询，如何优化？'，它会检查resolver并建议使用DataLoader批处理，同时指出哪些字段可能触发N+1。
介绍
解决GraphQL开发中常见的痛点：N+1查询、非空字段报错、订阅不触发、架构变更导致客户端崩溃、联邦子图组合问题等。它帮助设计、调试和加固schema、resolver、client，确保性能和稳定性。
使用方法：在编写或审查schema、SDL、resolver时调用；当查询缓慢或触发数百次数据库查询时；当出现“Cannot return null for non-nullable field”错误或整个分支被置空时；设计mutation、游标分页、自定义标量、联合类型、输入类型时；当Apollo/Relay/urql缓存不更新时；订阅掉线或永不触发时；添加深度、别名、复杂度、持久化查询限制、禁用内省、错误掩盖时；schema变更导致客户端异常时；组合Apollo Federation子图及实体引用时。
适合后端开发、全栈开发、GraphQL工程师，以及负责API性能优化和安全加固的团队。
使用建议：在开发初期就集成此Skill，可避免后期大规模重构；注意它不适用于消费他人已有的GraphQL API或设计REST接口。
核心特点
与其他通用代码调试工具不同，它专攻GraphQL全生命周期，覆盖N+1批处理、非空字段、成本限制、订阅、联邦等特有场景，并提供从schema设计到运行时安全加固的一站式支持。
注意事项
不适合消费他人已有的GraphQL API或设计REST端点。
常见问题
如何解决GraphQL N+1查询问题？
使用DataLoader批量加载，并检查resolver中是否缺少batching。此Skill会自动分析并建议DataLoader或类似方案。
GraphQL返回“Cannot return null for non-nullable field”怎么办？
检查对应resolver是否返回了null，确保数据库查询正确返回非空值。此Skill会定位错误字段并提供修复建议。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graphql-x-2/raw/index.md 读取 GraphQL 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graphql-x-2/raw/index.md（查看排版版本）