# "AI情报官" VOC虾工作坊 — 技能映射清单

## 一、技能架构总览

工作坊需要 **两层技能**：

```
┌──────────────────────────────────────────────────────────────┐
│              编排层（18 个 Orchestration Skills）               │
│  competitor-analysis/ (4) │ review-analysis/ (5)              │
│  social-voc/ (4)          │ synthesis/ (5)                    │
│  ↓ 调用                                                       │
├──────────────────────────────────────────────────────────────┤
│              数据采集层（23 个 Data Skills）                     │
│  voc/ (12): product-search / product-reviews-query / ...      │
│  social-media/ (11): tiktok-video-search / instagram-search   │
└──────────────────────────────────────────────────────────────┘
```

- **数据采集层**：23 个 skill（已完成），负责原子级 API 调用
- **编排层**：18 个 skill（已完成），按功能拆分为 4 个子类
  - `competitor-analysis/` — 竞品分析（4个）
  - `review-analysis/` — 竞品评论分析（5个）
  - `social-voc/` — 社媒VOC分析（4个）
  - `synthesis/` — 综合分析（5个）

---

## 二、现有 23 个数据采集 Skill 与工作坊环节对应

### VOC 类（12个）— 对应 Day1 全天 + Day2 上午竞品分析

| Skill | 工作坊环节 | 具体用途 |
|-------|-----------|---------|
| `product-search` | Day1上午-品类格局 | 关键词搜Top100产品，计算CR5/HHI |
| `product-detail-query` | Day1下午-品牌认知 | 获取产品完整信息（价格/评分/BSR/卖点） |
| `asin-sales-volume` | Day1上午-品类格局 | 批量获取销量，计算市场规模和品牌份额 |
| `product-reviews-query` | Day1晚-电商VOC采集 | **核心**：批量抓取评论，提取用户声音 |
| `keyword-search` | Day1上午-品类格局 | 查询关键词搜索量/竞争度 |
| `keyword-search-trend` | Day1上午-品类格局 | 关键词趋势，发现飙升词 |
| `keyword-product-ranking` | Day1下午-竞品初筛 | 关键词下的产品排名 |
| `asin-reverse-keywords` | Day1晚-VOC关键词 | 竞品ASIN反查关键词，构建关键词库 |
| `category-tree` | Day1上午-品类格局 | 定位品类类目ID |
| `category-products` | Day1上午-品类格局 | 获取类目下全部产品 |
| `similar-products` | Day1下午-竞品初筛 | 发现相似竞品 |
| `product-monitor` | Day2上午-竞品诊断 | 竞品价格/排名变化追踪 |

### Social Media 类（11个）— 对应 Day2 上午社媒VOC采集

| Skill | 工作坊环节 | 具体用途 |
|-------|-----------|---------|
| `tiktok-video-search` | Day2上午-社媒VOC | 搜索品类相关TikTok视频 |
| `tiktok-video-detail` | Day2上午-社媒VOC | 爆款视频深度分析 |
| `tiktok-video-comments` | Day2上午-社媒VOC | **核心**：抓取视频评论，提取用户需求 |
| `tiktok-user-search` | Day2上午-社媒VOC | 搜索品类红人/达人 |
| `tiktok-user-profile` | Day2上午-社媒VOC | 竞品品牌TikTok画像 |
| `tiktok-user-posts` | Day2上午-社媒VOC | 竞品内容策略分析 |
| `tiktok-hashtag-detail` | Day2上午-社媒VOC | 品类话题热度统计 |
| `tiktok-hashtag-videos` | Day2上午-社媒VOC | 话题下热门内容 |
| `instagram-search` | Day2上午-社媒VOC | 竞品IG账号发现 |
| `instagram-user-info` | Day2上午-社媒VOC | 竞品IG粉丝/帖子数据 |
| `instagram-user-posts` | Day2上午-社媒VOC | 竞品IG内容分析 |

---

## 三、18 个编排 Skill 清单（已创建，按分类）

### 3.1 competitor-analysis/ — 竞品分析（4个）

