用途：Shopify Dev MCP 负责按 Shopify 各 API 面路由 MCP 工具调用，属于标准查询而非深度推理。内置 Shopify 技能已覆盖的界面（Admin GraphQL、App Home 标记、Admin 扩展、现代结账扩展、客户账户 UI、应用商店预审、shopify.app.toml/CLI 工作流）应优先使用对应内置技能，仅在界面未被覆盖、需在同一次对话中跨两个界面交叉引用模式，或已安装技能的内置脚本不可用/报错时才使用本技能。它不适用于旧版 post-purchase（@shopify/post-purchase-ui-extensions-react），该校验器会按设计拒绝所有旧版 post-purchase 组件，旧版 SDK 应使用 post-purchase-ui-extension 技能并用 tsc --noEmit 校验。
主要能力：提供 15 个 API 面（admin、admin-execution、storefront-graphql、partner、customer、payments-apps、functions、polaris-app-home、polaris-admin-extensions、polaris-checkout-extensions、polaris-customer-account-extensions、pos-ui、hydrogen、liquid、custom-data）的上下文加载、文档语义检索、完整文档抓取、组件标记校验、GraphQL 代码校验与模式探查、扩展目标类型查询及主题校验。
使用方式：先用 learn_shopify_api 传入目标 api 面初始化并取得 conversationId，后续所有调用均需携带该 ID；切换 API 面时用同一 conversationId 再次调用。按需选择 search_docs_chunks（语义搜索文档并返回 URL，首选）、fetch_full_docs（按路径抓取完整页面）、introspect_graphql_schema（查字段/类型/查询/变更及所需权限）、learn_extension_target_types（查扩展目标的组件与 API 类型）。提交代码前必须校验：<s-*> 组件标记用 validate_component_codeblocks，GraphQL 查询/变更用 validate_graphql_codeblocks，Liquid/主题文件用 validate_theme。校验失败则修复并重新校验，同一 artifactId 递增 revision；同一产物连续两次校验失败应停止并告知用户。注意参数命名相反：组件校验用 code（数组），GraphQL 校验用 codeblocks（数组），且 GraphQL 内容为原始 GraphQL 不带 Markdown 代码围栏。
限制：工具可用性因 MCP 服务器构建而异，未注册时可退回 search_docs_chunks；storefront-graphql 下 introspect_graphql_schema 与 fetch_full_docs 受限，仅 search_docs_chunks 可靠。validate_component_codeblocks 的 api 枚举为 7 个值，GraphQL 校验与模式探查共享 18 个值的扩展枚举（functions 拆为 13 个子类型，且不含 admin-execution）。扩展面（polaris-admin-extensions、polaris-checkout-extensions、polaris-customer-account-extensions、pos-ui）必须传 extensionTarget。校验器不把 App Bridge Web 组件（<s-app-window>、<s-app-nav>）识别为 JSX 内置元素，在 TSX 中会校验失败，可改用原始 HTML、App Bridge React 包装组件或 JSX 类型增强。learn_extension_target_types 不支持 polaris-app-home。