ecommerce-image-skills Skill 技能

技能简介

ecommerce-image-skills 是一套面向跨境电商卖家、独立站运营和小团队美工的 12 个 AI 出图 Agent Skill 合集，专为 Claude Code / Codex / Qwen-Code 等具备工具调用能力的 AI 编程 Agent 设计。开发者只需把手机随手拍的一张商品图丢给 Agent，再说一句自然语言指令（例如"做成亚马逊白底主图"、"出一整套 7 张图"、"换成小红书封面"），Agent 就会自动按平台规范完成从产品识别、提示词生成、生图调用、检查修复、批量编排到本地下载的全链路工作。

技能以"先锁定产品身份再出图"的思路，把"拍图+美工"这个原本极度依赖人工流程的工作拆解为 12 个可独立安装、互不依赖的 Skill，每个 Skill 内部都自带确定性的 Python 脚本做白底检查、占比修复、A+ 裁切、批量换背景等收尾动作，弥补了纯 Prompt 合集"图好看但产品被改了"的痛点。

核心能力

• 🔒 产品身份锁定：每个 Skill 首步先锁定商品的形状、颜色、Logo、文字，并把这些信息原样带进每一条提示词，确保多张输出图的主角始终如一，避免"越画越不像"。
• 📐 平台规范内置：Amazon 主图（#FFFFFF 纯白底、主体占比 ≥85%）、A+ 模块尺寸、淘宝 750 宽详情页、小红书 3:4 封面、TikTok Shop / Shopee 大促 Banner 比例等规则写死在 Skill 内，配合检查脚本自动修复不合规输出。
• 🧠 模型路由与切换：默认使用 Flare（gpt-image-2.5-flare）模型以快速出图与生成多版本候选；当遇到需要保留 Logo、标签、小字或需要局部编辑时，自动切到 Sunburst（gpt-image-2.5-sunburst）以保证文字与细节精度。
• 🛠 确定性脚本收尾：check_main_image.py 用于主图白底与覆盖率检查并自动修复、crop_a_plus.py 自动切 A+ 模块、stitch_listing.py 自动拼淘宝详情页、batch_background.py 支持断点续跑和预算上限的批量换背景 / SKU 换色。
• 🚦 三种出图通道：①Agent 自带生图工具（Codex imagegen 等）②设置 GPTIMAGE_API_KEY + 可选 GPTIMAGE_BASE_URL（推荐 tryallapi.com 或任何 OpenAI 兼容网关）调 scripts/generate.py ③没有 API Key 时直接输出最终提示词与 gptimage2.asia 在线运行链接，零门槛也能用。
• 📦 12 个 Skill 全覆盖：白底主图、生活场景图、卖点信息图、模特上身、A+ 模块、尺寸图、多角度套图、大促 Banner、批量换背景 / SKU 换色、小红书封面、淘宝 750 详情长图、一键规划整套图（ecommerce-listing-suite）。
• 🌐 跨平台兼容：同一份 Skill 资源可被 Claude Code、Codex、Cursor 三类 Agent 共用，分别安装到 ~/.claude/skills/、~/.codex/skills/、.cursor/skills/ 即可。

安装配置