| Skill | 对应环节 | 功能 | 调用的底层skill |
|-------|---------|------|---------------|
| `competitor-discovery` | Day1下午-竞品初筛 | 自动发现筛选3-5家竞品 + **竞争格局分析**(CR5/垄断度/品牌对比/差异化攻防策略) | product-search, similar-products, keyword-product-ranking, product-detail-query |
| `competitor-product-comparison` | Day1下午-竞品对比 | 多维对比 + **5维健康度仪表盘**(定价/评分/流量/销量/增长 + 机会/风险标签) | product-detail-query, asin-sales-volume, product-monitor |
| `competitor-pricing-analysis` | Day1下午+Day2上午 | **5分位价格带** + 黄金带评分 + 毛利估算 + 促销建议 + 盈亏平衡销量 | product-search, product-detail-query, product-monitor |
| `competitor-bsr-tracking` | Day2上午-竞品动态 | BSR追踪 + **增长路径分析**(层级定位/日销差距/SKU聚焦) + **风险预警** | product-monitor, product-detail-query |

### 3.2 review-analysis/ — 评论分析（5个）

| Skill | 对应环节 | 功能 | 调用的底层skill |
|-------|---------|------|---------------|
| `review-batch-collection` | Day1晚-电商VOC采集 | 批量采集+去重清洗 + **竞品VOC对比汇总**(本店vs竞品均分/差评率/top产品) | product-reviews-query |
| `review-sentiment-analysis` | Day1晚-认知校准 | 情感分类 + **情感短语规则**(regex多词匹配) + **情感词云** | 纯NLP/AI |
| `review-pain-point-extraction` | Day2上午-竞品差评 | 痛点提取聚类 + **VOC优化建议**(评分差距/转化影响/listing建议/产品迭代/售后) | 纯NLP/AI |
| `review-highlight-extraction` | Day2上午-竞品好评 | 亮点提取 + **Listing卖点植入建议**(标题/bullet/A+的具体词根建议) | 纯NLP/AI |
| `review-keyword-cloud` | Day1晚-关键词库 | 关键词云 + **情感标签**(positive/negative/neutral每个词) | asin-reverse-keywords |

### 3.3 social-voc/ — 社媒VOC分析（4个）

| Skill | 对应环节 | 功能 | 调用的底层skill |
|-------|---------|------|---------------|
| `tiktok-category-voc` | Day2上午-TikTok品类 | 品类关键词视频搜索 + 批量评论采集 + 话题热度 | tiktok-video-search, tiktok-video-comments, tiktok-hashtag-detail, tiktok-hashtag-videos |
| `tiktok-brand-voc` | Day2上午-TikTok品牌 | 竞品品牌TikTok账号搜索 + 内容策略 + 粉丝反馈 | tiktok-user-search, tiktok-user-profile, tiktok-user-posts, tiktok-video-comments |
| `instagram-brand-voc` | Day2上午-IG品牌 | 竞品品牌IG搜索 + 帖子分析 + 互动数据 | instagram-search, instagram-user-info, instagram-user-posts |
| `social-trend-analysis` | Day2上午-趋势分析 | 跨平台热度对比、趋势话题、内容机会 + **优先级行动清单** | 纯数据分析（依赖前3个social-voc skill输出） |

### 3.4 synthesis/ — 综合分析（5个）

| Skill | 对应环节 | 功能 | 调用的底层skill |
|-------|---------|------|---------------|
| `product-deep-analysis` | 贯穿全程-单品诊断 | 6维分析 + **5分位价格带+毛利估算+促销建议** + AI运营建议 | product-detail-query, asin-reverse-keywords, product-monitor, product-reviews-query |
| `category-landscape` | Day1上午-品类格局 | CR5/HHI + 健康度 + 价格带 + **风险预警汇总** + **优先行动清单** | product-search, asin-sales-volume, category-tree, keyword-search, keyword-search-trend |
| `brand-profile` | Day1下午-品牌画像 | 六维画像 + **机会/风险标签** + **核心短板** + **定位建议** | product-detail-query, asin-sales-volume, product-reviews-query |
| `user-persona` | Day2上午-用户画像 | 画像生成 + **购买行为分析**(价格敏感度映射/季节性/渠道偏好) | 纯AI（依赖review-analysis和social-voc输出） |
| `voc-proposal` | Day2下午-提案生成 | 6章节提案 + **ROI估算** + **风险整合** + **30天行动时间线** | 纯AI（依趖所有前置skill输出） |

> 每个 Skill 的详细参数、执行流程和返回格式请查看对应目录下的 `SKILL.md` 和 `api-config.json`

---

## 四、工作坊全流程 Skill 调用链

