Product Image Generator

Three Dimensions

Style × Scene × Platform can be freely combined. Example: --style premium --scene lifestyle --platform amazon creates a high-end lifestyle shot meeting Amazon's image requirements.

Style Gallery

Detailed style definitions: references/presets/<style>.md

Scene Gallery

Detailed scene definitions: references/elements/scene-guide.md

Platform Requirements

Platform-specific guidelines: references/platforms/<platform>.md

Auto Selection

Outline Strategies

Strategy A: Product-Focused (产品聚焦型)

Strategy B: Lifestyle-Focused (场景融入型)

Strategy C: Information-Focused (信息传达型)

File Structure

Each session creates an independent directory named by product slug:

product-images/{product-slug}/
├── source-{slug}.{ext}             # Source files (description, reference images)
├── analysis.md                     # Product analysis + positioning
├── outline-strategy-a.md           # Strategy A: Product-focused
├── outline-strategy-b.md           # Strategy B: Lifestyle-focused
├── outline-strategy-c.md           # Strategy C: Information-focused
├── outline.md                      # Final selected/merged outline
├── prompts/
│   ├── 01-hero-[slug].md
│   ├── 02-detail-[slug].md
│   └── ...
├── 01-hero-[slug].png
├── 02-detail-[slug].png
└── NN-infographic-[slug].png

Slug Generation:

1. Extract product name (2-4 words, kebab-case)
2. Example: "无线蓝牙耳机" → wireless-earbuds

Conflict Resolution: If product-images/{product-slug}/ already exists:

• Append timestamp: {product-slug}-YYYYMMDD-HHMMSS

Workflow

Progress Checklist

Product Image Generation Progress:
- [ ] Step 0: Check preferences (EXTEND.md) ⛔ BLOCKING
- [ ] Step 1: Analyze product → analysis.md
- [ ] Step 2: Confirmation 1 - Product understanding ⚠️ REQUIRED
- [ ] Step 3: Generate 3 outline + style variants
- [ ] Step 4: Confirmation 2 - Outline & style & platform ⚠️ REQUIRED
- [ ] Step 5: Generate images (sequential)
- [ ] Step 6: Completion report

Flow

Input → [Step 0: Preferences] ─┬─ Found → Continue
                               │
                               └─ Not found → First-Time Setup ⛔ BLOCKING
                                              │
                                              └─ Complete setup → Save EXTEND.md → Continue
                                                                                      │
        ┌─────────────────────────────────────────────────────────────────────────────┘
        ↓
Analyze → [Confirm 1] → 3 Outlines → [Confirm 2: Outline + Style + Platform] → Generate → Complete

Step 0: Load Preferences (EXTEND.md) ⛔ BLOCKING

Purpose: Load user preferences or run first-time setup.

CRITICAL: If EXTEND.md not found, MUST complete first-time setup before ANY other steps.

Use Bash to check EXTEND.md existence:

# Check project-level first
test -f .teamclaw-skills/product-image-generator/EXTEND.md && echo "project"

# Then user-level
test -f "$HOME/.teamclaw-skills/product-image-generator/EXTEND.md" && echo "user"

First-Time Setup (when EXTEND.md not found):

Use AskUserQuestion with ALL questions in ONE call:

1. Default platform preference: amazon / shopify / ebay / etsy / taobao / jd / pinduoduo / no preference
2. Default style preference: minimal / premium / lifestyle / bold / soft / tech / natural / luxury
3. Watermark: Enable / Disable (if enable, specify text and position)
4. Language: Chinese / English / Auto-detect

Schema: references/config/preferences-schema.md

Step 1: Analyze Product → analysis.md

Actions:

1. Save source content:
   • If file path provided: use as-is
   • If pasted content: save to source.md
   • Backup rule: If exists, rename to source-backup-YYYYMMDD-HHMMSS.md
2. Read and analyze product information
3. Product analysis:
   • Category identification
   • Target audience
   • Key features and selling points
   • Competitive positioning
   • Visual opportunities
4. Detect product language
5. Determine recommended image count and types
6. Generate clarifying questions (see Step 2)
7. Save to analysis.md

Step 2: Confirmation 1 - Product Understanding ⚠️

Purpose: Validate understanding + collect missing info.

Display summary:

• Product category identified
• Key features extracted
• Target audience
• Recommended platform match

Use AskUserQuestion for:

1. Primary selling point (multiSelect: true):

   • Design/aesthetics
   • Functionality/features
   • Price/value
   • Quality/durability
   • Brand/status
   • Innovation/technology
   • Sustainability/eco-friendly
   • Convenience/ease of use

2. Target customer:

   • Budget-conscious
   • Quality-focused
   • Luxury/premium
   • Tech-savvy
   • Eco-conscious
   • Family-oriented
   • Professional/business
   • Youth/trend-focused

3. Main use scenario:

   • Indoor/home
   • Outdoor
   • Office/work
   • Travel
   • Sports/fitness
   • Social/events
   • Auto

4. Additional context (optional)

After response: Update analysis.md → Step 3

Step 3: Generate 3 Outline + Style Variants

Create three distinct strategy variants, each with outline structure and visual style recommendation.

Outline format (YAML front matter + content):

---