用途：为 Shopify 生态开发提供方向性知识与注意事项，覆盖 Liquid 主题、Hydrogen 无头店面与 Shopify 应用开发。因 API 模式每季度变化，该技能只承载思路与坑位，实时 schema 由 Shopify 官方工具提供。
工作流程：先按任务从分支表选取并只读对应参考文件，读全该分支列出的文件即完成。写任何版本号前，从 https://shopify.dev/docs/api/usage/versioning 读取最新稳定版本，或沿用项目已固定的版本，不得凭记忆填写。改动涉及 GraphQL（Admin、Storefront、Customer Account、Function 输入查询）或不确定的 Liquid 时，用官方工具校验；未安装则告知用户并给出安装命令，同时将相关 GraphQL 标记为未校验。最后运行项目自带检查，如 shopify theme check、shopify app build 或项目 typecheck。
分支对应参考文件：编写/修复 .liquid 读 liquid-syntax.md，并按需读 liquid-filters.md 或 liquid-objects.md；sections、blocks、JSON 模板、settings schema、主题结构读 theme-development.md；购物车 /cart/*.js、调用 Shopify API、速率限制、webhooks 读 api.md；店面性能与 Core Web Vitals、图片尺寸读 performance.md；排错读 debugging.md；无头店面、Hydrogen 升级、Oxygen 读 hydrogen.md；应用、扩展与管理界面读 app-development.md；折扣、配送/支付定制、购物车校验等原 Script 场景读 functions.md。
官方工具安装命令：claude plugin install shopify-ai-toolkit@claude-plugins-official；claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest。两者均可校验 GraphQL 与 Liquid。命令失败时查阅 https://shopify.dev/docs/apps/build/devmcp。
API 版本规则：Shopify 每季度发布一个版本（YYYY-01、04、07、10），每个至少支持 12 个月；请求不受支持版本时会由最旧的受支持版本响应，导致行为静默变化，没有永久“当前”版本。
已弃用/移除项及替代：Shopify Scripts（2026 年 6 月 30 日起停止执行）改用 Shopify Functions；checkout.liquid 改用 Checkout UI 扩展与 Functions；新工作不再使用 REST Admin API，改用 GraphQL Admin API；Polaris React（@shopify/polaris，npm 已弃用）改用 Polaris web components（<s-page>、<s-button>）；Shopify Remix 应用模板改用 React Router 应用模板（@shopify/shopify-app-react-router）；img_url 过滤器改用 image_url 加 image_tag；{% include %} 改用 {% render %}。Liquid 示例：{{ product.title | escape }}、{%- if product.available -%}In stock{%- endif -%}、{% render 'product-card', product: product %}、{{ product.featured_image | image_url: width: 800 | image_tag: loading: 'lazy' }}。
限制：资料未说明该技能的收费、支持平台范围或效果保证。