```
Day1 上午 09:00-12:00 「教虾认品类」
  └─ synthesis/category-landscape
      ├─ product-search ×2-3
      ├─ asin-sales-volume ×100
      ├─ keyword-search ×5-10
      ├─ keyword-search-trend ×5
      └─ category-tree ×1

Day1 下午 13:30-18:00 「教虾认品牌·竞品初筛」
  ├─ synthesis/product-deep-analysis
  │   ├─ product-detail-query ×1
  │   ├─ asin-reverse-keywords ×1
  │   ├─ product-monitor ×1
  │   └─ product-reviews-query ×3 + AI诊断
  ├─ synthesis/brand-profile
  │   ├─ product-detail-query ×10-20
  │   ├─ asin-sales-volume ×10-20
  │   └─ product-reviews-query ×5
  ├─ competitor-analysis/competitor-discovery
  │   ├─ product-search ×1
  │   ├─ similar-products ×3-5
  │   ├─ keyword-product-ranking ×3
  │   └─ product-detail-query ×5
  ├─ competitor-analysis/competitor-product-comparison
  │   ├─ product-detail-query ×10
  │   ├─ asin-sales-volume ×10
  │   └─ product-monitor ×10
  └─ competitor-analysis/competitor-pricing-analysis
      ├─ product-search ×1
      ├─ product-detail-query ×5
      └─ product-monitor ×5

Day1 晚 19:00-21:30 「试捕电商VOC」
  ├─ review-analysis/review-batch-collection
  │   └─ product-reviews-query ×50-100
  ├─ review-analysis/review-sentiment-analysis（纯NLP/AI）
  └─ review-analysis/review-keyword-cloud
      └─ asin-reverse-keywords ×10-20

Day2 上午 09:00-12:00 「社媒VOC + 竞品诊断 + 用户画像」
  ├─ social-voc/tiktok-category-voc
  │   ├─ tiktok-video-search ×2-3
  │   ├─ tiktok-video-comments ×20
  │   ├─ tiktok-hashtag-detail ×5
  │   └─ tiktok-hashtag-videos ×3
  ├─ social-voc/tiktok-brand-voc
  │   ├─ tiktok-user-search ×5
  │   ├─ tiktok-user-profile ×5
  │   ├─ tiktok-user-posts ×5
  │   └─ tiktok-video-comments ×10
  ├─ social-voc/instagram-brand-voc
  │   ├─ instagram-search ×5
  │   ├─ instagram-user-info ×5
  │   └─ instagram-user-posts ×5
  ├─ social-voc/social-trend-analysis（纯分析）
  ├─ competitor-analysis/competitor-bsr-tracking
  │   ├─ product-monitor ×5
  │   └─ product-detail-query ×5
  ├─ review-analysis/review-pain-point-extraction（纯AI）
  ├─ review-analysis/review-highlight-extraction（纯AI）
  └─ synthesis/user-persona（纯AI）

Day2 下午 13:00-17:00 「成果整合·提案」
  └─ synthesis/voc-proposal（纯AI）
```

## 五、API 调用量估算（单组）

| 底层 Skill | 预估调用次数 | 说明 |
|-----------|-------------|------|
| product-search | 3-5 | 多关键词搜索 |
| product-detail-query | 25-40 | 品牌+竞品产品详情 |
| asin-sales-volume | 100-120 | Top100批量销量 |
| product-reviews-query | 50-100 | 多ASIN多页评论 |
| keyword-search | 10-15 | 品类关键词 |
| keyword-search-trend | 5-8 | 趋势分析 |
| keyword-product-ranking | 3-5 | 排名分析 |
| asin-reverse-keywords | 10-20 | 竞品反查 |
| category-tree | 1 | 类目定位 |
| category-products | 1-2 | 类目产品 |
| similar-products | 3-5 | 相似产品 |
| product-monitor | 5-10 | 竞品监控 |
| tiktok-video-search | 2-3 | 视频搜索 |
| tiktok-video-comments | 20 | 评论采集 |
| tiktok-hashtag-detail | 5 | 话题热度 |
| tiktok-hashtag-videos | 3 | 话题视频 |
| instagram-search | 5 | 品牌搜索 |
| instagram-user-info | 5 | 用户详情 |
| instagram-user-posts | 5 | 帖子列表 |
| **总计** | **~260-380 次** | 单组两天 |

