SKU裂变工坊 V3.0

电商SKU套图智能生成器 — 一张产品原图 → 多SKU规格图，全流程AI驱动

🎯 这是什么？

SKU裂变工坊是一个 Codex CLI Skill，专门解决电商SKU套图的批量生成问题。你只需要提供产品原图和SKU信息（名称、规格、数量、赠品等），它会自动：

1. 分析产品类别和SKU数据，构建视觉事实契约
2. 自动判断每个SKU差异是纯文案还是需要结构级新场景
3. 确认母版策略和层级结构
4. 逐个生成底稿 → 母版 → SKU子变体
5. 对每张图执行视觉质检和缩略图可读性检查
6. 输出完整的关系报告

核心能力： 一张产品底稿 → N个不同规格/数量的SKU套图，智能区分文案变更和结构变更，保持产品一致性和视觉统一。

🏗️ 四层架构

项目 (Project)
  └─ 母版组 (Master Group) × N
       ├─ 底稿视觉 (Base Visual)  ← 产品场景层
       ├─ 母版模板 (Master Template) ← 信息设计层  
       └─ SKU变体 (SKU Variant) × N  ← 最终输出

🆕 V3.0 新特性：智能变更分类

SKU裂变工坊现在会自动区分两种SKU差异：

纯文案变更 copy_only

当前像素已经真实呈现了新文案所陈述的所有可见事实。只需编辑标题措辞、卖点、标签等非视觉信息 → 在 sku_variant 层直接编辑。

结构变更 structural

新文案要求产品区域的像素发生变化：产品型号、数量、颜色/材质、可见尺寸/容量、包装形态、组件、配件/赠品、接口、开合状态等 → 必须新建底稿和兄弟母版。

示例： 1件→2件、500ml→1L（容器不同时）、黑色→白色、S码→XL码、裸机→含配件、袋装→盒装、一拖一→一拖二→一拖三

结构变更的兄弟母版共享排版家族（字体、调色板、徽章、图标），但各自绑定独立的底稿和产品区域。

🧠 三个核心决策

使用前需要确认三个独立决策（已明确的可跳过）：

1. 底稿策略 base_strategy

2. 母版拓扑 master_topology

3. 继承强度 inheritance_mode

📦 安装与使用

前置条件

• 安装 Codex CLI
• 已配置 AI 图像生成模型（如 GPT image、Seedream 5.0、即梦 5.0 等）

安装 Skill

# 克隆本仓库到 Codex skills 目录
git clone https://github.com/elangan1997-cmyk/sku-variant-studio-skill.git ~/.codex/skills/sku-variant-studio

快速开始

在 Codex 中输入以下任一触发词即可激活：

SKU裂变 / SKU套图 / SKU母版 / 电商SKU / 拼多多SKU图 / 批量规格图

最简用法（保留原图 + 单母版 + 严格继承）：

使用当前原图，仅增加对应 SKU 名称和标签，不修改底稿内容。

SKU 列表：
- 试用装 10个
- 实用装 1斤
- 家庭装 3斤
- 加量装 5斤 赠硝化细菌
- 囤货装 10斤 赠硝化细菌

Skill 会自动识别为 original_preserve + single_master + strict，跳过确认直接生成。

📋 完整工作流程

第一步：上传产品原图

在 Codex 对话框中上传你的产品图片（支持多张）。

第二步：提供SKU信息

告诉 Codex 你的 SKU 列表，例如：

产品：培菌柱（鱼缸过滤滤材）
SKU列表：
1. 试用装 10个
2. 实用装 1斤  
3. 家庭装 3斤
4. 加量装 5斤 赠硝化细菌
5. 囤货装 10斤 赠硝化细菌

第三步：自动分类变更类型

Skill 自动分析每个SKU差异，分类为「纯文案变更」或「结构变更」，构建视觉事实契约和SKU矩阵。

第四步：确认三个决策

Skill 会自动分析你的输入，然后询问：

• 底稿策略：保留原图 or AI变换？
• 母版拓扑：单母版 or 多组母版？
• 继承强度：严格 or 半严格 or 风格继承？

你也可以一次性说清楚，跳过询问。

第五步：审核母版组计划

Skill 会输出完整的分组计划，包含每个矩阵单元的预期输出数量。审核通过后才会开始生成。

第六步：逐组审批

每个母版组按顺序处理：

