@optima-chat/optima-agent 0.9.11 → 0.9.12

package/.claude/skills/taobao/SKILL.md

@@ -1,238 +1,238 @@
----
-name: taobao
-description: "淘宝/天猫商品搜索和选品调研。当用户需要搜索淘宝商品（淘宝搜索/搜淘宝/天猫搜索）、查看淘宝商品详情（淘宝商品/天猫商品/商品详情）、查看商品评论（淘宝评论/买家评价/用户评价）、分析淘宝商品（商品分析/选品/国内电商）、或做淘宝市场调研（淘宝市场/天猫市场/国内市场）时使用此技能。"
----
-
-# 淘宝/天猫 - 商品搜索与选品调研
-
-所有命令使用 `scout taobao` 前缀。数据源：JustOneAPI（¥0.15/次）。
-
----
-
-## 快速选择：我该用哪个命令？
-
-| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
-|---------|---------|---------|---------|
-| **搜索商品** | `search "关键词"` | — | 按关键词搜索淘宝/天猫 |
-| **了解某个商品** | `detail <itemId>` | `comments` | 详情→评论 |
-| **商品完整分析** | `insights <itemId>` | — | 一键获取详情+评论 |
-| **只看评论** | `comments <itemId>` | — | 买家评价分析 |
-| **找天猫商品** | `search "关键词" --tmall` | — | 只搜天猫 |
-| **按价格筛选** | `search "关键词" --min-price 100 --max-price 500` | — | 价格区间 |
-
----
-
-## 典型场景
-
-当用户说：
-- "淘宝上搜一下咖啡机" / "天猫有什么咖啡机" → `scout taobao search "咖啡机"`
-- "只看天猫的" → `scout taobao search "咖啡机" --tmall`
-- "100-500 元的" → `scout taobao search "咖啡机" --min-price 100 --max-price 500`
-- "按销量排序" → `scout taobao search "咖啡机" --sort sales`
-- "看看这个商品" + itemId → `scout taobao detail <itemId>`
-- "这个商品评价怎么样" → `scout taobao comments <itemId>`
-- "帮我分析这个商品" → `scout taobao insights <itemId>`
-- "淘宝上这个品类什么好卖" → 先搜索，再逐个分析 top 商品
-
----
-
-## URL 解析 - 淘宝/天猫链接处理
-
-用户可能直接贴商品链接，按以下规则提取 itemId：
-
-| URL 特征 | 提取内容 | 调用命令 |
-|----------|---------|---------|
-| `item.taobao.com/item.htm?id=数字` | itemId (数字) | `scout taobao detail <itemId>` |
-| `detail.tmall.com/item.htm?id=数字` | itemId (数字) | `scout taobao detail <itemId>` |
-| `m.tb.cn/短链接` | 需要解析 | 提示用户提供商品 ID |
-
-**示例**：
-```bash
-# 淘宝链接 → 提取 id 参数
-# https://item.taobao.com/item.htm?id=713865529993
-scout taobao detail 713865529993
-
-# 天猫链接 → 同样提取 id
-# https://detail.tmall.com/item.htm?id=668479757611
-scout taobao detail 668479757611
-```
-
----
-
-## 核心命令
-
-### 🔍 搜索商品 - `scout taobao search`
-
-按关键词搜索淘宝/天猫商品。
-
-```bash
-scout taobao search "咖啡机"
-scout taobao search "蓝牙耳机" --sort sales
-scout taobao search "瑜伽垫" --tmall --min-price 50 --max-price 200
-scout taobao search "手机壳" --page 2
-```
-
-**参数**：
-- `<keyword>`：搜索关键词（必填）
-- `-p, --page`：页码（默认 1，每页 10 条）
-- `-s, --sort`：排序 `sales|price_asc|price_desc`（不传为默认综合排序）
-- `--tmall`：仅天猫商品
-- `--min-price`：最低价（元）
-- `--max-price`：最高价（元）
-- `-f, --format`：输出格式 `json|text`（默认: json）
-
-**返回数据**：
-- `data[]`：商品列表（name、price、originalPrice、sales、shopName、location、sellerRating、itemType）
-- `brands[]`：品牌筛选列表（brandName、count）
-- `meta`：分页信息
-
-**搜索返回的关键指标**：
-- `price` / `originalPrice` — 折后价/原价（元）
-- `sales` — 付款人数（如 "1000+"）
-- `sellerRating` — 好评率（百分比）
-- `itemType` — taobao 或 tmall
-- `stock` — 库存数量
-
-### 📦 商品详情 - `scout taobao detail`
-
-获取商品的详细信息。
-
-```bash
-scout taobao detail 713865529993
-```
-
-**参数**：
-- `<itemId>`：商品 ID（必填，纯数字）
-- `-f, --format`：输出格式 `json|text`（默认: json）
-
-**返回数据**：`title`、`images`、`url`、`seller`（店铺信息）、`delivery`（发货信息）
-
-### 💬 商品评论 - `scout taobao comments`
-
-获取商品的买家评价。
-
-```bash
-scout taobao comments 713865529993
-scout taobao comments 713865529993 --page 2
-```
-
-**参数**：
-- `<itemId>`：商品 ID（必填）
-- `-p, --page`：页码（默认 1，每页 20 条）
-- `-f, --format`：输出格式 `json|text`（默认: json）
-
-**返回数据**：
-- `total` — 评论总数
-- `maxPage` — 最大页数
-- `comments[]` — 评论列表：`content`（内容）、`score`（评分 1-5）、`date`、`photos`（晒图）、`reply`（卖家回复）、`append`（追评）
-
-**分析重点**：
-1. 好评中的高频关键词 = 产品卖点
-2. 差评中的问题 = 产品痛点/改进方向
-3. 带图评论 = 真实使用场景
-4. 追评内容 = 长期使用体验
-
-### 🔬 商品洞察 - `scout taobao insights`
-
-一键获取商品详情 + 评论（组合查询）。
-
-```bash
-scout taobao insights 713865529993
-```
-
-**参数**：
-- `<itemId>`：商品 ID（必填）
-- `-f, --format`：输出格式 `json|text`（默认: json）
-
-**返回数据**：`detail`（商品详情）+ `comments`（第一页评论）
-
----
-
-## 典型工作流
-
-### 淘宝选品调研
-
-```bash
-# 1. 搜索目标品类
-scout taobao search "便携榨汁机" --sort sales
-
-# 2. 分析 TOP 商品
-scout taobao insights <itemId>
-
-# 3. 对比多个商品的评论
-scout taobao comments <itemId1>
-scout taobao comments <itemId2>
-
-# 4. 跨平台比较
-scout search "portable blender" --limit 10     # Amazon 同品类
-scout supplier-search "便携式榨汁机"             # 1688 供应商
-```
-
-### 竞品分析
-
-```bash
-# 1. 搜索竞品关键词
-scout taobao search "竞品品牌名" --tmall
-
-# 2. 看竞品 TOP 商品详情
-scout taobao detail <竞品itemId>
-
-# 3. 分析竞品评论（找差异化机会）
-scout taobao comments <竞品itemId>
-```
-
-### 跨平台选品联动
-
-```bash
-# 1. Reddit/Twitter 发现趋势
-scout reddit trends "产品关键词"
-scout twitter trends "产品关键词"
-
-# 2. 淘宝验证国内市场
-scout taobao search "产品关键词" --sort sales
-
-# 3. Amazon 验证海外市场
-scout search "product keyword" --limit 10
-
-# 4. 找供应商
-scout supplier-search "产品中文名"
-```
-
----
-
-## 数据解读参考
-
-### 商品表现判断
-
-| 指标 | 爆款 | 热销 | 一般 |
-|------|------|------|------|
-| 付款人数 | 10000+ | 1000-10000 | <1000 |
-| 好评率 | >98% | 95-98% | <95% |
-| 评论数 | >5000 | 1000-5000 | <1000 |
-
-### 价格区间分析
-
-搜索时注意对比：
-- `price`（折后价）vs `originalPrice`（原价）→ 折扣力度
-- 同品类不同价格带的销量分布 → 主力价格带
-- 天猫 vs 淘宝同款价差 → 品牌溢价空间
-
-### 选品信号
-
-| 淘宝信号 | 含义 | 下一步 |
-|----------|------|--------|
-| 销量高+评论多+好评率高 | 成熟爆款 | 找差异化切入点 |
-| 销量增长快+评论少 | 新兴爆款 | 快速跟进窗口 |
-| 品类搜索多+好商品少 | 供给不足 | 产品机会 |
-| 差评集中某问题 | 痛点明确 | 改进型产品机会 |
-| 天猫占比高 | 品牌化品类 | 需要品牌背书 |
-
----
-
-## 重要提醒
-
-1. **itemId 纯数字**：从商品 URL 中提取 `id=` 后面的数字
-2. **每页数量**：搜索 10 条/页，评论 20 条/页
-3. **评分映射**：API 返回 1=好评/0=中差评，已映射为 5/1 星
-4. **sort 不传为默认排序**：不要传 `default`，直接省略 `--sort` 参数
-5. **跨 Skill 联动**：淘宝验证国内市场 → Amazon 验证海外 → 1688 找供应商 → Reddit/Twitter 看社媒趋势
+---
+name: taobao
+description: "淘宝/天猫商品搜索和选品调研。当用户需要搜索淘宝商品（淘宝搜索/搜淘宝/天猫搜索）、查看淘宝商品详情（淘宝商品/天猫商品/商品详情）、查看商品评论（淘宝评论/买家评价/用户评价）、分析淘宝商品（商品分析/选品/国内电商）、或做淘宝市场调研（淘宝市场/天猫市场/国内市场）时使用此技能。"
+---
+
+# 淘宝/天猫 - 商品搜索与选品调研
+
+所有命令使用 `scout taobao` 前缀。数据源：JustOneAPI（¥0.15/次）。
+
+---
+
+## 快速选择：我该用哪个命令？
+
+| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
+|---------|---------|---------|---------|
+| **搜索商品** | `search "关键词"` | — | 按关键词搜索淘宝/天猫 |
+| **了解某个商品** | `detail <itemId>` | `comments` | 详情→评论 |
+| **商品完整分析** | `insights <itemId>` | — | 一键获取详情+评论 |
+| **只看评论** | `comments <itemId>` | — | 买家评价分析 |
+| **找天猫商品** | `search "关键词" --tmall` | — | 只搜天猫 |
+| **按价格筛选** | `search "关键词" --min-price 100 --max-price 500` | — | 价格区间 |
+
+---
+
+## 典型场景
+
+当用户说：
+- "淘宝上搜一下咖啡机" / "天猫有什么咖啡机" → `scout taobao search "咖啡机"`
+- "只看天猫的" → `scout taobao search "咖啡机" --tmall`
+- "100-500 元的" → `scout taobao search "咖啡机" --min-price 100 --max-price 500`
+- "按销量排序" → `scout taobao search "咖啡机" --sort sales`
+- "看看这个商品" + itemId → `scout taobao detail <itemId>`
+- "这个商品评价怎么样" → `scout taobao comments <itemId>`
+- "帮我分析这个商品" → `scout taobao insights <itemId>`
+- "淘宝上这个品类什么好卖" → 先搜索，再逐个分析 top 商品
+
+---
+
+## URL 解析 - 淘宝/天猫链接处理
+
+用户可能直接贴商品链接，按以下规则提取 itemId：
+
+| URL 特征 | 提取内容 | 调用命令 |
+|----------|---------|---------|
+| `item.taobao.com/item.htm?id=数字` | itemId (数字) | `scout taobao detail <itemId>` |
+| `detail.tmall.com/item.htm?id=数字` | itemId (数字) | `scout taobao detail <itemId>` |
+| `m.tb.cn/短链接` | 需要解析 | 提示用户提供商品 ID |
+
+**示例**：
+```bash
+# 淘宝链接 → 提取 id 参数
+# https://item.taobao.com/item.htm?id=713865529993
+scout taobao detail 713865529993
+
+# 天猫链接 → 同样提取 id
+# https://detail.tmall.com/item.htm?id=668479757611
+scout taobao detail 668479757611
+```
+
+---
+
+## 核心命令
+
+### 🔍 搜索商品 - `scout taobao search`
+
+按关键词搜索淘宝/天猫商品。
+
+```bash
+scout taobao search "咖啡机"
+scout taobao search "蓝牙耳机" --sort sales
+scout taobao search "瑜伽垫" --tmall --min-price 50 --max-price 200
+scout taobao search "手机壳" --page 2
+```
+
+**参数**：
+- `<keyword>`：搜索关键词（必填）
+- `-p, --page`：页码（默认 1，每页 10 条）
+- `-s, --sort`：排序 `sales|price_asc|price_desc`（不传为默认综合排序）
+- `--tmall`：仅天猫商品
+- `--min-price`：最低价（元）
+- `--max-price`：最高价（元）
+- `-f, --format`：输出格式 `json|text`（默认: json）
+
+**返回数据**：
+- `data[]`：商品列表（name、price、originalPrice、sales、shopName、location、sellerRating、itemType）
+- `brands[]`：品牌筛选列表（brandName、count）
+- `meta`：分页信息
+
+**搜索返回的关键指标**：
+- `price` / `originalPrice` — 折后价/原价（元）
+- `sales` — 付款人数（如 "1000+"）
+- `sellerRating` — 好评率（百分比）
+- `itemType` — taobao 或 tmall
+- `stock` — 库存数量
+
+### 📦 商品详情 - `scout taobao detail`
+
+获取商品的详细信息。
+
+```bash
+scout taobao detail 713865529993
+```
+
+**参数**：
+- `<itemId>`：商品 ID（必填，纯数字）
+- `-f, --format`：输出格式 `json|text`（默认: json）
+
+**返回数据**：`title`、`images`、`url`、`seller`（店铺信息）、`delivery`（发货信息）
+
+### 💬 商品评论 - `scout taobao comments`
+
+获取商品的买家评价。
+
+```bash
+scout taobao comments 713865529993
+scout taobao comments 713865529993 --page 2
+```
+
+**参数**：
+- `<itemId>`：商品 ID（必填）
+- `-p, --page`：页码（默认 1，每页 20 条）
+- `-f, --format`：输出格式 `json|text`（默认: json）
+
+**返回数据**：
+- `total` — 评论总数
+- `maxPage` — 最大页数
+- `comments[]` — 评论列表：`content`（内容）、`score`（评分 1-5）、`date`、`photos`（晒图）、`reply`（卖家回复）、`append`（追评）
+
+**分析重点**：
+1. 好评中的高频关键词 = 产品卖点
+2. 差评中的问题 = 产品痛点/改进方向
+3. 带图评论 = 真实使用场景
+4. 追评内容 = 长期使用体验
+
+### 🔬 商品洞察 - `scout taobao insights`
+
+一键获取商品详情 + 评论（组合查询）。
+
+```bash
+scout taobao insights 713865529993
+```
+
+**参数**：
+- `<itemId>`：商品 ID（必填）
+- `-f, --format`：输出格式 `json|text`（默认: json）
+
+**返回数据**：`detail`（商品详情）+ `comments`（第一页评论）
+
+---
+
+## 典型工作流
+
+### 淘宝选品调研
+
+```bash
+# 1. 搜索目标品类
+scout taobao search "便携榨汁机" --sort sales
+
+# 2. 分析 TOP 商品
+scout taobao insights <itemId>
+
+# 3. 对比多个商品的评论
+scout taobao comments <itemId1>
+scout taobao comments <itemId2>
+
+# 4. 跨平台比较
+scout search "portable blender" --limit 10     # Amazon 同品类
+scout supplier-search "便携式榨汁机"             # 1688 供应商
+```
+
+### 竞品分析
+
+```bash
+# 1. 搜索竞品关键词
+scout taobao search "竞品品牌名" --tmall
+
+# 2. 看竞品 TOP 商品详情
+scout taobao detail <竞品itemId>
+
+# 3. 分析竞品评论（找差异化机会）
+scout taobao comments <竞品itemId>
+```
+
+### 跨平台选品联动
+
+```bash
+# 1. Reddit/Twitter 发现趋势
+scout reddit trends "产品关键词"
+scout twitter trends "产品关键词"
+
+# 2. 淘宝验证国内市场
+scout taobao search "产品关键词" --sort sales
+
+# 3. Amazon 验证海外市场
+scout search "product keyword" --limit 10
+
+# 4. 找供应商
+scout supplier-search "产品中文名"
+```
+
+---
+
+## 数据解读参考
+
+### 商品表现判断
+
+| 指标 | 爆款 | 热销 | 一般 |
+|------|------|------|------|
+| 付款人数 | 10000+ | 1000-10000 | <1000 |
+| 好评率 | >98% | 95-98% | <95% |
+| 评论数 | >5000 | 1000-5000 | <1000 |
+
+### 价格区间分析
+
+搜索时注意对比：
+- `price`（折后价）vs `originalPrice`（原价）→ 折扣力度
+- 同品类不同价格带的销量分布 → 主力价格带
+- 天猫 vs 淘宝同款价差 → 品牌溢价空间
+
+### 选品信号
+
+| 淘宝信号 | 含义 | 下一步 |
+|----------|------|--------|
+| 销量高+评论多+好评率高 | 成熟爆款 | 找差异化切入点 |
+| 销量增长快+评论少 | 新兴爆款 | 快速跟进窗口 |
+| 品类搜索多+好商品少 | 供给不足 | 产品机会 |
+| 差评集中某问题 | 痛点明确 | 改进型产品机会 |
+| 天猫占比高 | 品牌化品类 | 需要品牌背书 |
+
+---
+
+## 重要提醒
+
+1. **itemId 纯数字**：从商品 URL 中提取 `id=` 后面的数字
+2. **每页数量**：搜索 10 条/页，评论 20 条/页
+3. **评分映射**：API 返回 1=好评/0=中差评，已映射为 5/1 星
+4. **sort 不传为默认排序**：不要传 `default`，直接省略 `--sort` 参数
+5. **跨 Skill 联动**：淘宝验证国内市场 → Amazon 验证海外 → 1688 找供应商 → Reddit/Twitter 看社媒趋势