用途
扫描 Shopify 店铺中全部活跃商品、集合和页面，标记缺失或过短的 SEO 标题（seo.title）与元描述（seo.description）记录。生成按流量潜力排序的 SEO 缺口优先列表（商品 → 集合 → 页面）。只读——不执行任何变更。
前置条件
已认证的 Shopify CLI 会话：shopify store auth --store <domain> --scopes read_products,read_content
API 权限范围：read_products、read_content
参数
store（string，必填，无默认值）：店铺域名，例如 mystore.myshopify.com
min_title_length（integer，可选，默认 10）：SEO 标题短于该字符数即被标记
min_description_length（integer，可选，默认 50）：元描述短于该字符数即被标记
scope（string，可选，默认 all）：扫描范围，可选 products、collections、pages 或 all
format（string，可选，默认 human）：输出格式，可选 human 或 json
安全性
这是只读技能——不执行任何变更，可随时安全运行。
工作流程
OPERATION: products——query（若 scope 包含 products）。输入：query: "status:active"、first: 250、select seo { title, description }、分页游标。预期输出：全部活跃商品及其 SEO 字段；分页直到 hasNextPage: false。
OPERATION: collections——query（若 scope 包含 collections）。输入：first: 250、select seo { title, description }、分页游标。预期输出：全部集合及其 SEO 字段。
OPERATION: pages——query（若 scope 包含 pages）。输入：first: 250、select seo { title, description }、分页游标。预期输出：全部页面及其 SEO 字段。
标记记录：缺失标题、缺失描述、标题短于 min_title_length、描述短于 min_description_length。
会话跟踪
Claude 必须在每个阶段输出指定内容。开始时输出带有 SKILL、Store、Started 的方框；每步之后输出 [N/TOTAL] 查询/变更、操作名、参数摘要与结果；完成时按 human 或 json 格式输出汇总。human 格式输出扫描数量、缺失数量以及商品中的主要缺口；json 格式输出 skill、store、summary（含 products、collections、pages 的 scanned、missing_title、missing_description、short_title、short_description）与 output_file。
输出格式
CSV 文件 seo_audit_<YYYY-MM-DD>.csv，列为：type、id、title、handle、seo_title、seo_description、issue。
错误处理
THROTTLED：API 速率超限，等待 2 秒，最多重试 3 次。空店铺：无商品/集合/页面，以摘要 0 records 退出。
最佳实践
优先修复最畅销商品的缺失元描述——描述会出现在搜索结果摘要中，直接影响点击率。良好的 SEO 标题长度为 50–60 个字符；元描述应为 120–160 个字符。可调整 min_title_length 与 min_description_length 以匹配这些目标。每月运行一次作为目录卫生例行工作，尤其是在批量导入商品之后，因为批量导入常遗漏 SEO 字段。修复缺口后，可搭配 product-data-completeness-score 获得完整的目录质量视图。