# Sealeap Xuanwu Amazon Variation Theme Migration

> Audit and migrate Amazon parent-child variation themes against the current product template without breaking valid families. Use when a theme is deprecated, an update returns an invalid-value error, or catalog maintenance may split a family.

- Skill: `xjli360/sealeap-xuanwu-amazon-variation-theme-migration` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add xjli360/sealeap-xuanwu-amazon-variation-theme-migration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xjli360/sealeap-xuanwu-amazon-variation-theme-migration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: xjli360 (https://skillmd.com/u/xjli360)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xjli360/sealeap-xuanwu-amazon-variation-theme-migration

---


# Amazon 变体主题迁移

## 目标

在不制造虚假变体关系、不中断有效子体销售的前提下，判断现有家族应保持、修复还是迁移，并形成可回退的分批操作方案。

## 何时使用

- 后台提示变体主题已弃用或指定值无效
- 计划更新父子体但担心家族拆散、评价或库存受影响
- 需要核对类目模板里的当前有效主题

## 开始前要拿到

- marketplace、product type、父 SKU、子 SKU/ASIN 与当前主题的完整快照
- 当前类目模板、可选主题、报错文本和采集时间
- 各子体的真实差异属性、库存、在售状态和详情页证据
- 计划修改的字段、批次、低流量窗口和回退负责人

缺失项必须标为 `UNKNOWN` 或 `NEEDS_EVIDENCE`；不得猜数字、补属性，或混用不同站点、ASIN、币种和时间窗。

## 不可妥协的边界

- 当前 Amazon 官方规则、目标账户实时状态和一方业务报告优先；公开内容与第三方数据只能作为待验证启发或代理证据。
- 默认提供诊断或草案。写入前展示对象、旧值、新值、影响、停止线与回退，核对用户已有授权是否覆盖对象、动作与预算；范围已明确授权时继续执行并回读核验，只有未覆盖或扩大的范围才请求批准。
- 数值、政策、因果和执行状态分别标为 `FACT`、`ESTIMATE`、`ASSUMPTION` 或 `UNKNOWN`。
- 不保存或输出素材来源身份、账号、链接、文章编号、发布日期、阅读量、原始话术或其他可反查线索。
- 不得为了共享评价或流量而合并不同产品；每个子体必须真实符合所选变体维度。
- 不要因旧主题出现在历史家族中就擅自删除父体；先确认当前通知、模板与实际更新需求。
- 涉及删除或重建父体时必须先导出映射和原值，并在小批量验证后再扩大。

## 工作流

1. 冻结当前父子关系、主题、属性、SKU/ASIN、库存与前台展示快照。
2. 下载目标站点当前模板，把主题分为仍有效、已弃用、未知三类，并保存证据日期。
3. 区分无需更新且仍正常的家族，与必须改动或已报错的家族；未知项保持 HOLD。
4. 把每个子体映射到一个真实且当前有效的差异维度，生成旧值、新值和不可迁移项。
5. 先在低风险家族或最小批次执行草案，核对父子关系、可售状态、详情页与搜索后再继续。
6. 若出现子体孤立、属性丢失、库存异常或页面错误，立即停止；仅恢复仍符合当前主题规则的已知有效映射，弃用主题不能盲目回填，无法安全恢复时升级人工支持。

## 判断状态

- `READY`：关键输入、资格与当前规则已核实，方案有成功、停止和回退条件。
- `HOLD`：方向可能成立，但关键证据或审批仍缺失。
- `STOP`：存在硬性违规、不可承受的经济性、虚假信息或无法回退的风险。

## 必须交付的结果

- 家族影响清单与证据状态
- 旧主题到新主题的逐 SKU 映射
- 分批操作、验证与回退运行表
- 无法安全迁移的 HOLD 清单
- 数据范围、采集时间、定义、证据状态、限制和待批准动作

详细台账与质量门见 [references/playbook.md](references/playbook.md)。