# VOC Skills 调用示例库

本目录用于给助教和学员提供可复制的核心 skill 调用示例。每个示例都包含输入、预期输出、常见错误和课堂讲解点。

## 示例目录

| 场景目录 | 实际调用对象 | 适用课堂环节 |
|---|---|---|
| `openclaw-single-platform-report/` | `voc/voc-single-platform-report` | OpenClaw 用户课主入口：输入平台、品类、关键词和业务问题，生成单平台 VOC 洞察报告 |
| `amazon-review-voc/` | `voc/product-reviews-query` | Amazon 评论 VOC、差评/好评拆解、ASIN 体检 |
| `xiaohongshu-mini-voc/` | `xiaohongshu/xiaohongshu-mini-voc` | 小红书 2 小时课采集链路 |
| `douyin-content-voc/` | `douyin/douyin-mini-voc` | 抖音内容爆点、评论问题、热评回复 |
| `tiktok-instagram-trend/` | `social-voc/tiktok-category-voc`、`social-voc/instagram-brand-voc`、`social-voc/social-trend-analysis` | 海外社媒趋势与品牌内容策略 |
| `report-factory-demo/` | `scripts/tools/*` 与 `voc-report-factory/` | normalized VOC 到章节草稿、mini report、HTML demo |

## 使用顺序

1. OpenClaw 用户录课优先使用 `openclaw-single-platform-report/`。
2. 先确认项目、品类、平台、关键词和业务问题。
3. 复制示例 JSON 到对应 skill 调用面板。
4. 如果是平台采集专项课，再进入小红书、抖音、Amazon、TikTok/Instagram 等分平台示例。
5. 如果是开发者或助教验证链路，再使用 `report-factory-demo/` 的本地脚本流程。
6. 用审计清单检查证据是否可追溯。

## 课堂共通规则

- **数据边界**：课程样例、合成样例、真实采集必须分开标注。
- **证据追溯**：结论必须能追溯到 platform、keyword、batch、id/commentId。
- **Token 前置**：需要数据网关的 skill 在课前完成 token 预飞。
- **低样本提醒**：样本过少时只写“阶段性信号”，不写全市场判断。
- **人工复核**：自动生成报告只作为初稿，交付前必须人工复核原声证据。
- **课程主线**：对外录课讲 OpenClaw skill 调用，不讲本地脚本命令。