openclaw-voc-skill/docs/voc-skills-course-plan/openclaw-voc-skill-map.md

OpenClaw VOC Skills 单平台报告链路图

用途：把“OpenClaw 用户如何用技能生成单平台 VOC 洞察报告”固定成课程、产品和技能开发共用的认知地图。

1. 用户侧目标

用户在 OpenClaw 中不是为了学习脚本，而是为了完成一个业务结果：

输入平台、品类、关键词和问题
→ 调用 VOC Skills
→ 得到一份可阅读、可追溯、可行动的单平台 VOC 洞察报告

2. 用户最小输入

字段	示例	说明
platform	xiaohongshu	单次课程只选一个平台
category	冻干益生菌	品类、产品或品牌方向
businessQuestion	用户为什么关注冻干益生菌？	报告要回答的核心问题
keywords	儿童益生菌怎么选	3-5 个关键词起步
sampleMode	true	课程演示可使用样例数据
outputFormat	both	markdown / html / both

3. 理想总入口

OpenClaw 用户课推荐只暴露一个主入口：

voc/voc-single-platform-report

用户不需要理解本地脚本，也不需要手动串联多个工具。

4. 总链路

voc/voc-single-platform-report
  ├─ Step 0：Token / 权限预检
  ├─ Step 1：确认平台、品类、关键词、业务问题
  ├─ Step 2：调用平台采集编排 skill
  │    ├─ xiaohongshu/xiaohongshu-mini-voc
  │    ├─ douyin/douyin-mini-voc
  │    ├─ social-voc/tiktok-category-voc
  │    ├─ social-voc/instagram-brand-voc
  │    └─ voc/product-reviews-query
  ├─ Step 3：归一化为标准 VOC 数据
  ├─ Step 4：生成单平台 mini report
  ├─ Step 5：生成 HTML v2 报告
  ├─ Step 6：质量审计
  └─ Step 7：返回报告文件、证据卡和下一步建议

5. 平台技能映射

平台	采集/编排 skill	当前状态	课程使用建议
小红书	xiaohongshu/xiaohongshu-mini-voc	已有编排规范	2 小时课首选平台
抖音	douyin/douyin-mini-voc	已有编排规范	内容爆点和评论问题课
Amazon	voc/product-reviews-query	已有评论采集能力	跨境评论 VOC 课
TikTok	social-voc/tiktok-category-voc	已有社媒 VOC 方向	海外趋势课
Instagram	social-voc/instagram-brand-voc	已有品牌内容 VOC 方向	海外品牌内容课

6. 报告生成能力映射

能力	当前实现	面向 OpenClaw 的目标形态
数据归一化	scripts/tools/voc-data-normalizer.js	voc/voc-data-normalizer
章节洞察	scripts/tools/chapter-insight-writer.js	voc/voc-chapter-insight-writer
单平台 mini report	scripts/tools/platform-mini-report-generator.js	voc/voc-platform-mini-report-generator
HTML v2 渲染	voc-report-factory/html-v2/gen-report-template.js	voc/voc-html-report-generator
报告审计	scripts/tools/voc-report-auditor.js	voc/voc-report-auditor
总入口	已新增课程总入口规范，执行层待产品化	voc/voc-single-platform-report

7. 课程版最小闭环

课程录制不应该展示本地脚本命令，而应展示以下 OpenClaw 交互：

用户：我想用小红书看冻干益生菌用户声音，关键词是 A/B/C。
OpenClaw：我会使用单平台 VOC 报告流程，先检查 token，再采集小红书数据，最后生成报告。
OpenClaw：报告已生成，包含 105 条 VOC、6 张证据卡、H1-H8 覆盖情况和 4 个行动建议。
用户：打开报告。
OpenClaw：展示 Markdown 或 HTML 报告。

8. 课程录制口径

应该说

• “我们在 OpenClaw 中调用 VOC Skills。”
• “这一步由技能完成采集和整理。”
• “报告里的结论必须回到用户原声。”
• “样本量不足时只写阶段性信号。”

不应该说

• “打开终端运行 Node.js 脚本。”
• “这个报告完全自动等于最终结论。”
• “一百条评论代表整个市场。”
• “用户反馈可以直接证明医学功效。”

9. OpenClaw 侧返回格式建议

voc-single-platform-report 应返回：

{
  "metadata": {
    "project": "openclaw-voc-course-demo",
    "platform": "xiaohongshu",
    "category": "冻干益生菌",
    "generatedAt": "2026-04-30T00:00:00.000Z"
  },
  "summary": {
    "commentCount": 105,
    "itemCount": 30,
    "keywordCount": 3,
    "evidenceCardCount": 6,
    "warningCount": 0
  },
  "outputs": {
    "markdownReport": "platform-mini-report.md",
    "jsonReport": "platform-mini-report.json",
    "htmlReport": "platform-mini-report.html",
    "auditReport": "audit-report.md"
  },
  "nextActions": [
    "补充竞品关键词",
    "复核高赞负面评论",
    "把 P0 机会点转成内容 AB 测试"
  ]
}

10. 技能开发优先级

优先级	项目	原因
P0	voc/voc-single-platform-report	课程主入口，决定用户体验
P0	voc/voc-platform-mini-report-generator	把数据变成可读报告
P0	voc/voc-html-report-generator	生成可展示报告
P1	voc/voc-data-normalizer	支撑多平台输入统一
P1	voc/voc-report-auditor	形成交付质量闸门
P2	voc/voc-hypothesis-generator	系统训练营增强
P2	voc/voc-collection-matrix-builder	企业级报告增强

11. 与现有文档关系

文档	作用
07-openclaw-single-platform-course.md	录课主手册
openclaw-voc-skill-map.md	OpenClaw 技能链路认知图
02-standard-report-workflow.md	内部交付/高阶训练营 SOP
examples/report-factory-demo/README.md	本地脚本链路验证
voc-report-factory/README.md	报告模板包说明