ecommerce-skills

一套面向电商视觉生产的 Agent 技能库：把「拍商品图」这件事拆成 19 个可组合的技能，每个技能是一份可直接执行的 skill.md，底层统一走命令行调用图像 / 文本模型。

平铺图 → 模特上身图 → 换模特换背景 → 裂变套图 → 详情页 → 投前检测，整条链路不用摄影棚、不约模特。

安装

技能用 npx skills 安装，它会扫描本仓库的 skills/ 目录，把技能装进 Claude Code / Codex / Cursor 等 agent 的技能目录。

一次装全部 19 个：

npx skills add https://github.com/dlazyai/ecommerce-skills --all

--all 等价于 --skill '*' --agent '*' -y：装全部技能、装到所有检测到的 agent、跳过确认。只想装给某一个 agent：

npx skills add https://github.com/dlazyai/ecommerce-skills --skill '*' --agent claude-code

只装用得上的几个（技能名就是下面索引表第一列，一个技能一个 --skill）：

npx skills add https://github.com/dlazyai/ecommerce-skills \
  --skill flat-lay --skill fission-pattern --skill detect-task

先看看有哪些：

npx skills add https://github.com/dlazyai/ecommerce-skills --list

默认装到当前项目（.claude/skills/<name>/），加 -g 装到用户级、所有项目共用。后续 npx skills update 更新、npx skills remove 卸载。

不想装也行：任何一份 skill.md 的内容直接贴进对话，Agent 照着执行即可。

技能索引

商品上身 — 让商品出现在人身上

单图变多图 — 一张图裂变成一屏

图片创作 — 从零造图

企业功能 — 规模化与质量把关

自定义功能 — 单点能力

典型链路

技能之间可以串起来用，输出直接作为下一步的输入。

新款上架（只有一张平铺图）

item-repair          精修平铺图（压平褶皱、匀光、纯净背景）
  └→ flat-lay        平铺图 → 模特上身商拍图
      ├→ fission-pattern    裂变成 5 张主图位
      ├→ clothing-detail    补 2~3 张工艺细节图
      ├→ item-detail        生成详情页各模块
      └→ detect-task        上架前逐张质检

一次拍摄覆盖多市场

one-shot             同一件衣服 → 国内/欧美/不同年龄段版本
  └→ detect-task     抽检

只有真人图，缺平铺素材

clothing-extraction  真人图/买家秀 → 干净平铺图
  └→ to-3d           平铺图 → 立体图（主图更有质感）
  └→ fabric-on-body  同版型试多种面料

内容种草铺量

flat-lay 或已有商拍图
  └→ clothing-grass-planting   一套穿搭 → 5 个生活场景版本
      └→ remove-watermark      清掉旧图上的文字/水印

整店改版（上百 SKU）

batch-image          清单驱动，整批统一视觉
  └→ detect-task     抽检 10~30%，高风险自动打回重跑
      └→ 取报告里的英文修正句 → 追加到原 prompt → 重跑

算力成本参考

每个技能都支持 --dry-run：只打印参数与算力估价、不真正生成。下表是各模型的实测估价（credits / 张）：

省钱的三条经验：

1. 先 --dry-run，确认单价 × 张数再跑。
2. 探索期用低档：banana-pro --imageSize 1K --batch 4 看方向，定稿再出 2K。
3. 批量场景 --batch 1：--batch N 会让成本乘 N；批量靠 SKU 数量，不靠 batch。

余额不足会返回 code: "insufficient_balance"，按技能文档「错误处理」一节的提示充值后重跑即可。

示例素材说明

docs/<skill-name>/ 下的输入素材用于演示，输出图全部为实际执行生成——不是效果图，命令原样写在各技能的「生成效果示例」一节里，可复现。

注意事项

• 生成结果需要人工鉴别。所有技能的输出都是模型推断，被遮挡区域、重建区域的内容不保证与实物一致；关键部位（图案位置、五金细节、尺码信息）上架前必须人工核对。
• 不做的事写在每个技能的「能力边界」里，包括：不编造商品不具备的功能、不生成虚假促销、不伪造他人肖像代言、不抹除商品缺陷。
• 合规：带文案的技能（item-detail、item-selling-point）注意绝对化用语与虚假促销；上架前建议过一遍 detect-task。

发布到 ClawHub（维护者）

发布脚本是 scripts/publish-skills.mjs，它会把 skills/<name>/skill.md 改写成 ClawHub 要的 SKILL.md（重命名、把 ../../docs/… 素材引用换成 GitHub 绝对地址、补版本号），在 .publish-tmp/ 里暂存后逐个发布，源文件不动。

npm install                # 装 clawhub CLI（devDependency）
npm run clawhub:login      # 首次发布前登录，token 存在本机
npm run publish:dry        # 只打印 slug / 版本 / 显示名，不发布
npm run publish:skills     # 正式发布（跳过 .publish-skills.done 里已发成功的）

追加参数用 -- 透传给脚本：

npm run publish:skills -- --only flat-lay,one-shot     # 只发指定技能
npm run publish:skills -- --ref main --keep-staging    # 指定素材 ref，保留暂存目录便于排查
npm run publish:skills -- --changelog "修正尺寸参数"    # 自定义 changelog

其它参数见脚本头部注释：--owner、--repo、--tags。

两个前置条件：

• 新增技能必须先在 scripts/skill-display-names.json 里补中文显示名，否则脚本直接报错退出；
• docs/ 和 skills/ 的改动要先 push——线上素材地址指向 <owner>/<repo>@<ref>，没推上去线上就是碎图；有未提交改动时脚本会 WARN。

License

见 LICENSE。