openclaw-voc-skill/docs/voc-skills-course-plan/examples/README.md

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 调用，不讲本地脚本命令。