用途：为 Shopify 店铺回填缺失的搜索外观元数据（Google 结果摘要中显示的 SEO 标题与 meta 描述），覆盖商品、集合、页面和博客文章。核心原则是“只填空，不覆盖”：商家手写的 meta 标题价值高于模型生成内容，因此只处理空字段。姊妹技能 shopify-alt-text 负责商品图片 alt 文本，shopify-json-ld 负责结构化数据，shopify-catalog-audit 用于先测量缺失量。
主要能力：按实体类型读取并写入 SEO 字段。商品与集合读取 seo { title description }，分别通过 productUpdate、collectionUpdate 写入；页面与文章使用 global.title_tag 与 global.description_tag 元字段，通过 metafieldsSet 写入。两个字段独立处理，只生成并写入空白的那一个。
使用方式：需访问 Admin API。方式 A 使用自定义应用令牌，设置环境变量 SHOPIFY_STORE 与 SHOPIFY_ACCESS_TOKEN，用 curl 调用 admin/api/2025-07/graphql.json；方式 B 使用 Shopify CLI OAuth：shopify store auth --store $SHOPIFY_STORE --scopes read_products,write_products,read_content,write_content，再用 shopify store execute 执行。最小权限：商品与集合需 read_products + write_products，页面与文章需 read_content + write_content。可选安装 Shopify 官方 AI 工具包插件。
流程与限制：先运行只读 COUNT 统计缺失数量并核对合理性，异常则停止重新评估；批量前用真实 1-token 补全预检 LLM 密钥；逐条生成、写入并记录日志（资源 id、字段、旧值、新值、状态）；写入后通过 Admin API 而非店面回读验证，因为店面 meta 标签有 CDN 缓存。提示词需提供品牌定位、控制长度（标题约 50–60 字符，描述约 150–160）并避免关键词堆砌。源数据质量决定输出上限，若刚做过描述清理需确认重扫通过。GraphQL 固定为 Admin API 2025-07，Shopify 按季度弃用版本，使用前应在 shopify.dev 核对。完整查询、变更与提示词见 references/queries-and-prompts.md。