designkit-ecommerce-product-kit

Installation
SKILL.md

DesignKit Ecommerce Product Kit — 电商商品套图

面向对话:引导用户完成信息收集并交付套图结果。

分步输出(强制,禁止两步合并)

  • 同一轮回复里,只能推进一个收集步骤:要么只问卖点+风格偏好,要么只问上架配置,禁止在同一条消息里同时出现「核心卖点/风格偏好」与「平台/国家/语言/比例」两类内容。
  • 正确节奏:先发卖点+风格偏好的提问 → 停止,等用户回复 → 用户回复后,再发仅含上架配置的说明 → 停止,等用户回复 → 再进入爆款风格(提示选择或可跳过)→ 停止,等用户回复 → 再成图 / 调接口。
  • 若用户主动在一条消息里把卖点、风格偏好和配置都写全了,可一次性采纳参数,但你的回复仍应分条确认
  • 快速通道:如果用户在确认卖点时已附带上架配置信息(如"可以,亚马逊美国英文1:1"),可直接采纳,跳过第 2 轮配置询问,用一句话确认后直接进入风格生成。

流程(按顺序)

  1. 商品图:没有图则提示上传或提供 URL/路径。
  2. 核心卖点 + 风格偏好(第 1 轮,独占一条消息):拿到商品图后,根据商品图自动生成一段核心卖点建议展示给用户,然后:
    • 询问:「您可以直接采用、修改,或输入自己的卖点描述」
    • 同时询问风格偏好:「您有特别想要的视觉风格方向吗?没有的话我会为您智能推荐」
    • 本条消息不要提平台、国家、语言、比例等上架配置信息
    • 用户确认采用、给出修改意见或自行输入后,以用户最终确认的版本作为 product_info
    • 用户提到的风格偏好记录下来,在展示接口返回的风格方案时可优先推荐匹配项
    • 仅当 AI 无法从图片推断出有意义的卖点时,才直接请用户自行输入
  3. 上架配置(第 2 轮,独占一条消息):仅在用户已回复卖点(或确认跳过)之后,再发只有配置相关的友好说明(可用一小段 + 简要列表,不必像表单逐项逼问):
    • 平台:亚马逊、淘宝、Temu、拼多多、TikTok Shop…
    • 国家/地区:美国、中国、俄罗斯、日本、西班牙…
    • 语言:英语、中文、俄语、日语、西班牙语…
    • 尺寸比例:1:1、3:4、9:16、16:9 默认值:如果用户不指定,按 亚马逊 / 美国 / 英语 / 1:1 生成。询问时必须明确告知这组默认值,让用户知道直接回复「用默认」或「可以」即可跳过本步。 参数映射:用户使用中文选择,调用接口前须转换为 API 参数值: | 平台 | API 值 | 国家 | API 值 | 语言 | API 值 | |------|--------|------|--------|------|--------| | 亚马逊 | amazon | 美国 | US | 英语 | English | | 淘宝 | taobao | 中国 | CN | 中文 | Chinese | | Temu | temu | 俄罗斯 | RU | 俄语 | Russian | | 拼多多 | pinduoduo | 日本 | JP | 日语 | Japanese | | TikTok Shop | tiktok_shop | 西班牙 | ES | 西班牙语 | Spanish | 规则:用户不填、跳过或只填部分均可,不要为补全配置反复追问;缺省用上述默认值补齐。本条消息不要再次长篇解释卖点。执行调接口前用一句话复述实际采用的配置(用户给的 vs 默认)。 快速通道:若用户在上一步已附带配置信息,此步跳过。
  4. 爆款风格(按需触发,非必经步骤)
    • 触发条件:仅当用户在第 1 轮(卖点+风格偏好)中明确指定了具体风格方向(如"科技感""简约""我想看看风格方案")时,才进入本步展示风格方案供用户挑选。
    • 默认跳过:若用户未提及风格、回复"没有"、忽略风格问题,或给出模糊回复(如"好看就行""随便""按你推荐"),均跳过本步,直接进入成图,由服务端自动匹配风格。
    • 进入本步时,调用风格接口并展示方案:
      1. bash __SKILL_DIR__/scripts/run_ecommerce_kit.sh style_create --input-json '<含 image、product_info、platform、market 等>'
      2. 用返回的 task_id 轮询:bash __SKILL_DIR__/scripts/run_ecommerce_kit.sh style_poll --input-json '{"task_id":"..."}'(可按需带 max_wait_sec / interval_sec
    • 禁止自行编造风格,只展示接口返回的方案。请用户选定其中一套,选定后须使用接口返回的该套完整结构(如 brand_style 对象),不得手写替换。
    • 用户看到方案后选择「跳过」「自动」「你定」等:render_submit 不传 brand_style,由服务端自动匹配风格。
  5. 成图 + 自动下载
    • 调用 render_submit / render_poll 生成成品图(无 brand_style 时省略该字段,服务端自动选择风格)
    • render_submit 的比例参数优先读取 aspect_ratio,同时兼容 ratio
    • 轮询期间根据 stderr 输出的 [PROGRESS] 信息向用户报告进度(如"已完成 3/7 张")
    • 完成后自动下载所有成品图到工作目录,命名规则:{商品名}_{序号}_{label}.jpg(label 从接口返回的 items[].label 取)
    • 以 Markdown 图片格式展示结果,并告知文件保存位置
    • 换风格重跑:如果用户看完成图后想换另一套风格,此时再调用 style_create 获取风格方案供用户选择,选定后跳到 render_submit 步骤重新出图。

输出目录规则

render_poll 完成后会自动下载生成结果,输出目录按以下优先级解析:

  1. input-json 中显式传入的 output_dir
  2. 环境变量 DESIGNKIT_OUTPUT_DIR
  3. 当前工作目录存在 openclaw.yaml 时,使用 ./output/
  4. {OPENCLAW_HOME}/workspace/visual(或 ~/.openclaw/workspace/visual)存在,使用其下的 output/designkit-ecommerce-product-kit/
  5. 否则回退到 ~/Downloads/

约束:

  • 输出目录不能位于当前 skill 仓库内部
  • 脚本会自动 mkdir -p
  • render_poll 的 JSON 输出会额外包含 output_dirlocal_paths

顺序硬约束:商品图 → 卖点+风格偏好(一轮)用户回复上架配置(一轮,或快速通道跳过)用户回复爆款风格(仅用户表达了风格兴趣时才进入,否则跳过)成图+自动下载

Related skills

More from meitu/designkit-skills

Installs
2
GitHub Stars
12
First Seen
Mar 25, 2026