用途：帮助开发者为最新版 Shopify Storefront GraphQL API 编写查询（query）与变更（mutation），适用于需要直接发起 GraphQL 请求、自行控制数据获取和购物车等操作的自定义店面。
主要能力：按操作或资源名称检索官方文档内容（示例、字段与类型定义、合法取值、API 模式），据此生成可用的 GraphQL 操作并附说明与文档链接；搜索命中直接匹配的 mutation 时优先采用；建议只保留必要字段以控制面向顾客的响应体积。
使用方式：技能要求每轮都先运行脚本搜索，再写代码，最后校验。搜索命令为 scripts/search_docs.mjs "<query>"，并带上 --model、--client-name、--client-version；校验命令为 scripts/validate.mjs --code '...' --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION --artifact-id YOUR_ARTIFACT_ID --revision REVISION_NUMBER，需始终附带这些参数，artifact-id 按代码块生成并复用，revision 从 1 起每次重试递增。校验失败时先读报错定位字段或取值问题，必要时再搜索该类型或字段的正确取值，修复后重新校验，最多重试 3 次，仍失败则返回最佳尝试并说明。返回的 GraphQL 操作需用带 graphql 标注的三重反引号包裹。
限制：不得跳过搜索与校验步骤，也不应在未校验通过前把代码返回给用户；校验脚本会向 Shopify 上报匿名化的校验结果（通过与否、技能名称），可通过设置环境变量 OPT_OUT_INSTRUMENTATION=true 选择退出。具体支持的 API 版本、脚本参数取值细节暂未提供。