GraphQL
GraphQL schema 设计、调试与加固
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：GraphQL。 它的用途是：GraphQL schema 设计、调试与加固 完整的 Skill 内容见：https://321skill.com/skills/graphql-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我审查这个 GraphQL schema，找出可能导致 N+1 查询的地方，并给出优化建议，同时检查非空字段的 nullability 风险。' 它会分析每个 resolver 的查询模式，标注出可能批量加载的字段，并建议使用 DataLoader 或调整查询结构。同时检查非空字段在数据源返回 null 时是否会导致整条数据分支断裂，并给出修复方案。
介绍
GraphQL 开发中常遇到 N+1 查询、非空字段报错、订阅断连、联邦组合失败等问题。本 Skill 专门用于设计、调试和加固 GraphQL 的 schema、resolver 和客户端：从 N+1 批处理、可空性分析、成本限制，到订阅与 Apollo Federation 组合，覆盖开发全链路。
使用时直接描述你的场景：写 schema 或 SDL 时让它审查结构；慢查询或大量数据库请求时让它分析 N+1 并优化；收到“Cannot return null for non-nullable field”或 errors 数组时让它定位根因；设计 mutation、游标分页、自定义标量、联合类型或输入类型时让它提供最佳实践；Apollo/Relay/urql 缓存不更新时让它诊断订阅或缓存配置；订阅丢失或从未触发时让它检查订阅逻辑与传输层；需要添加深度、别名、复杂度或持久化查询限制时让它生成配置；关闭 introspection 或错误掩码时让它验证安全；schema 变更导致客户端崩溃时让它做兼容性分析；组合 Apollo Federation 子图时让它处理实体引用。
适合后端开发者、全栈开发者、智能体开发者，以及任何需要深度使用 GraphQL 的团队。也适合在代码审查、性能优化、安全加固场景中使用。
注意：本 Skill 不适用于消费他人 GraphQL API（请使用通用 API 工具），也不适用于设计 REST 接口。建议在开发或重构 GraphQL 服务时直接调用，配合实际的 schema 文件或查询日志效果更佳。
核心特点
与通用 GraphQL 工具不同，本 Skill 不仅提供语法校验，还能主动分析 N+1 查询、非空字段连锁失败、订阅可靠性等运行时问题，并集成 Apollo Federation 实体引用组合能力，覆盖从设计到生产的全场景。
注意事项
不适合用于消费他人 GraphQL API 或设计 REST 接口。
常见问题
GraphQL 出现 'Cannot return null for non-nullable field' 怎么办？
本 Skill 可以分析 resolver 返回路径，定位哪个字段导致了非空断裂，并给出修复建议，比如检查数据源是否为空或添加默认值。
如何优化 GraphQL 的 N+1 查询问题？
使用本 Skill 可以自动识别查询中的 N+1 模式，并建议使用 DataLoader 或批处理 resolver 来合并数据库请求。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/graphql-x-4/raw/index.md 读取 GraphQL 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/graphql-x-4/raw/index.md（查看排版版本）