• Claude Code（全局安装）：克隆仓库后执行 mkdir -p ~/.claude/skills && cp -r skills/* ~/.claude/skills/，重启 Claude Code 即可在所有项目中使用。
• Codex 安装：克隆仓库后执行 mkdir -p ~/.codex/skills && cp -r skills/* ~/.codex/skills/，打开 Codex 即可调用。
• Cursor 安装（项目级）：在项目目录执行 mkdir -p .cursor/skills && cp -r skills/* .cursor/skills/，即可被该项目的 Cursor Agent 加载。
• Skills CLI 一键安装：执行 npx skills add xianyu110/ecommerce-image-skills，或通过 Claude Code 的 /plugin marketplace add xianyu110/ecommerce-image-skills 方式安装。
• 可选 API Key 配置：在环境变量中设置 GPTIMAGE_API_KEY（必填）和 GPTIMAGE_BASE_URL（可选，默认 https://api.openai.com，国内推荐 https://tryallapi.com/v1），即可让 Agent 自动调用 Python 脚本完成批量出图。
• 单 Skill 安装：只需某个能力时，cp -r skills/amazon-white-background ~/.claude/skills/ 即可，每个 Skill 文件夹互不依赖，按需取用。

使用步骤

1. 拍一张商品照：用手机随手拍一张平铺或挂拍的产品图（无需布光、无需白底、无需抠图）。
2. 存到本地目录：例如放在 ./photos/bottle.jpg，告诉 Agent 路径与目标平台。
3. 下达自然语言指令：例如"用 amazon-white-background 把 ./photos/bottle.jpg 做成亚马逊白底主图，并跑检查脚本"，Agent 会自动加载 Skill、生成合规 Prompt、调用生图并修复。
4. 让 Agent 规划整套图：对 Agent 说"用 ecommerce-listing-suite 给这个水杯出一整套 Amazon 7 张图，先给我计划"，Agent 会先列出 7 张图的清单与提示词，经你确认再批量执行。
5. 批量任务：下达"把 ./photos 里 40 张图批量换成纯白背景，最多花 40 次调用"，Agent 会调用 batch_background.py 脚本做断点续跑，预算耗尽自动停止。
6. 多平台分发：同一个产品源图，可让 Agent 依次执行 amazon-white-background、xiaohongshu-cover、taobao-detail-750 三套 Skill，一份素材发多平台。
7. 无 Key 模式：若不想配 API Key，可让 Agent 输出最终提示词与 gptimage2.asia 预填链接，手动上传图也能一键出图。

适用场景

• Amazon / Shopee / TikTok Shop 跨境卖家：需要快速产出符合平台规范的主图、A+、大促 Banner。
• 独立站 Shopify / Etsy 店铺运营：需要把同一批产品图快速做成场景图、卖点图、模特上身图。
• 小红书 / 淘宝 / 拼多多国内电商：需要小红书 3:4 封面、淘宝 750 详情长图、多角度套图。
• 品牌方美工 + 运营协作：运营出文案，美工通过 Agent 批量产出候选图，再人工精修，提高出图效率 5-10 倍。
• 白牌 / 工厂型卖家：SKU 多、需要批量换背景 / 换色 / 换详情页模板的场景，batch_background.py 的批处理能力可直接落地。
• AI 出图学习者：作为"工程化 Skill 编排"的范例，学习如何把一个完整的电商出图流程拆成可被 Agent 调用的模块。

适用人群

• 跨境电商卖家与运营
• 独立站 / 平台店铺的视觉设计
• 工厂型白牌卖家的品控与运营
• 用 AI 编程 Agent（Claude Code / Codex / Cursor）做内容生产的设计师与运营
• 想把"美工+运营"流程 AI 化的技术团队

工作原理

整套 Skill 采用「Prompt + 确定性脚本 + 模型路由」三层结构：每个 Skill 的 SKILL.md 给 Agent 描述能力边界与调用顺序；执行层用 scripts/generate.py 等 Python 脚本做 OpenAI 兼容 API 调用、文件落盘与检查修复；模型层通过 GPTIMAGE_API_KEY + GPTIMAGE_BASE_URL 自动路由到 Flare（速度优先）与 Sunburst（精度优先）两套 GPT Image 模型。在流程上，所有出图都会先经过 check_main_image.py 等检查脚本对白底覆盖率、Logo 位置、文字渲染做合规校验，不通过则自动重试或修复，保证输出可直接商用。

官方链接

• GitHub 仓库：https://github.com/xianyu110/ecommerce-image-skills
• 在线体验（无 Key 也可用）：https://gptimage2.asia/ecommerce
• 推荐 API 网关（国内 OpenAI 兼容）：https://tryallapi.com/
• 安装方式：MIT 开源协议，可自由 fork 与二次开发