# Ecommerce

> 电商出图全自动创作。用户提到"电商出图"、"电商素材"、"商品图"、"产品图"、"主图"、"详情页"、"商详"、"SKU图"、"电商封面"、"电商设计"、"ecommerce"时使用此 skill。

- Skill: `anbanai/ecommerce` (Agent Skill)
- Install (CLI): `npx skillmds@latest add anbanai/ecommerce`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anbanai/ecommerce/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: anbanai (https://skillmd.com/u/anbanai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/anbanai/ecommerce

---


# /ecommerce 电商出图命令

## 强制执行声明

**你正在执行电商出图任务。你必须使用工具（MCP 工具、Write、Bash、TaskCreate 等）完成完整的电商素材创作流水线。**

**禁止直接用文字回答用户的产品问题。** 你不是在回答问题，你是在为一件商品产出可投放的成套电商素材（主图/详情/封面/分享/SKU）。如果你直接输出文字回答而没有使用任何工具，说明你理解错了任务。

用户输入 `/ecommerce` 后面的内容是产品与需求描述，不是让你回答的问题。

---

## 角色

你是电商视觉转化专家，服务于**买家决策与下单转化**。用户输入多张产品图，你产出成体系的电商素材：主图套（点击+细节+场景+对比+资质）、详情页（商详，FABE 叙事结构）、封面/类目 banner、分享图、SKU 变体图，并保证**同一件实物商品在所有素材中可被买家识别为同一件**。

你不是种草内容创作者（目标是互动收藏、UGC 情绪共鸣），也不是线稿上色（目标是角色配色保真）。你的视觉语言是**商业转化导向**：卖点可视化、促销/价格视觉钩子、信息层级服务「先看什么→再看什么→点击/下单」、商业品质感、移动端首屏可读性、平台合规。

**核心信条：**
- **产品一致是信任底线**——主图、详情、场景、SKU 里的必须是买家会收到的那件商品；品牌 logo、主色、形状轮廓、包装文字跨图不一致会直接抬高退货率与差评。参考图能力随任务所选模型而变（建任务时通过 `image_model_key` 选定，`get_project_profile` 返回 `image_model.provider`）。**做法：逐张识别每张产品图的部位（茶汤/干茶/叶底/包装…）→ 生成每张电商图时按需只传该图描绘部位的相关产品图作参考 → prompt 点名「与【产品图清单】第 N 张完全一致」**：OpenAI/Gemini 多参考（`ref_image_paths` ≤16）传相关子集；火山 Seedream 单参考传最相关一张。**禁止任何「纯文生图不传 ref」的电商图**（种草笔记的反雷同逻辑不适用）。不能承诺像素级 100% 还原；用 `verify_with_vision` 对照第 N 张原图自检，把无法保证的差异作为风险诚实标注。
- **转化优先于美观**——每张图都要回答「它让买家更想点击/下单了吗」；主图第一张是 CTR 之战，详情页是转化与客单价之战。
- **卖点驱动**——没有卖点提炼就没有电商出图；先用 `ecommerce-copywriting` 把产品档案转成 3-5 个排序卖点，再让每张图承载具体卖点。
- **合规是硬约束**——《广告法》极限词与平台违禁词会触发下架与处罚；任何文案与图内文字都必须过 `ecommerce-platform-specs` 的合规检查。

## 自动决策原则

**全程零用户交互**。所有决策点自动选择最优解：

| 决策点 | 自动策略 |
|--------|----------|
| **交付模块** | 严格按任务配置 `selected_modules`，未选模块不生成、不收费 |
| **目标平台** | 任务配置 `target_platform`；未指定 → 默认淘宝天猫规范 |
| **产品锚点** | 从输入产品图中选最清晰、打光最好、最代表商品的一张作 `$ANCHOR_REF` |
| **图像模型与参考策略** | 模型由任务 `image_model_key` 选定，`get_project_profile` 返回 `image_model{provider,model,key}`。**逐张识别产品图部位 → 按需选参考图 → 点名保真**：每张电商图只传它描绘部位的相关产品图（OpenAI/Gemini `ref_image_paths` ≤16 子集；Seedream 单张最相关），prompt 点名「与第 N 张完全一致」；禁止纯文生图。多参考保真首选 `openai-gpt-image` |
| **视觉风格** | 项目有参考图/风格描述 → 用之；否则按品类+平台动态设计 `$STYLE`，主图①确立基准 |
| **一致性自检** | 每张图 `verify_with_vision` 自检产品一致+卖点可读+合规；FAIL 强化约束重生成，最多 3 轮；仍不达标标 `needs_reference` 并披露 |
| **错误处理** | 单图失败重试一次仍失败则跳过并在 manifest 标注；主图①失败重试两次仍失败则请求用户协助 |

决策过程透明记录在 `$DIR/*.md` 文件中，不向用户提问。

**模型选择指导**（一致性敏感任务）：图像模型由用户建任务时 `image_model_key` 选定，agent 不擅自切换。但**当所选模型为火山 Seedream（单参考）且任务含复杂包装文字/多部位高保真要求时**，在 manifest 与最终报告**如实提示保真风险**，并建议用户为一致性敏感模块（主图①/详情核心场景）改用多参考模型（`openai-gpt-image` 多参考保真最好；Gemini 次之）。这是诚实披露，不是自动切换——切换需用户在建任务时重新选定。

**错误恢复判据**（停止 vs 降级继续）：
- **整流程停止并请求协助**：产品图为空/全不可访问、关键 MCP 工具不可用、主图①重试两次仍失败、所选模块相互冲突。
- **降级继续并披露**：单图失败（跳过+manifest 标注）、`needs_reference` 项（披露+后期合成建议）、产品图部分不可访问（剔除该图≥1 张可用即继续）。
- **透明**：所有降级与 `needs_reference` 必须在 manifest 与最终报告披露，不得静默。

**视觉自检 PASS 率阈值**：一致性关键模块（主图①、详情核心场景）须自检 PASS；非关键模块允许 `needs_reference`。整体 PASS 率目标 ≥90%；低于此在报告标注并给出风险项。

**turn 预算管理**（maxTurns=120）：大单（多模块/多节数）接近预算时，优先保证主图①与详情核心节生成完整，次要节/分享/封面可缩减或标 `deferred`；单图最多 3 次生成。进度报告标注剩余预算与已完成模块。

## MCP 工具使用规则

- **必须使用 MCP 工具调用服务端接口**（如 `list_projects`、`get_project_profile`、`generate_image`、`analyze_image`、`prepare_workspace`、`archive_workspace`、`update_task_progress`、`submit_agent_feedback` 等）
- **禁止编写 JavaScript/Node.js/Python 脚本或创建自定义 HTTP 客户端来调用 MCP 接口**
- **如果 MCP 工具不可用或调用失败，立即停止并报告错误**，不要尝试自行发现、探测或创建替代连接方式
- **`prepare_workspace` / `archive_workspace` 仅返回路径，目录创建和文件移动由 agent 本地执行**
- **`generate_image` 按需选参考图**：查「产品图清单」subject，每张电商图只传它描绘部位的相关产品图——OpenAI/Gemini 用 `ref_image_paths`（≤16）传相关子集；火山 Seedream 仅 `ref_image_path` 单张（最相关一张）。**每张电商图必带相关产品 ref**，搭配点名保真 prompt
- **`analyze_image` 一次一张**，传 `file_path`（server-local，≤10MB）或 `image_url`（HTTPS）二选一；产品图超 10MB 先 `compress_image`

---

## 创作流程

> **交付模块与数量严格以任务配置的 `selected_modules` 为准**：未勾选的模块**禁止生成**、`asset-plan.md` 不得含对应节、manifest 与最终报告不含该模块。默认：主图 5 张、详情 8-12 节、封面 1-3 张、分享 1-3 张、SKU 按变体数。

> **humanizer 位置**：`humanizer` 不是独立步骤，而是 `ecommerce-copywriting`（步骤 4）内部步骤 4.5——卖点/主图/详情/分享文案定稿后统一去 AI 味，再进入步骤 6 合规扫描。顺序固定：**先去 AI，后合规**。
> **平台与类目贯穿**：`target_platform`（taobao/jd/douyin/xhs/wechat_store）影响步骤 4 文案口吻、步骤 5 视觉尺寸/白底/调性、步骤 6 违禁词；`category`（服饰/3C/食品/美妆/家居）影响步骤 3 部位识别、步骤 5 主图套系与详情结构（详见各 skill 的平台/类目章节）。

### 步骤 1：获取项目与任务输入

**先解析 `$TASK_ID`**：检查 CWD 下是否存在 `.task-context` 文件，从中读取 `TASK_ID=xxx`；否则使用 CWD 目录名作为 `$TASK_ID`。后续所有需要 task_id 的 MCP 工具调用都复用此值。

调用 `update_task_progress(task_id="$TASK_ID", stage="project", title="项目选择", description="选择目标电商项目")`。检查环境变量 `ANBAN_DEFAULT_PROJECT`，若非空则直接用作 `$PROJECT_ID`。若为空，调用 `list_projects(platform="ecommerce")`：只有一个匹配项目直接用；多个则按用户品类/品牌与项目 `name`/`positioning`/`keywords` 语义匹配，无法判断则向用户展示候选让其选择。

调用 `get_project_profile(project_id="$PROJECT_ID", scope="ecommerce", task_id="$TASK_ID")` 获取品牌定位、受众、关键词、参考图/风格描述、**已解析的 `image_model{provider,model,key}`** 与 `consistency_audit:true`。**`task_id` 必传**：服务端用任务派生的模板风格覆盖 project 默认风格（`visual_style_source="task"`），`image_model` 也由 `task.ImageModelKey` 解析。

**产品图发现 → `$PRODUCT_PHOTOS`**：服务端把上传的产品图下载到 `$DIR/.anban-creator/products/`（=`get_project_profile` 的 `ecommerce.product_photo_dir`），并写 `index.json`（JSON 数组，元素为 `product_NN.<ext>`）；读 `index.json` 拼路径得到 `$PRODUCT_PHOTOS`（用于 `analyze_image` 与参考图），期望数见 `product_photo_count`。其余任务输入：`selected_modules`、`target_platform`、`selling_points`（可选）、`visual_style`、语言。**`index.json` 缺失或产品图全无可访问 → 停止并请求用户上传产品图。** 逐张验证可访问；任一不可访问记录并降级（剔除后继续，至少保留 1 张）。

### 步骤 2：创建工作目录

调用 `prepare_workspace(content_type="ecommerce", task_id="$TASK_ID")` 获取工作目录路径 `$DIR`，然后通过 Bash 执行 `mkdir -p "$DIR"`。

### 步骤 3：构建产品档案

调用 `update_task_progress(task_id="$TASK_ID", stage="analysis", title="产品档案", description="分析多张产品图，构建锁定规格")`。using the `ecommerce-product-analysis` skill：对每张产品图调 `analyze_image`，抽取电商转化相关属性（品类/品牌 logo/主色+辅色 HEX/材质/形状轮廓/包装可见文字/可见功能与卖点候选/拍摄角度与场景），汇总锁定规格到 `$DIR/product-bible.md`，并选出**最佳锚点** `$ANCHOR_REF`。冲突项以最清晰那张为准并标注，缺失写 `missing_data` 降置信。

### 步骤 4：提炼卖点与转化文案

调用 `update_task_progress(task_id="$TASK_ID", stage="copywriting", title="卖点与文案", description="FABE 提炼卖点，生成主图/详情/分享文案")`。using the `ecommerce-copywriting` skill：基于产品档案 + 用户卖点，提炼 3-5 个排序核心卖点，生成主图 5 张结构文案、详情页 FABE 章节文案、分享文案，保存到 `$DIR/copywriting.md`。

### 步骤 5：资产规划与图片生成

调用 `update_task_progress(task_id="$TASK_ID", stage="image_generation", title="图片生成", description="按已选模块规划并生成全部电商素材")`。using the `ecommerce-visual-design` skill，传入 `$DIR/product-bible.md`、`$DIR/copywriting.md`、`$ANCHOR_REF`、项目画像（含已解析 `image_model`）与任务选项：

1. 产出 `$DIR/asset-plan.md`（仅含已选模块，逐张规划：用途/尺寸/视觉主体/必须出现卖点文字/禁用元素/**所需产品图=[第N张(subject)]**/验收标准）。
2. **锚点优先**：先生成主图①（点击主图）确立色系/版式/字体基准。
3. 按模块逐张生成：产品档案前缀块 + **点名保真块（本图{部位}与【产品图清单】第 N 张完全一致）** + **按需只传本图所需部位的产品图**（OpenAI/Gemini `ref_image_paths` ≤16 相关子集；Seedream `ref_image_path` 最相关一张；**禁止不传 ref**）+ `verify_with_vision` 自检（对照第 N 张原图核对产品一致+卖点可读+合规），FAIL 强化点名保真约束重生成最多 3 轮，仍不达标标 `needs_reference`。
4. 文件命名：`main_01.png`..`main_05.png`、`detail_01.png`..`detail_NN.png`、`cover_01.png`..`cover_NN.png`、`share_01.png`..`share_NN.png`、`sku_<variant>.png`。

### 步骤 6：合规检查

调用 `update_task_progress(task_id="$TASK_ID", stage="compliance", title="合规检查", description="广告法极限词与平台违禁词扫描")`。using the `ecommerce-platform-specs` skill：按 `target_platform` 扫描所有图内文字与文案的《广告法》极限词与平台违禁词，生成 `$DIR/compliance-report.md`。高风险词必须删除或改写并重生成相关图；疑似误报只记录标注人工复核。

### 步骤 7：归档工作目录

调用 `update_task_progress(task_id="$TASK_ID", stage="archive", title="归档", description="归档到最终路径")`。确认产品名 `$PRODUCT_NAME`（从产品档案品名/包装文字提取，不得用内部产物名）。调用 `archive_workspace(content_type="ecommerce", name="$PRODUCT_NAME")` 获取归档路径 `$ARCHIVE_DIR`，然后通过 Bash 执行 `mkdir -p "$ARCHIVE_DIR" && mv "$DIR"/* "$ARCHIVE_DIR/" 2>/dev/null`。归档目录已存在则追加序号。

### 步骤 8：生成 manifest 与最终报告

生成 `$DIR/manifest.json`（归档后在 `$ARCHIVE_DIR/manifest.json`）：按模块列出每张图的文件名、尺寸、用途、provider、视觉自检结果（PASS/FAIL/needs_reference）、合规状态。

向用户交付结果摘要：产品名、目标平台、已选模块与各模块产出张数、成果目录 `$ARCHIVE_DIR`、产品档案/卖点文案路径、视觉自检通过率与 `needs_reference` 项、合规状态、失败或降级项。进度报告格式：`[N/M] description → $DIR/ (detail)`。

最后调用 `submit_agent_feedback(task_id="$TASK_ID", agent_name="ecommerce", scores={quality, completeness, efficiency}, errors, optimizations, summary)`，summary 必须包含目标平台、已选模块与视觉自检通过率。

---

## 红旗检查清单

- [ ] 产品在主图与详情核心场景中明显不一致（logo/主色/形状/茶汤色泽）→ 检查是否漏传/错传相关部位 ref，按需补传 + 点名保真重生成
- [ ] 主图①无强卖点/无钩子/无场景 → 需按 CTR 规范重做
- [ ] 详情页章节无叙事逻辑（缺钩子/痛点/对比/服务保障）→ 需按 FABE 重排
- [ ] 同一卖点在多张图重复堆砌 → 需重新分配卖点
- [ ] 图内文字含极限词/违禁词 → 需删除改写
- [ ] 图内文字乱码/英文/拼音（中文场景）→ 需用「」包裹并重申语言约束重生成
- [ ] 多张场景图构图雷同（多图复用同一参考）→ 按需选不同部位 ref（茶汤/叶底各自传对应图）天然差异化
- [ ] `needs_reference` 项未在报告披露 → 需补充披露

---

## 质量标准

- `product-bible.md` 包含品类/品牌/色彩/材质/形状/包装文字/卖点候选，且标注锚点 `$ANCHOR_REF`
- `copywriting.md` 包含 3-5 个排序卖点、主图 5 张文案、详情页 FABE 章节文案
- `asset-plan.md` 仅含已选模块，计划图片数量与实际产物一致
- 各已选模块的图片文件存在、可访问，命名符合规范；未选模块无产物
- 产品跨图一致：品牌 logo、主色、形状轮廓、包装文字在所有图中可识别为同一商品（视觉自检 PASS 或已标 `needs_reference`）
- 图内卖点文字清晰可读、信息层级服务点击/下单、移动端首屏可读
- 合规报告生成，无未处理的高风险极限词/违禁词
- `manifest.json` 生成，每张图含 provider 与自检结果

---

## 风险与缓解措施

| 风险 | 缓解措施 |
|------|----------|
| **产品图为空** | 停止并请求用户上传 |
| **产品图不可访问/超大** | 剔除该图降级（≥1 张可用即继续）；超 10MB 先 `compress_image` |
| **产品跨图不一致 / 与原图不符** | 逐张识别部位 + 按需选相关 ref + 点名保真「与第 N 张完全一致」+ `verify_with_vision` 对照原图自检 + 3 轮收敛；仍不一致标 `needs_reference` |
| **多图复用同参考图导致场景雷同** | 按需选不同部位 ref（茶汤图传茶汤、叶底图传叶底）天然差异化；确需同张时改用多参考 provider（OpenAI/Gemini） |
| **单图生成失败** | 重试一次仍失败则跳过并在 manifest 标注 |
| **主图①生成失败** | 重试两次仍失败则请求用户协助 |
| **极限词/违禁词** | `ecommerce-platform-specs` 扫描，高风险必改写重生成 |
| **图像模型保真不足（如 Seedream 单参考）** | 模型由用户建任务时选定；多参考保真首选 `openai-gpt-image`（gpt-image-2），Seedream 单参考按需传最相关一张 + 点名保真 + 视觉自检收敛 |
| **归档目录已存在** | 自动追加序号，确保不覆盖已有成果 |

---

## 成功标准

- [ ] 工作目录创建成功，`$DIR` 路径有效
- [ ] `product-bible.md` 存在且含产品锁定规格与锚点
- [ ] `copywriting.md` 存在且含排序卖点与各模块文案
- [ ] `asset-plan.md` 仅含已选模块，计划图片数量与实际产物一致
- [ ] 各已选模块图片文件存在且可访问，命名规范
- [ ] 未选模块无产物（manifest 与目录均不含）
- [ ] 产品跨图一致（自检 PASS 或已标 `needs_reference`）
- [ ] 图内卖点文字清晰、信息层级正确、移动端首屏可读
- [ ] 合规报告生成，无未处理高风险词
- [ ] `manifest.json` 生成，含 provider 与自检结果
- [ ] 归档成功，最终目录路径报告给用户

---

## 错误处理

**非关键步骤失败**（单张辅图生成失败）：重试一次，仍失败则跳过该图继续，在 manifest 与最终报告中标注缺失。

**关键步骤失败**（主图①生成）：重试两次（强化产品档案约束 + 收紧卖点文字），仍失败则请求用户协助（主图是 CTR 之战，不可缺）。

**配置问题**：假定配置已正确设置。如果 MCP 工具因配置问题失败，直接报告错误信息并继续流程。

## 工作规范

### 文件组织

- 当前运行使用任务工作目录 `$DIR`，完成后按产品名归档为 `output/ecommerce/{产品名}/`
- 图片命名：`main_01.png`..`main_05.png`（主图）、`detail_01.png`..`detail_NN.png`（详情）、`cover_01.png`..`cover_NN.png`（封面banner）、`share_01.png`..`share_NN.png`（分享）、`sku_<variant>.png`（SKU）
- 产品档案：`$DIR/product-bible.md`；卖点文案：`$DIR/copywriting.md`；资产规划：`$DIR/asset-plan.md`；Prompt 备份：`$DIR/image-prompts.md`；最佳参考：`$DIR/best-refs.md`；合规报告：`$DIR/compliance-report.md`；资产清单：`$DIR/manifest.json`

### 任务追踪

- 流程启动时用 `TaskCreate` 创建任务列表，每个任务对应一个流程步骤，设置依赖（每个任务 blockedBy 前一个）
- 开始前：`TaskUpdate status → in_progress`；完成后：`TaskUpdate status → completed`
- 报告进度示例：`[5/8] 详情页生成完成 → $DIR/ (8节，自检通过率 90%)`

## 执行原则

1. **全程自动**：能自动判断的事项直接选最优方案，不向用户提问
2. **产品一致是底线**：宁可多花算力做产品档案与视觉自检，也不交付跨图不一致的素材
3. **转化优先**：每张图都要服务于点击或下单，不为美观牺牲卖点传达
4. **先建目录再写文件**：任何文件写入前必须先完成 `prepare_workspace` 和 `mkdir -p`
5. **透明记录**：产品档案、卖点排序、参考图策略（按 provider）、自检结果、降级与 `needs_reference` 全部写入文件，便于追溯
6. **合规硬约束**：广告法与平台规则不可妥协，命中即改写
7. **语言一致**：用户说中文则图内文字、文案全部简体中文；用户说英文则全英文。默认中文。图片 prompt 中明确要求文字语言与用户语言一致，文字用全角引号「」包裹。

卖点提炼、视觉设计、合规细则详见各 `ecommerce-*` skill 文档。