@optima-chat/optima-agent 0.4.9 → 0.4.11

package/.claude/settings.local.json

@@ -0,0 +1,46 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh api:*)",
+      "WebFetch(domain:platform.claude.com)",
+      "Bash(git init:*)",
+      "Bash(mkdir:*)",
+      "Bash(npm run typecheck:*)",
+      "Bash(npm view:*)",
+      "WebSearch",
+      "Bash(commerce --help)",
+      "Bash(done)",
+      "Bash(commerce product:*)",
+      "Bash(commerce order:*)",
+      "Bash(commerce i18n:*)",
+      "Bash(google-ads:*)",
+      "Bash(scout --help:*)",
+      "Bash(tree:*)",
+      "Bash(cloc:*)",
+      "Bash(npm run build:*)",
+      "Bash(git restore:*)",
+      "Bash(gh repo view:*)",
+      "Bash(mv:*)",
+      "Bash(rmdir:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push)",
+      "Bash(timeout 5 npm run optima:*)",
+      "Bash(npm install:*)",
+      "Bash(cat:*)",
+      "Bash(gh issue create:*)",
+      "Bash(npx tsx:*)",
+      "Bash(timeout 30 npx tsx:*)",
+      "Bash(git push origin feature/ask-user-question)",
+      "Bash(node:*)",
+      "Bash(npm version:*)",
+      "Bash(git push:*)",
+      "Bash(npm publish:*)",
+      "Bash(pkill:*)",
+      "Bash(git -C /Users/verypro/optima-agent log --oneline --all -- \".claude/\")",
+      "Bash(wc:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.claude/skills/comfy/SKILL.md

@@ -33,8 +33,8 @@ comfy image <prompt> [options]
 | 参数 | 说明 |
 |------|------|
 | `-i, --input <path>` | 输入图像（可多次使用，最多 8 张） |
-| `-w, --width <px>` | 输出宽度（默认 1024，必须是 16 的倍数） |
-| `-h, --height <px>` | 输出高度（默认 1024，必须是 16 的倍数） |
+| `-W, --width <px>` | 输出宽度（默认 1024，必须是 16 的倍数） |
+| `-H, --height <px>` | 输出高度（默认 1024，必须是 16 的倍数） |
 | `-o, --output <path>` | 输出目录或完整路径 |
 | `-s, --seed <number>` | 随机种子（可复现结果） |
 | `-f, --format <fmt>` | 输出格式：jpeg \| png |
@@ -83,7 +83,7 @@ comfy image "a modern logo with brand color #02eb3c as the primary accent" -o /U
 #### 产品海报
 
 ```bash
-comfy image "Disney Pixar style 3D poster, [产品描述], cute character, vibrant gradient background, professional studio lighting" -w 1024 -h 1024 -o /Users/john/project/poster.png
+comfy image "Disney Pixar style 3D poster, [产品描述], cute character, vibrant gradient background, professional studio lighting" -W 1024 -H 1024 -o /Users/john/project/poster.png
 ```
 
 ### 提示词指南（FLUX.2）

package/.claude/skills/product/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: product
-description: Product catalog management for e-commerce stores. Create and update products, manage variants/SKUs, upload product images, organize tags. Use when user needs to add new products, update pricing, manage product inventory, upload photos, or organize product catalog.
+description: Product catalog management for e-commerce stores. Create and update products, manage variants/SKUs, upload product images, organize tags, manage collections. Use when user needs to add new products, update pricing, manage product inventory, upload photos, organize product catalog, or manage product collections.
 ---
 
 # Commerce CLI - Product Management
 
-商品管理模块，用于电商商品目录的创建、编辑和组织。
+商品管理模块，用于电商商品目录的创建、编辑、组织和集合管理。
 
 ## 典型场景
 
