用途:该技能面向 Shopify 开发者,帮助针对特定店铺执行已验证的 Admin GraphQL 操作,主要回答是可运行的店铺工作流,而不是单纯的 GraphQL 代码块。适用于用户明确要求对某个店铺执行操作(如店铺域名、店铺位置或仓库、基于 SKU 的库存变更、商品变更,或要求 run/execute 某操作)的场景。
主要能力:推导并验证正确的 Admin GraphQL 查询或变更,然后将其包装为 Shopify CLI 的店铺执行流程。对于显式店铺范围的请求,即使是只读操作(show、list、find)也保持执行模式。若执行需要中间查询(如库存项 ID 或位置 ID),仍保持在店铺执行模式内完成。
使用方式:必须先使用 shopify-admin 技能,通过 scripts/search_docs.mjs 搜索 Admin API 文档找到正确操作,并用 scripts/validate.mjs 编写和验证 GraphQL 查询或变更;只有验证通过后,才用本技能包装为 shopify store auth --store ... --scopes ... 加 shopify store execute --store ... --query ... 工作流。两条命令都必须带 --store <store-domain>;若用户未提供域名,也要用占位符如 <your-store>.myshopify.com。验证输出若含 Required scopes 行,则使用其中精确的最小权限范围;否则按操作类型选择最窄的明显范围(如 read_products、write_products、read_inventory、write_inventory)。只读操作不加 --allow-mutations,变更操作必须加。优先使用内联 --query(必要时加 --variables),不要要求用户创建单独的 .graphql 文件;若用文件方式须显式使用 --query-file。
限制:仅用于店铺范围操作;未指定店铺上下文的通用 Admin API 请求应改为解释或构建 GraphQL。最终答案不得留占位符,不得提供独立 GraphQL、cURL、应用代码、Shopify Admin UI 手动替代或非店铺 CLI 替代,也不得输出 ```graphql 代码块。若 shopify store execute 不可用,可提示升级 Shopify CLI 至 3.93.0 或以上,但仍需展示预期的 auth 加 execute 工作流。该 API 专用于通过 Shopify CLI 对店铺执行 Admin GraphQL 操作,不用于通用 Admin API 讲解。