1. 底稿审批 → 确认产品场景正确
2. 底稿自检 → 对照绑定卡验证
3. 母版审批 → 确认信息设计正确
4. 锁定母版 → 创建模板锁
5. 生成SKU变体 → 批量生成子规格图
6. 视觉质检 → 每张图 ≥90分 + 缩略图可读性检查

第七步：收尾

生成完成后的输出：

• 所有通过的底稿、母版、SKU变体图片
• SKU裂变关系报告（含文件路径、QA评分、锁定规则）
• 矩阵完整性审计

🔒 安全机制

视觉事实契约

每个SKU生成前解析文案为事实契约，与父级契约对比，证据不足或矛盾时标记 needs_user_confirmation，绝不假设纯文字编辑是安全的。

源图-SKU 绑定卡

每个SKU生成前必须建立绑定卡，明确：

• 允许使用的源图ID及角色
• 产品本体锁定项（轮廓、材质、颜色、结构等）
• 赠品/配件清单及数量
• 禁止出现的物品/声明

视觉自检

每张生成图自动执行：

• 硬失败检查：产品错误、赠品缺失/多余、文字冲突 → 直接作废重来
• 一致性评分：≥90/100 才算通过
• 缩略图可读性：SKU名称和关键差异在缩略图尺寸下必须可读
• 修复策略：文字问题可修复，产品映射错误必须重生成

母版锁定

审批通过后立即锁定，后续SKU严格按锁生成，防止串版。

📂 文件结构

sku-variant-studio/
├── SKILL.md              ← Skill 主文档（运行规范）
├── README.md             ← 本文件
├── prompts/              ← 各阶段提示词
│   ├── 01-analyze-input.md
│   ├── 02-confirm-project-structure.md
│   ├── 02a-classify-visual-change.md    ← 🆕 变更分类
│   ├── 03-preserve-original-base.md
│   ├── 03-build-base.md
│   ├── 03-build-structural-sibling-base.md  ← 🆕 结构兄弟底稿
│   ├── 04-build-master.md
│   ├── 04-transform-base-img2img.md
│   ├── 05-generate-variant.md
│   ├── 06-repair-text.md
│   ├── 07-repair-product.md
│   └── 08-consistency-check.md
├── references/           ← 参考规则
│   ├── master-hierarchy.md
│   ├── template-lock-rules.md
│   ├── product-consistency-rules.md
│   ├── visual-self-check.md
│   ├── model-only-workflow.md
│   ├── retry-strategy.md
│   ├── structural-variation.md      ← 🆕 结构变更规则
│   └── batch-integrity.md           ← 🆕 批量完整性
├── schemas/              ← JSON Schema 数据契约
│   ├── project.schema.json
│   ├── master-group.schema.json
│   ├── master-template.schema.json
│   ├── base-visual.schema.json
│   ├── sku.schema.json
│   ├── generation-task.schema.json
│   ├── sku-matrix.schema.json           ← 🆕
│   ├── source-sku-binding.schema.json   ← 🆕
│   └── visual-fact-contract.schema.json ← 🆕
├── examples/             ← 示例项目
│   └── five-masters-three-variants/
└── agents/               ← Agent 配置
    └── openai.yaml

🎨 实际案例

培菌柱 SKU 裂变（3组母版 × 5个SKU = 15张）

输入： 3张不同场景的产品原图（英雄陈列、滤篮陈列、过水滤仓）

配置：

• 底稿策略：img2img_transform
• 母版拓扑：grouped_multi_master
• 继承强度：strict

输出： 15张SKU规格图，全部QA评分 ≥95分

⚠️ 重要约束

1. 禁止代码合成：所有最终图片必须由 AI 图像生成/编辑模型生成，禁止使用 Python/PIL/OpenCV/SVG/Canvas/HTML 等代码方式合成
2. 模型驱动：图片生成、编辑、文字叠加均由模型完成，不使用程序化文字叠加
3. 审批不可跳过：底稿、母版必须逐项审批，不得跳过或自动通过
4. 1:1 默认比例：除非用户指定，所有SKU图默认 1:1 正方形比例
5. 禁止跨组借用：不同母版组之间的底稿、产品、布局不得混用
6. 结构变更必须拆分：任何需要像素级产品变化的SKU必须独立建底稿/母版

🆚 对比传统方式

📄 License

MIT

---

🤖 Generated with Claude Code