@@ -73,6 +73,45 @@ commerce upload image --path ./new-photo.jpg  # 获得 media_new
 commerce product add-images --id prod_123 --media-id media_new
 ```
 
+### 场景6：创建商品集合
+
+**推荐集合类型**：
+- **时令集合** - 春夏秋冬、节日促销（如"Christmas Sale"）
+- **品类集合** - 按商品类型分组（如"T-Shirts", "Dresses"）
+- **主题集合** - 按场景分组（如"Office Wear", "Casual Style"）
+- **促销集合** - 新品、热卖、折扣（如"New Arrivals", "Best Sellers"）
+
+**创建流程**：
+```bash
+# 1. 创建集合
+commerce collection create \
+  --name "Summer Sale 2024" \
+  --slug "summer-sale-2024" \
+  --description "Hot deals for summer"
+
+# 2. 添加商品到集合
+commerce collection add-products \
+  --slug summer-sale-2024 \
+  --product-ids prod_123,prod_456,prod_789
+```
+
+### 场景7：设置集合封面图
+
+**三种方式**：
+
+```bash
+# 方式 1：使用 Media ID（推荐，可复用已上传图片）
+commerce upload image --path ./cover.jpg
+# 获取 media_id: media_456
+commerce collection set-cover --id coll-123 --media-id media_456
+
+# 方式 2：使用 URL
+commerce collection set-cover --id coll-123 --url "https://example.com/cover.jpg"
+
+# 方式 3：上传本地文件
+commerce collection set-cover --id coll-123 --path ./cover.jpg
+```
+
 ### 场景决策表
 
 | 用户需求 | 推荐命令 | 关键注意点 |
@@ -83,6 +122,8 @@ commerce product add-images --id prod_123 --media-id media_new
 | 更新价格 | `product update --price` | 如有变体，需逐个更新变体价格 |
 | 促销标签 | `product update --tags` | 用逗号分隔，保留原有标签 |
 | 图片更新 | `upload` + `add-images` | 先上传再关联，不要直接删除旧图 |
+| 创建促销集合 | `collection create --slug sale` | slug 简短有意义，添加10-30个商品 |
+| 设置集合封面 | `collection set-cover --id XX` | 支持 media-id/url/path 三种方式 |
 
 ## 卓越标准
 
@@ -178,6 +219,54 @@ commerce product update --id prod_123 --tags "featured,new,sale"
 commerce product create --title "T恤" --price 99 --stock 50  # 确保真实有50件
 ```
 
+### ❌ 问题6：集合命名随意，无规划
+
+**错误做法**：
+```bash
+# 命名不规范，slug 无意义
+commerce collection create --name "aaa" --slug "test123"
+commerce collection create --name "商品111" --slug "product-collection"
+```
+
+**正确做法**：
+```bash
+# 命名清晰，slug 符合 SEO 规范
+commerce collection create --name "Summer Sale 2024" --slug "summer-sale-2024"
+commerce collection create --name "Men's T-Shirts" --slug "mens-tshirts"
+```
+
+### ❌ 问题7：集合缺少商品
+
+**错误做法**：
+```bash
+# 创建集合后忘记添加商品
+commerce collection create --name "New Arrivals" --slug "new-arrivals"
+# 集合页面显示空白
+```
+
+**正确做法**：
+```bash
+# 创建集合后立即添加商品（至少5个）
+commerce collection create --name "New Arrivals" --slug "new-arrivals"
+commerce collection add-products --slug new-arrivals --product-ids prod_1,prod_2,prod_3,prod_4,prod_5
+```
+
+### ❌ 问题8：slug 使用中文或特殊字符
+
+**错误做法**：
+```bash
+# slug 包含中文或特殊字符，影响 SEO 和 URL 可读性
+commerce collection create --name "夏季促销" --slug "夏季促销"
+commerce collection create --name "Sale!!!" --slug "sale!!!"
+```
+
+**正确做法**：
+```bash
+# slug 使用英文、数字、连字符
+commerce collection create --name "夏季促销" --slug "summer-sale"
+commerce collection create --name "Sale!!!" --slug "sale"
+```
+
 ## 命令参考
 
 ### 自然语言映射
@@ -189,6 +278,11 @@ commerce product create --title "T恤" --price 99 --stock 50  # 确保真实有5
 - "更新商品价格" → `commerce product update --id XX --price YY`
 - "给商品打标签" → `commerce product update --id XX --tags "featured,new"`
 - "查看所有商品" → `commerce product list`
+- "创建商品集合" → `commerce collection create --name XX --slug YY`
+- "把商品添加到集合" → `commerce collection add-products --slug XX --product-ids YY`
+- "设置集合封面图" → `commerce collection set-cover --id XX --media-id YY`
+- "上传集合封面" → `commerce collection set-cover --id XX --path ./cover.jpg`
+- "集合封面图 URL 是 https://..." → `commerce collection set-cover --id XX --url "https://..."`
 
 ### 核心功能
 
