GraphQL 操作设计

原名：graphql-operations

编写清楚、可复用且便于缓存的查询、变更和片段。

中文 Skills 技能说明

适合客户端和服务端共同整理 GraphQL 操作；先读取真实 schema，限制字段和变量范围，处理分页与错误，不请求无关敏感字段。技能以本地 GraphQL 代码和配置为主；Apollo GraphOS、Studio 或其他托管服务需使用用户自己的账户，网络、区域、费用和数据位置由用户确认。执行前读取真实项目、当前版本和官方资料，输出目标、依据、影响、验证结果与回退方式；没有证据时明确说明未知，不编造数据、配置或成功状态。创建、修改、部署、发布、提交审核、迁移、删除、发送或产生费用的操作，必须先展示目标和差异并获得有权限人员确认。代码、schema、日志、令牌、客户、订单、支付、音视频和企业资料按敏感内容处理，只读取任务所需范围，上传或外发前完成授权、脱敏和最小化。

上游能力依据

上游原始适用说明：Guide for writing GraphQL operations (queries, mutations, fragments) following best practices. Use this skill when: (1) writing GraphQL queries or mutations, (2) organizing operations with fragments, (3) optimizing data fetching patterns, (4) setting up type generation or linting, (5) reviewing operations for efficiency.

上游 SKILL.md 主要章节（保留原文标题）：

Operation Basics
Query Structure
Mutation Structure
Subscription Structure
Quick Reference
Operation Naming
Variable Syntax
Fragment Syntax
Directives
Key Principles

使用边界

先读取项目约定、依赖版本和现有测试，再提出最小改动。写文件、运行脚本、提交代码或发布前应检查差异并保留回退路径。

作者、翻译与许可证

原作者: Apollo GraphQL, Inc. 与 apollographql/skills contributors
中文翻译: CEOFans翻译
许可证: MIT
上游来源: https://github.com/apollographql/skills/tree/c288eb80629dd2309eed81f23d693f66a452d043/skills/graphql-operations

适用范围

平台：linux、macos、windows；标签：软件开发、GraphQL 操作设计

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。