用途：把 Shopify 已验证的 Storefront 或 Customer Account GraphQL 操作接入 Vercel Shop。编辑前先阅读 references/REFERENCE.md。
主要能力与约定：Shopify 文档、schema、字段、参数、枚举、API 版本、操作设计与验证均交由 Shopify AI Toolkit 决定：目录、搜索、菜单、购物车等公开读取用 Storefront GraphQL 技能，客户资料与订单等认证数据用 Customer 技能，metafields/metaobjects 先用 custom-data 技能。
集成做法：先查看调用路由以判定缓存行为，将读取分类为静态外壳、请求时共享或私有数据。把操作加入 lib/shopify/operations/<resource>/server.ts，写成不带 next/cache 导入的无缓存 fetch* 函数；缓存指令、cacheLife、cacheTag 放在消费域的 lib/<domain>/server.ts 的 get* 包装中。纯转换放 lib/shopify/transforms/<resource>/index.ts。文档用 Hydrogen gql() 包裹并带 #graphql 注释，保持静态，动态值用变量。
限制与验证：不缓存 mutation；购物车不放 Next.js 数据缓存，每次请求用 getCart 记忆化。改动片段或变量后需再次用 Shopify AI Toolkit 验证最终文档，并运行 lint、类型检查、相关测试，必要时构建。若 Shopify AI Toolkit 不可用，使用官方文档与验证工具，不要猜测。