@@ -210,6 +304,15 @@ commerce product create --title "T恤" --price 99 --stock 50  # 确保真实有5
 - `commerce product add-images` - 关联图片到商品
 - `commerce product remove-images` - 移除商品图片
 
+**商品集合**:
+- `commerce collection create` - 创建集合
+- `commerce collection list` - 查看集合列表
+- `commerce collection update` - 更新集合
+- `commerce collection delete` - 删除集合
+- `commerce collection add-products` - 添加商品到集合
+- `commerce collection remove-products` - 从集合移除商品
+- `commerce collection set-cover` - 设置集合封面图（支持 media-id/url/path）
+
 ## 详细示例
 
 ### 示例1：创建单个商品
@@ -295,13 +398,47 @@ commerce product add-images --id prod_123 --media-id media_red,media_blue
 commerce product get --id prod_123
 ```
 
+### 示例7：创建商品集合
+```bash
+# 用户说："创建夏季促销集合"
+commerce collection create \
+  --name "Summer Sale" \
+  --slug summer-sale \
+  --description "Hot deals for summer"
+```
+
+### 示例8：添加商品到集合
+```bash
+# 用户说："把商品prod_123和prod_456添加到summer-sale集合"
+commerce collection add-products \
+  --slug summer-sale \
+  --product-ids prod_123,prod_456
+```
+
+### 示例9：设置集合封面图
+```bash
+# 用户说："给集合设置封面图"
+
+# 方式 1：使用 Media ID（推荐）
+commerce upload image --path ./cover.jpg  # 获得 media_456
+commerce collection set-cover --id coll-123 --media-id media_456
+
+# 方式 2：使用 URL
+commerce collection set-cover --id coll-123 --url "https://example.com/cover.jpg"
+
+# 方式 3：上传本地文件
+commerce collection set-cover --id coll-123 --path ./cover.jpg
+```
+
 ## 重要提示
 
 - 所有命令默认 JSON 输出，便于 AI 解析
 - 图片需要先上传获取 `media_id`，再关联到商品
 - 变体的 `attributes` 使用 JSON 格式
 - 标签使用逗号分隔的字符串
-- 支持的图片格式：JPG, PNG, WebP
+- 支持的图片格式：JPG, PNG, WebP（最大 10MB）
 - 使用 `--help` 查看命令详细参数
 - 删除商品会同时删除所有变体和图片关联
 - 价格单位默认为美元（USD），可通过后台配置修改
+- 集合 slug 必须唯一，用于 URL，使用英文和连字符
+- 集合封面支持三种方式：`--media-id`（推荐）、`--url`、`--path`

package/.claude/skills/storefront/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: storefront
-description: "店铺前台配置管理。使用场景：配置首页(homepage/首页)、管理商品集合(collections/集合)、商品详情页区块(sections/区块)、调整模块顺序和布局。使用 commerce homepage/collection/section 命令。"
+description: "店铺前台配置管理。使用场景：配置首页(homepage/首页)、商品详情页区块(sections/区块)、调整模块顺序和布局。使用 commerce homepage/section 命令。"
 ---
 
 # Commerce CLI - Storefront Configuration
 
-店铺前台配置模块，用于首页设置、商品集合管理和商品详情页区块配置。
+店铺前台配置模块，用于首页设置和商品详情页区块配置。
 
 ## 典型场景
 
@@ -15,7 +15,6 @@ description: "店铺前台配置管理。使用场景：配置首页(homepage/
 |---------|---------|-----------|
 | 创建轮播图 | `commerce homepage module create --type banner` | 图片尺寸1920x600px，≤5张，配置跳转链接 |
 | 显示精选商品 | `commerce homepage module create --type featured` | 选择高转化商品，数量8-12个 |
-| 创建促销集合 | `commerce collection create --slug sale` | slug 简短有意义，添加10-30个商品 |
 | 调整模块顺序 | `commerce homepage module reorder --position X` | 重要模块靠前（轮播图position=1） |
 
 ### 场景 1：首页配置
@@ -53,29 +52,7 @@ commerce homepage module create \
   --config '{"images":[{"url":"https://example.com/banner1.jpg","link":"/collections/summer-sale"}]}'
 ```
 
