技能说明
适合 Apollo Client、urql、Relay 等 GraphQL 客户端，覆盖操作命名、变量、片段、字段选择、缓存友好和类型生成等实践。技能强调只请求需要的字段，避免匿名操作与硬编码值；它不替代服务端 schema 设计或认证配置。
关于此技能
帮助 Agent 编写高效、类型安全且易维护的 GraphQL 查询、变更、订阅和片段。
核心能力
操作结构规范
覆盖查询、变更、订阅、命名、变量与指令，减少匿名操作和硬编码参数。
片段与缓存友好
引导按组件组织可复用片段，并为可缓存类型优先请求稳定的 id 字段。
工具链衔接
适用于 Apollo Client、urql、Relay 等客户端，并覆盖类型生成与 lint 的基础做法。
适用场景
编写客户端查询
为页面或组件设计只请求所需字段的 GraphQL 查询，避免过度获取。
整理共享片段
把重复字段选择提炼为片段，并按组件就近维护，降低接口演进成本。
审查接口调用
检查操作命名、变量使用、缓存字段和数据获取效率，适合代码评审。
使用步骤
- 01
第一步：确认客户端与模式
先确认 GraphQL schema、客户端和生成工具，再确定操作文件与片段组织方式。
- 02
第二步：设计操作
为每个查询或变更命名，使用变量传参，只选择当前界面真正需要的字段。
- 03
第三步：检查与生成
复用片段、保留必要的 id，并运行项目已有的类型生成或 lint 检查。
常见问题
只支持 Apollo Client 吗？+
不是。SKILL.md 标注兼容任意 GraphQL 客户端，README 也列出 Apollo Client、urql 和 Relay 等场景。
它能替我修改服务端 schema 吗？+
不能。这个技能专注于客户端 GraphQL operations；服务端 schema 设计和 Apollo Federation 应单独评估。
使用时需要 API 密钥吗？+
技能本身主要提供编写和审查规则，不要求额外 API 密钥；项目的 GraphQL 服务认证仍按现有环境配置。
安装前检查
把兼容性、来源和安装入口先看清楚，再放进自己的工作流。
Claude Code · Codex · Cursor
已提供来源链接
命令可直接复制
2026/09/02
安装提醒：即使有清晰的来源和安装方式，也建议先阅读 SKILL.md，确认它会访问哪些文件和服务。
npx skills add apollographql/skills --skill graphql-operations -a claude-code -g