用途：指导在项目中创建与维护 GraphQL 操作，涵盖类型安全、文件组织、错误处理与测试，技术栈为 gql.tada 与 urql，配合 Saleor API 使用。
主要能力：用 gql.tada 编写查询与变更，类型由 schema 自动推断；用 urql 客户端与缓存；支持认证（Bearer token）与限流重试（429，最多 5 次）；使用 MSW 模拟 GraphQL 做测试。
使用方式：操作文件位于 src/lib/graphql/operations 与 fragments，客户端配置在 src/lib/graphql/client.ts，schema 生成到 schema.graphql。每个实体用 repository 类封装操作并把响应映射为领域模型，不向服务层暴露 GraphQL 类型。错误分两类检查：网络/GraphQL 错误用 GraphQLError.fromCombinedError 包装并带上操作名；变更校验错误检查 result.data?.mutation?.errors 数组。更新 schema 用：pnpm fetch-schema。测试用 MSW 的 graphql.query() 与 graphql.mutation()。
适用场景：新增查询或变更、接入 Saleor 端点、Saleor 变更后更新 schema、配置 urql 客户端、编写测试 mock。
限制：资料未提供具体版本要求、完整错误处理与片段模式的细节（仅在引用文件中提及）；外部库文档需自行查阅。不要使用原始字符串查询，避免硬编码分页上限，不要跳过任何操作的错误处理。