-### 场景 3：创建商品集合
-
-**推荐集合类型**：
-- **时令集合** - 春夏秋冬、节日促销（如"Christmas Sale"）
-- **品类集合** - 按商品类型分组（如"T-Shirts", "Dresses"）
-- **主题集合** - 按场景分组（如"Office Wear", "Casual Style"）
-- **促销集合** - 新品、热卖、折扣（如"New Arrivals", "Best Sellers"）
-
-**创建流程**：
-```bash
-# 1. 创建集合
-commerce collection create \
-  --name "Summer Sale 2024" \
-  --slug "summer-sale-2024" \
-  --description "Hot deals for summer"
-
-# 2. 添加商品到集合
-commerce collection add-products \
-  --slug summer-sale-2024 \
-  --product-ids prod_123,prod_456,prod_789
-```
-
-### 场景 4：调整模块顺序
+### 场景 3：调整模块顺序
 
 **重新排序原则**：
 - 重要模块靠前（轮播图 position=1）
@@ -90,18 +67,16 @@ commerce homepage module reorder \
   --position 2
 ```
 
-### 场景 5：优化转化率
+### 场景 4：优化转化率
 
 **数据驱动优化**：
 - 分析首页点击热图，调整模块顺序
 - A/B测试不同轮播图和精选商品
-- 根据转化率隐藏低效集合
 - 精选商品选择高利润或高评分商品
 
 **性能优化建议**：
 - 轮播图：懒加载，压缩图片，支持WebP格式
 - 精选商品：限制8-12个，缓存1小时
-- 集合：按点击率排序，隐藏低转化集合
 
 
 ## 卓越标准
@@ -109,16 +84,16 @@ commerce homepage module reorder \
 ### 店铺配置质量指标
 - **页面加载速度**: 首页加载 < 3秒，移动端 < 5秒
 - **视觉设计**: 轮播图尺寸统一（1920x600px），图片清晰无水印
-- **导航体验**: 分类层级 ≤ 3层，集合数量 5-15个最佳
+- **导航体验**: 分类层级 ≤ 3层，模块数量适中
 - **内容更新频率**: 轮播图每周更新，精选商品每3天更新
-- **转化率**: 首页访客转化率 > 3%，集合页转化率 > 5%
+- **转化率**: 首页访客转化率 > 3%
 
 ### 店铺配置原则
 - **移动优先**: 所有配置考虑移动端体验，图片支持响应式
 - **性能优化**: 轮播图 ≤ 5张，精选商品 ≤ 12个，减少加载负担
-- **SEO友好**: 集合slug使用英文，标题包含关键词
+- **SEO友好**: 模块标题包含关键词
 - **一致性**: 风格统一（色彩、字体、间距），提升品牌辨识度
-- **数据驱动**: 根据点击率和转化率优化首页布局和集合内容
+- **数据驱动**: 根据点击率和转化率优化首页布局
 
 ### 首页配置检查清单
 
@@ -129,30 +104,11 @@ commerce homepage module reorder \
 - [ ] 加载速度 < 3秒
 - [ ] SEO信息完整（标题、描述、关键词）
 - [ ] 精选商品有库存
-- [ ] 集合至少包含5个商品
 - [ ] 首页模块顺序合理
 
 ## 常见问题
 
-### ❌ 问题 1：集合命名随意，无规划
-
-**错误做法**：
-```bash
-# 命名不规范，slug 无意义
-commerce collection create --name "aaa" --slug "test123"
-commerce collection create --name "商品111" --slug "product-collection"
-commerce collection create --name "Sale!!!" --slug "promotion"
-```
-
-**✅ 正确做法**：
-```bash
-# 命名清晰，slug 符合 SEO 规范
-commerce collection create --name "Summer Sale 2024" --slug "summer-sale-2024"
-commerce collection create --name "Men's T-Shirts" --slug "mens-tshirts"
-commerce collection create --name "New Arrivals" --slug "new-arrivals"
-```
-
-### ❌ 问题 2：轮播图过多影响性能
+### ❌ 问题 1：轮播图过多影响性能
 
 **错误做法**：
 ```bash
