Intended forconversation: guide the user through information collection and deliver the kit results.
Step-by-step output (mandatory, merging the two steps is prohibited)
- In the same round of replies, only one collection step may be advanced: either ask only about selling points + style preference, or ask only about listing configuration,prohibitedfor both "core selling points/style preference" and "platform/country/language/ratio" to appear in the same message at the same time.
- Correct rhythm: first sendthe question about selling points + style preference→ stop, wait for the user's reply → after the user replies, then sendlisting configuration onlyexplanation → stop, wait for the user's reply → then proceed toviral style(prompt for selection or allow skipping) → stop, wait for the user's reply → then generate images / call the API.
- If the user proactively writes all of the selling points, style preference and configuration in one message, the parameters may be adopted all at once, butyour reply should still confirm them item by item。
- Fast track: if the user has already attached listing configuration information when confirming the selling points (e.g. "OK, Amazon US English 1:1"), it may be adopted directly, skipping the second round of configuration questions, confirming in one sentence and then going straight to style generation.
Workflow (in order)
- Product image: if there is no image, prompt to upload or provide a URL/path.
- Core selling points + style preference (round 1, occupying one message on its own): after obtaining the product image, based on the product imageautomatically generatea set of core selling point suggestions to show the user, and then:
- Ask: "You can adopt it directly, modify it, or enter your own selling point description"
- At the same time ask about style preference: "Do you have a particular visual style direction in mind? If not, I will recommend one intelligently for you"
- This message must not mention listing configuration information such as platform, country, language, ratio, etc.
- After the user confirms adoption, gives modification suggestions, or enters their own, use theversion finally confirmed by the useras the
product_info - style preference mentioned by the user, record it, and when showing the style options returned by the API, matching items may be recommended first
- Only when the AI cannot infer meaningful selling points from the image should it directly ask the user to enter them
- Listing configuration (round 2, occupying one message on its own): only after the user has replied about the selling points (or confirmed skipping), then sendonly configuration-relatedfriendly explanation (a short paragraph + brief list is fine, no need to interrogate item by item like a form):
- Platform: Amazon, Taobao, Temu, Pinduoduo, TikTok Shop...
- Country/Region: United States, China, Russia, Japan, Spain…
- Language: English, Chinese, Russian, Japanese, Spanish…
- Aspect ratio:1:1、3:4、9:16、16:9
Default: If the user does not specify, generate according to Amazon / United States / English / 1:1 . When asking,you must clearly inform them of this set of default values, so the user knows that replying directly with "use defaults" or "okay" will skip this step.
Parameter mapping: The user selects in Chinese; before calling the API, it must be converted to API parameter values:
| Platform | API value | Country | API value | Language | API value |
|------|--------|------|--------|------|--------|
| Amazon |
amazon| United States |US| English |English| | Taobao |taobao| China |CN| Chinese |Chinese| | Temu |temu| Russia |RU| Russian |Russian| | Pinduoduo |pinduoduo| Japan |JP| Japanese |Japanese| | TikTok Shop |tiktok_shop| Spain |ES| Spanish |Spanish| Rules: The usernot filling in, skipping, or filling in only partis all acceptable,do not repeatedly ask follow-up questions to complete the configuration; fill in missing values with the above defaults.Do not give another lengthy explanation of selling points in this message. Before executing the API call, useone sentenceto restate the actual configuration used (user-provided vs default). Fast track: If the user already included configuration information in the previous step, skip this step.
- Viral style (triggered as needed, not a mandatory step)
- Trigger condition: Only when the user in round 1 (selling points + style preference)explicitly specifies a specific style direction(such as "tech feel", "minimalist", "I want to see style options"), enter this step to display style options for the user to choose from.
- Skip by default: If the user does not mention style, replies "none", ignores the style question, or gives a vague reply (such as "as long as it looks good", "whatever", "your recommendation"), allskip this step and go directly to image generation, and the server will automatically match the style.
- When entering this step, call the style API and display the options:
bash __SKILL_DIR__/scripts/run_ecommerce_kit.sh style_create --input-json '<含 image、product_info、platform、market 等>'- Use the returned
task_idpolling:bash __SKILL_DIR__/scripts/run_ecommerce_kit.sh style_poll --input-json '{"task_id":"..."}'(can include as neededmax_wait_sec/interval_sec)
- Prohibitedto make up styles on your own; only display the options returned by the API. Ask the userto select one of them, and after selection you must usethe complete structure of that set returned by the API(such as the
brand_styleobject), and must not hand-write a replacement. - After the user sees the options and chooses "skip", "automatic", "you decide", etc.:
render_submitdo not passbrand_style, and the server will automatically match the style.
- Image generation + automatic download:
- Call
render_submit/render_pollto generate the finished image (withoutbrand_styleomit this field, the server automatically selects the style) render_submitratio parameter, priority is given to readingaspect_ratio, while also compatible withratio- During polling, based on the stderr output of
[PROGRESS]report progress information to the user (such as "completed 3/7 images") - After completionautomatically downloadall finished images to the working directory, naming rule:
{商品名}_{序号}_{label}.jpg(label is taken from theitems[].labelreturned by the API) - Display the results in Markdown image format, and inform the file save location
- Rerun with a different style: if the user wants to switch to another style after viewing the finished images, then call
style_createto get style options for the user to choose from, and after selection jump to therender_submitstep to regenerate the images.
- Call
Output directory rules
render_poll After completion, the generated results are automatically downloaded, and the output directory is resolved in the following priority order:
input-jsonexplicitly passed inoutput_dir- environment variable
DESIGNKIT_OUTPUT_DIR - when the current working directory contains
openclaw.yaml, use./output/ - if
{OPENCLAW_HOME}/workspace/visual(or~/.openclaw/workspace/visual) exists, use theoutput/designkit-ecommerce-product-kit/ - otherwise fall back to
~/Downloads/
Constraints:
- output directorymust not be located inside the current skill repository
- The script will automatically
mkdir -p render_pollthe JSON output will additionally includeoutput_dirandlocal_paths
Hard ordering constraints: product images → selling points + style preferences (one round) → user reply → listing configuration (one round, or skipped via fast track) → user reply → viral style (entered only when the user expresses interest in a style, otherwise skipped) → finished images + automatic download。