## 六、内置核心算法

### 6.1 市场与竞争分析

| 算法模块 | 应用技能 | 算法说明 |
|---------|---------|---------|
| CR5/HHI集中度 | `category-landscape`, `competitor-discovery` | top5品牌销量占比 + 市占率平方和×10000, 垄断度分级(low/medium/high) |
| 5维健康度评分 | `category-landscape`, `brand-profile`, `competitor-product-comparison` | 定价(0.2)+评分(0.25)+流量(0.2)+销售(0.15)+增长(0.2) + 机会/风险标签 |
| 竞争格局分析 | `competitor-discovery` | CR5→垄断度, 品牌份额对比, 差异化进攻策略, 防守策略 |
| 增长路径分析 | `competitor-bsr-tracking` | 层级定位(头部/腰部/尾部) + 日销差距 + SKU聚焦建议 + 关键词建议 |
| 风险预警汇总 | `category-landscape`, `competitor-bsr-tracking` | 品牌集中度/低销量/评分/价格战/库存/合规 多维风险检测 |
| 优先行动清单 | `category-landscape`, `brand-profile`, `social-trend-analysis` | 条件触发式优先级排序: Listing优化→SKU聚焦→促销→产品迭代→库存→差异化 |

### 6.2 定价策略

| 算法模块 | 应用技能 | 算法说明 |
|---------|---------|---------|
| 5分位价格带 | `competitor-pricing-analysis`, `product-deep-analysis` | 按P20/P40/P60/P80分5带, 每带统计SKU/销量/评分 |
| 黄金价格带 | `competitor-pricing-analysis`, `product-deep-analysis` | bandScore=avgSales×0.5+avgRating×20+(skuCount>0?10:0), 最高分为黄金带 |
| 毛利估算 | `competitor-pricing-analysis`, `product-deep-analysis` | 15%佣金+$5FBA+30%采购, grossMargin公式, 盈亏平衡销量 |
| 促销建议 | `competitor-pricing-analysis`, `product-deep-analysis` | 价格战风险检测→多件折扣/满减替代降价 |

### 6.3 评论/VOC分析

| 算法模块 | 应用技能 | 算法说明 |
|---------|---------|---------|
| 情感短语规则 | `review-sentiment-analysis` | regex匹配多词情感短语(too small/well made等), 短语优先于单词 |
| 情感词典 | `review-sentiment-analysis`, `review-keyword-cloud` | 正面词(comfortable/durable...) + 负面词(disappointed/flimsy...) + 星级回退 |
| 情感关键词云 | `review-sentiment-analysis`, `review-keyword-cloud` | 每个关键词带positive/negative/neutral标签, count→weight归一化 |
| VOC驱动优化 | `review-pain-point-extraction` | 评分差距(vs4.6基准)→转化影响估算, listing/产品迭代/售后三维建议 |
| 竞品VOC对比 | `review-batch-collection` | 本店vs竞品: 加权均分/差评率/top5产品, 兼容多种数据源格式 |
| Listing卖点建议 | `review-highlight-extraction` | 亮点词根→标题前65字符/bullet前2条/A+场景, 优先级:必备>差异化>参考 |

### 6.4 综合分析与AI生成

| 算法模块 | 应用技能 | 算法说明 |
|---------|---------|---------|
| 6维品牌画像 | `brand-profile` | 定价/评分/流量/销售/增长/口碑 各0-100分, 四象限定位, 机会/风险标签 |
| 单品深度诊断 | `product-deep-analysis` | 流量架构(valueScore)+定价(5分位)+Listing+VOC痛点+广告+综合健康分 |
| 购买行为分析 | `user-persona` | 价格敏感度→价格带映射, 季节性购买规律, 渠道偏好(社媒/搜索/送礼) |
| ROI估算 | `voc-proposal` | 每条建议估算投入/收益/回本周期: Listing($0/即时)→PPC($30-50/日)→产品迭代(60-90天) |
| 30天行动时间线 | `voc-proposal` | 4周任务分解 + 里程碑(D7/D14/D21/D30), 从Listing优化到全面复盘 |
| AI用户画像 | `user-persona` | 场景+决策因素+购买行为 → AI生成3-5个画像+精准营销策略 |
| AI提案生成 | `voc-proposal` | 6章节数据索引→AI生成→数据引用+完整度标注→Markdown全文 |