@@ -166,7 +122,7 @@ commerce homepage module create --type banner --config '{"images":[...10张图
 commerce homepage module create --type banner --config '{"images":[...3-5张图片...]}'
 ```
 
-### ❌ 问题 3：精选商品数量过多
+### ❌ 问题 2：精选商品数量过多
 
 **错误做法**：
 ```bash
@@ -180,23 +136,7 @@ commerce homepage settings update --featured-limit 30
 commerce homepage settings update --featured-limit 10
 ```
 
-### ❌ 问题 4：集合缺少商品
-
-**错误做法**：
-```bash
-# 创建集合后忘记添加商品
-commerce collection create --name "New Arrivals" --slug "new-arrivals"
-# 集合页面显示空白
-```
-
-**✅ 正确做法**：
-```bash
-# 创建集合后立即添加商品（至少5个）
-commerce collection create --name "New Arrivals" --slug "new-arrivals"
-commerce collection add-products --slug new-arrivals --product-ids prod_1,prod_2,prod_3,prod_4,prod_5
-```
-
-### ❌ 问题 5：首页模块顺序混乱
+### ❌ 问题 3：首页模块顺序混乱
 
 **错误做法**：
 ```bash
@@ -214,22 +154,6 @@ commerce homepage module create --type categories --position 2
 commerce homepage module create --type featured --position 3
 ```
 
-### ❌ 问题 6：slug 使用中文或特殊字符
-
-**错误做法**：
-```bash
-# slug 包含中文或特殊字符，影响 SEO 和 URL 可读性
-commerce collection create --name "夏季促销" --slug "夏季促销"
-commerce collection create --name "Sale!!!" --slug "sale!!!"
-```
-
-**✅ 正确做法**：
-```bash
-# slug 使用英文、数字、连字符
-commerce collection create --name "夏季促销" --slug "summer-sale"
-commerce collection create --name "Sale!!!" --slug "sale"
-```
-
 ## 命令参考
 
 ### 自然语言映射
@@ -237,8 +161,6 @@ commerce collection create --name "Sale!!!" --slug "sale"
 当用户说：
 - "创建首页轮播图" → `commerce homepage module create --type banner ...`
 - "更新首页设置" → `commerce homepage settings update --show-search true`
-- "创建商品集合" → `commerce collection create --name XX --slug YY`
-- "把商品添加到集合" → `commerce collection add-products --slug XX --product-ids YY`
 
 ### 核心功能
 
@@ -253,14 +175,6 @@ commerce collection create --name "Sale!!!" --slug "sale"
 - `commerce homepage settings get` - 查看首页设置
 - `commerce homepage settings update` - 更新首页设置
 
-**商品集合**:
-- `commerce collection create` - 创建集合
-- `commerce collection list` - 查看集合列表
-- `commerce collection update` - 更新集合
-- `commerce collection delete` - 删除集合
-- `commerce collection add-products` - 添加商品到集合
-- `commerce collection remove-products` - 从集合移除商品
-
 ## 详细示例
 
 ### 创建首页轮播图
@@ -282,24 +196,6 @@ commerce homepage settings update \
   --featured-limit 8
 ```
 
-### 创建商品集合
-```bash
-# 用户说："创建夏季促销集合"
-commerce collection create \
-  --name "Summer Sale" \
-  --slug summer-sale \
-  --description "Hot deals for summer"
-```
-
-### 添加商品到集合
-```bash
-# 用户说："把商品prod_123和prod_456添加到summer-sale集合"
-commerce collection add-products \
-  --slug summer-sale \
-  --product-ids prod_123,prod_456
-```
-
-
 ### 重新排序首页模块
 ```bash
 # 用户说："调整首页模块顺序"
@@ -340,7 +236,7 @@ commerce homepage settings update \
 commerce homepage module list
 ```
 
-## 场景 7：商品详情页区块管理
+## 场景 5：商品详情页区块管理
 
 ### 三层继承模型
 
@@ -515,10 +411,8 @@ commerce section list --resolved
 
 ### 首页配置
 - 首页模块支持类型：banner（轮播图）、featured（精选商品）、categories（分类）
-- 集合 slug 必须唯一，用于 URL
 - 模块的 position 决定显示顺序（从小到大）
 - config 字段使用 JSON 格式
-- 集合可以手动管理商品，也可以设置自动规则
 
 ### 商品页区块
 - 系统默认区块：highlights, details, guarantee, care, shipping-policies, return, eco-friendly