用途
该技能用于为 Shopify 店铺中的商品计算数据完整度分数（0–100），依据关键字段是否存在来评分，并输出需要补数据最多的商品排名列表。运行过程为只读，不执行任何写操作。它把 Matrixify 质量检查与 SEO Manager 扫描合并为一份目录健康报告。
主要能力
评分基于以下字段是否完整：描述、图片、SEO 标题、SEO 描述、变体重量、条码、成本以及指定元字段。评分为每商品 0–100 分，并可按分数升序排列，帮助优先处理数据缺失最严重的商品。
评分细则
- 存在非空描述：15 分
- 至少 1 张图片：15 分
- 存在 SEO 标题：10 分
- 存在 SEO 描述：10 分
- 至少 1 个变体有条码：10 分
- 至少 1 个变体有成本：10 分
- 至少 1 个变体有重量：10 分
- 所有必需元字段均存在：20 分（平均分摊）
- 合计：100 分
使用方式
前置条件：已认证的 Shopify CLI 会话，命令为 shopify store auth --store <domain> --scopes read_products；API 权限范围为 read_products。
参数：
- store（字符串，必填，无默认值）：店铺域名，例如 mystore.myshopify.com
- status_filter（字符串，可选，默认 active）：要评分的商品状态，可选 active、draft 或 all
- required_metafields（数组，可选，默认 []）：必需的 namespace.key 元字段列表，例如 ["custom.material"]
- format（字符串，可选，默认 human）：输出格式，可选 human 或 json
工作流程：通过 GraphQL products 查询按 status 筛选商品，每次取 250 条并分页直至 hasNextPage 为 false；查询字段包括 id、title、handle、descriptionHtml、images、seo、variants（barcode、weight、inventoryItem.unitCost）、metafields。随后按上述评分细则为每个商品打分，并按分数升序排名。
输出格式
生成 CSV 文件 completeness_<YYYY-MM-DD>.csv，列为：product_id, title, score, has_description, image_count, has_seo_title, has_seo_description, has_barcode, has_cost, has_weight, missing_metafields。human 格式会输出报告摘要，包含评分商品数、平均分、各分数区间数量以及最低分商品列表；json 格式输出包含 skill、store、products_scored、avg_score、below_50_count、output_file 等字段。
适用场景
可作为商品上架前的检查关卡，在上架草稿商品前运行，确保必需字段完整；可根据店铺需要定制 required_metafields，例如服装用 custom.material、食品用 custom.ingredients；可每月运行以跟踪目录质量趋势，内容优化后的平均分提升应能体现出来。分数低于 50 通常意味着缺少基础内容（描述或图片），建议推迟上架直至修复。
限制与错误处理
遇到 THROTTLED（API 速率限制）时，等待 2 秒后重试，最多 3 次；若无商品匹配筛选条件（空目录或筛选错误），则以 0 条结果退出。该技能为只读，任何时间运行均安全。所需 API 权限为 read_products。