product-image-generator

Generates professional product images for e-commerce platforms (Amazon, Shopify, eBay, etc.). Supports 8 visual styles and 6 scene types optimized for different product categories. Use when user mentions "商品图", "product images", "Amazon listing", "电商图片", or needs e-commerce product photography.

# E-commerce Product Image Generator

Create professional product images optimized for e-commerce platforms with platform-specific requirements and multiple visual styles.

## Usage

```bash
# Auto-select style based on product
/product-image-generator product-description.md

# Specify style
/product-image-generator product.md --style minimal

# Specify platform (auto-adjusts image requirements)
/product-image-generator product.md --platform amazon

# Specify scene type
/product-image-generator product.md --scene studio

# Combine options
/product-image-generator product.md --style premium --platform shopify --scene lifestyle

# Direct input
/product-image-generator
[paste product description]

# Direct input with options
/product-image-generator --style minimal --scene studio
[paste product description]

# With reference image (for style consistency)
/product-image-generator product.md --ref brand-style.png

# Multiple reference images
/product-image-generator product.md --ref style.png --ref competitor.jpg
```

## Options

| Option | Description |
|--------|-------------|
| `--style <name>` | Visual style (see Style Gallery) |
| `--scene <type>` | Scene type (see Scene Gallery) |
| `--platform <name>` | E-commerce platform (auto-adjusts requirements) |
| `--ref <path>` | Reference image(s) for style consistency |

## Three Dimensions

| Dimension | Controls | Options |
|-----------|----------|---------|
| **Style** | Visual aesthetics: mood, color treatment | minimal, premium, lifestyle, bold, soft, tech, natural, luxury |
| **Scene** | Background and context | studio, lifestyle, contextual, exploded, comparison, infographic |
| **Platform** | Technical requirements | amazon, shopify, ebay, etsy, taobao, jd, pinduoduo |

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

| Style | Description | Best For |
|-------|-------------|----------|
| `minimal` (Default) | Clean, white background, focus on product | Electronics, accessories, professional products |
| `premium` | Sophisticated, elegant lighting, subtle shadows | Luxury goods, jewelry, high-end cosmetics |
| `lifestyle` | Product in natural use context | Home goods, fashion, outdoor products |
| `bold` | High contrast, vibrant, attention-grabbing | Sports products, gaming, youth-oriented items |
| `soft` | Gentle lighting, pastel tones, warm | Baby products, skincare, wellness items |
| `tech` | Futuristic, sleek, modern | Electronics, gadgets, software, AI products |
| `natural` | Organic, eco-friendly, earthy tones | Sustainable products, food, natural cosmetics |
| `luxury` | Gold accents, dramatic lighting, rich colors | Premium brands, jewelry, high-end fashion |

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

## Scene Gallery

| Scene | Description | Image Count |
|-------|-------------|-------------|
| `studio` (Default) | Pure white/gradient background, professional studio lighting | 1-3 images |
| `lifestyle` | Product in real-life usage scenario | 2-5 images |
| `contextual` | Product in environment, staged setting | 2-4 images |
| `exploded` | Component breakdown, features highlighted | 3-6 images |
| `comparison` | Before/after, product vs alternatives | 2-4 images |
| `infographic` | Features, specs, benefits with text overlays | 2-5 images |

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

## Platform Requirements

| Platform | Main Image | Additional Images | Notes |
|----------|------------|-------------------|-------|
| `amazon` | 1000x1000+, pure white | Up to 9 images | Main image must be on pure white background |
| `shopify` | 1024x1024+ recommended | Unlimited | Flexible, but 1:1 or 4:3 recommended |
| `ebay` | 500x500+ minimum | Up to 12 free | White background preferred |
| `etsy` | 760x760+ | Up to 10 images | Lifestyle shots perform well |
| `taobao` | 800x800+ | Up to 15 images | Infographic style popular |
| `jd` | 800x800+ | Up to 15 images | Clean, professional style |
| `pinduoduo` | 750x750+ | Up to 10 images | Value-focused presentation |

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

## Auto Selection

| Product Category | Style | Scene |
|------------------|-------|-------|
| Electronics, gadgets | `tech` or `minimal` | studio + exploded |
| Fashion, accessories | `premium` or `lifestyle` | lifestyle + contextual |
| Beauty, cosmetics | `soft` or `premium` | studio + lifestyle |
| Home, furniture | `lifestyle` or `natural` | contextual + lifestyle |
| Sports, outdoor | `bold` or `lifestyle` | lifestyle + contextual |
| Jewelry, luxury | `luxury` or `premium` | studio + lifestyle |
| Baby, kids | `soft` or `natural` | lifestyle + contextual |
| Food, supplements | `natural` or `minimal` | studio + infographic |
| Tools, hardware | `bold` or `tech` | exploded + infographic |

## Outline Strategies

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

| Aspect | Description |
|--------|-------------|
| **Concept** | Product as hero, clean presentation |
| **Features** | Multiple angles, detail shots, pure backgrounds |
| **Best for** | Electronics, accessories, luxury items |
| **Structure** | Hero shot → Angle variations → Detail close-ups → Scale/context |

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

| Aspect | Description |
|--------|-------------|
| **Concept** | Product in natural use environment |
| **Features** | Context-rich, emotional connection, aspirational |
| **Best for** | Home goods, fashion, outdoor products |
| **Structure** | Lifestyle hero → Usage scenario → Benefits in context → Social proof |

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

| Aspect | Description |
|--------|-------------|
| **Concept** | Features and benefits clearly communicated |
| **Features** | Text overlays, callouts, comparisons |
| **Best for** | Complex products, tools, supplements |
| **Structure** | Hero with key benefit → Feature breakdown → Comparison → Specs/usage |

## 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: Outl