README.md 2.1 KB

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-vocsocial-voc/instagram-brand-vocsocial-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 调用,不讲本地脚本命令。