技能介绍

很多 Shopify 应用的 AI 辅助开发会卡在信息层：模型要么凭训练记忆写 GraphQL，要么在过时或碎片化的文档里反复试错，代码到了商店侧才发现 Schema 已经漂移。本技能通过 Shopify 官方 AI Toolkit，把代理（Claude Code、Cursor、Gemini CLI、Codex 等）与 IDE 助手接入 Shopify 的文档、API 模式、代码验证和商店管理工作流，让实现与校验在同一条上下文里完成。

它解决什么问题

离线记忆与当前 API 版本不一致，orders、checkout 等字段容易写错
人工在 shopify.dev 与编辑器之间来回切，验证反馈滞后
商店侧部署/变更流程与代码改动脱节，容易出现「本地能跑、线上报错」

核心能力与工作方式

官方文档直达：将 Shopify 文档接入代理和 IDE 上下文，模型在生成/审查代码时可引用当前 API 与构建指南，减少猜测。
API 模式查询：把请求建立在 Shopify 当前 Schema 上（如查询/变更的实际字段名），而不是凭印象补全。
代码验证：对生成的应用代码做符合性检查，尽早暴露与 Shopify 要求不一致的实现。
商店管理工作流：在需要真实环境时，借助 Shopify CLI 执行常见工作流；并非所有子任务都会触达线上商店。

适用边界与注意点

前置要求：受支持的客户端（如 Claude Code、Cursor、Gemini CLI、Codex 或 VS Code）；执行商店工作流时需本机可用的 Shopify CLI。
本技能不替代 Shopify CLI、GraphQL 或应用脚手架：商店操作、认证与部署仍按 Shopify 官方流程执行。
结论应回溯到当前 Schema 与官方文档；长任务里注意查看工具返回的校验信息再改代码。
上游文档来自 Shopify AI Toolkit 的 README，Shopify 侧可参考 shopify.dev/docs/apps/build/ai-toolkit。