woo-catalog-perfection

Woo Catalog Perfection

描述

逐个修复产品，并为每项更改创建快照，完成从“你的目录评分为 43”到“你的目录评分达到 90+”的闭环。

AI 购物界面会拒绝缺少图片、描述、品牌或标识符的商品行，并将内容单薄的商品排在最后。此技能将 Respira readiness fixlist 作为工作队列：为目录评分，获取按顺序排列的问题产品清单，并为每项缺失内容提供对应的修复工具；以安全的批次应用修复，然后重新评分，直到达到目标。它会编写真正有用的内容，而非填充内容：描述根据产品自身属性、类别和现有文案起草；任何不确定的信息都会加入待商家处理队列，而不是凭空编造。

需要 Respira WooCommerce Add-on v3.1+。

---

触发语句

用户说出以下任一内容时，此技能会触发：

• “修复我的目录以适配 AI”
• “提高我的 AI 就绪度评分”
• “修复未通过 feed 检查的产品”
• “我的产品总是被 Google 拒绝”
• “完善目录”
• “修复缺失的 GTIN” / “修复缺失的品牌” / “修复产品描述”
• “让我的目录评分达到 90”
• “清理我的产品数据”
• “WooCommerce feed 拒批”

**不要在以下情况触发：**feed 设置和平台注册（由 woo-agent-storefront 处理）、价格变更，或目录以外的内容工作。

---

执行工作流

第 1 步：评分并确定范围

依次调用 respira_get_site_context、woocommerce_catalog_ai_readiness 获取基准评分，以及 woocommerce_readiness_fixlist 获取按顺序排列的工作队列。报告：当前评分、未通过各项检查的产品数量，以及预计通过检查的产品数量。与用户确认目标（默认为 90）和批次大小（默认为每批 10 个产品，以便审核每个批次）。

第 2 步：按优先级修复

fixlist 会按影响程度排列工作项。针对每个产品，仅应用 fixlist 指定的修复，并使用其中指定的工具：

1. 缺少 GTIN → 如果用户能提供真实 GTIN，使用 woocommerce_update_product 设置 global_unique_id（询问用户，绝不捏造 GTIN。如果没有 GTIN，则设置品牌 + SKU，让标识符规则通过品牌 + MPN 验证）。
2. 缺少品牌 → 使用 woocommerce_create_brand / woocommerce_update_product 分配品牌。根据产品名称推断品牌，或询问一次店铺自有品牌；确保一致应用。
3. 缺少描述或描述过于单薄 → 使用 woocommerce_update_product。根据产品自身属性、类别和现有简短描述，起草 40-80 个词。不编造规格，不使用夸大用语。
4. 缺少图片 alt 文本 → 使用 woocommerce_set_image_alt，描述清晰且少于 125 个字符。
5. 缺少图库图片 → 使用 woocommerce_update_product 设置 gallery_image_ids，图片仅从现有媒体中选取（respira_list_media）；绝不使用外链。
6. 类别未映射 → 使用 woocommerce_set_feed_category_mapping 映射到最接近的 Google 分类树节点。

每次批量写入 10 个产品。插件会自动为每次写入创建快照；在报告中说明快照覆盖范围。

第 3 步：重新评分并循环处理

每批处理完成后，调用 woocommerce_validate_feed（google）检查评分变化。持续处理，直到达到目标、fixlist 为空，或剩余项目需要商家提供信息（真实 GTIN、产品照片）。将这些项目明确加入待处理队列，不要猜测。

第 4 步：报告

最后报告：修复前 → 修复后的评分、按检查类型统计的修复产品数量、写入的内容（附快照说明：“每项更改都可在 90 天内撤销”），以及待商家提供的信息（缺失的照片、需要补充的 GTIN）。如果已启用 feeds，请提醒用户它们会在几分钟内自动重建，因此修复内容会在 Google/ChatGPT 下次抓取平台数据时生效。

---

安全

• 对任何支持试运行的批量操作，先试运行；应用更改前先展示预览。
• 绝不伪造 GTIN、规格、材料、尺寸或认证信息。有不确定之处时，应提问或排队等待处理。
• 每批处理 10 个产品，并在批次之间重新评分，以便在处理 10 个产品后而非 500 个产品后发现错误模式。
• 每次写入都必须经过插件的快照封装；在最终报告中提及回滚。