# 01. VOC Skills 产品化与发布方案

## 目标

把当前 `openclaw-voc-skill` 从“OpenClaw 内部技能集合”升级为可以对外传播、课程售卖、技能市场上架、npm/zip 分发的 **VOC Skills 产品包**。

建议对外统一使用：

- **产品名**：VOC Skills
- **课程/市场名**：voc-skills
- **npm 包名候选**：`@voc-market/voc-skills`
- **技能市场包名候选**：`voc-core`、`voc-social-data`、`voc-workshop`、`voc-report-factory`
- **品牌归属**：voc.market / 商协云

## 当前资产判断

| 资产 | 当前状态 | 产品化价值 |
|---|---|---|
| 技能目录 | 已覆盖 Amazon、Sorftime、电商评论、TikTok、Instagram、抖音、竞品、评论分析、报告合成等 | 可拆成多个可售卖 skill suite |
| `WORKSHOP-SKILL-MAPPING.md` | 已有 23 个数据采集层 + 18 个编排层映射 | 可作为技能市场说明书和课程大纲底稿 |
| `workshop/` | 已有 6 个 session、Side Quest、Token 预飞、产品分析模式 | 可打包成“VOC 虾工作坊”安装包 |
| `scripts/deploy/package-and-upload.js` | 可将技能套件和 workshop 打 zip，并上传 Qiniu | 已具备 zip 市场发布基础 |
| `scripts/deploy/upload-skills.js` | 可同步 Qiniu CDN 与 Parse Skill 元数据，并生成 README | 已具备 skill marketplace 发布链路 |
| `scripts/deploy/install-all.js` | 可安装技能、工作坊、token tools | 可作为全量一键安装入口 |
| `scripts/deploy/install-workshop.js` | 支持 workshop、skills-only、playbook-only | 可支持课程中分层安装 |
| `scripts/tools/set-voc-token.js` / `voc-token-preflight` | 支持 token 写入与预飞检查 | 可形成付费 API 转化闭环 |

## 推荐套件拆分

### 1. `voc-core`

**定位**：跨境电商品类、产品、竞品、评论 VOC 的核心技能包。

**面向用户**：Amazon 卖家、跨境选品团队、产品经理、运营负责人、VOC 系统课学员。

**应包含能力**：

- Amazon 产品搜索与详情
- ASIN 销量/排名/价格/评分查询
- 关键词搜索、趋势、类目树
- 评论批量采集
- 评论情感、关键词、痛点、亮点、场景分析
- 品类全景、竞品发现、竞品对比、定价分析

**主要交付物**：品类健康度、竞品矩阵、评论 VOC、痛点/亮点/功能/场景看板、HTML 报告基础数据。

### 2. `voc-social-data`

**定位**：社媒平台 VOC 采集与趋势验证。

**面向用户**：小红书/抖音/海外社媒运营、内容团队、品牌营销负责人。

**应包含能力**：

- 小红书关键词搜索、笔记采集、评论采集、搜索筛选
- 抖音通用搜索与评论/内容采集
- TikTok 品类/品牌 VOC
- Instagram 品牌 VOC
- 跨平台趋势验证与社媒声量总结

**发布前必须补齐**：现有报告方法论和江中案例中，小红书是核心数据源，但当前稳定技能包归类里还需要正式纳入 `xiaohongshu/`。建议将其放入 `voc-social-data`，并在市场 README 中明确适用中文消费品、健康医药、餐饮、生活方式场景。

### 3. `voc-workshop`

**定位**：2 天 VOC 虾工作坊完整 playbook 与技能编排包。

**应包含内容**：

- `workshop-global-rules.md`
- `workshop-session-0-intake.md` 到 `workshop-session-5-report.md`
- `product-analysis-playbook.md`
- `synthesis-prompts.md`
- `voc-report-schema-spec.md`
- memory templates
- token tools
- 课程运行所需核心技能

**核心卖点**：不只是技能集合，而是一套可恢复、可门控、可校准的 Agent 工作坊。每个 session 都有 Hard Stop、校准、Side Quest 和最终报告增强机制。

### 4. `voc-report-factory`

**定位**：把人工快速出报告经验固化成标准化报告工厂。

**面向用户**：内部交付团队、高阶课程学员、认证助教、B 端陪跑团队。

**应包含能力**：

- 需求摄入模板
- H1-H8 假设生成
- 关键词 x 平台 x 批次采集矩阵
- 多平台采集执行脚本模板
- 数据合并与审计模板
- 报告渲染器与 HTML 交付模板
- 质量审计 checklist

该套件目前能力分散在 VOC 方法论文档和江中报告脚本中，当前仓库可先以文档包形式发布，后续再抽象为正式 skills/scripts。

## 对外市场包装

### 市场首页推荐文案

> VOC Skills 是面向品牌、产品、运营与 OPC 的 AI 用户洞察技能包。它把电商评论、社媒内容、竞品数据、品类趋势和用户原声转化为可落地的产品优化、内容策略与增长行动。

### 三个价值锚点

1. **VOC 为先**：先听用户真实声音，再做产品与内容决策。
2. **内容为王**：把用户痛点、亮点和场景转化为标题、卖点、短视频与种草内容。
3. **增长为果**：输出可执行的 30/60/90 天行动计划，连接产品改进、渠道策略与转化提升。

## 定价建议

| 产品 | 建议价格 | 权益 |
|---|---:|---|
| 单技能体验 | 0-99 元 | 低频体验、课程演示、样例数据 |
| `voc-core` 月订阅 | 299 元/月 | Amazon 核心数据与评论 VOC 技能 |
| `voc-social-data` 月订阅 | 299 元/月 | 小红书/抖音/TikTok/Instagram 数据技能 |
| `voc-workshop` 课程包 | 2999-6999 元/人 | 工作坊 playbook + 技能安装 + 作业评审 |
| 企业工作坊包 | 3-10 万/场 | 企业私域数据、现场工作坊、最终报告 |
| B 端轻咨询 | 30-60 万/年 | 月度 VOC 报告、策略会、增长陪跑 |

## 发布路线

### 第 1 步：统一命名

- `package.json` 保留仓库可读性，但新增对外说明：`VOC Skills for voc.market`。
- 市场文案统一从 `OpenClaw VOC Skill Collection` 过渡到 `VOC Skills`。
- 对外不强调 `openclaw`，只说明支持 OpenClaw 安装运行。

### 第 2 步：调整发布套件

- 保留现有 `voc-core`。
- 将 `social-media` 升级命名为 `voc-social-data`。
- 明确加入 `xiaohongshu/`。
- 将 workshop 文件、memory 模板、token tools 打入 `voc-workshop`。
- 将报告 SOP 文档加入 `voc-report-factory`。

### 第 3 步：发布形态

| 渠道 | 形态 | 说明 |
|---|---|---|
| OpenClaw Skill Market | zip + metadata | 使用现有 Qiniu + Parse 发布链路 |
| npm | `@voc-market/voc-skills` | 提供安装脚本、manifest、课程文档入口 |
| 课程资料包 | zip / GitHub release | 面向训练营学员安装 |
| 企业交付 | 私有化包 | 可按客户隔离 token、memory、数据目录 |

## 发布前检查清单

- [ ] `xiaohongshu/` 纳入正式发布套件。
- [ ] 市场 README 中套件名、价格、安装命令统一为 `VOC Skills`。
- [ ] `install-all.js` 作为全量安装入口，`install-workshop.js` 明确支持 skills-only、playbook-only 等课程分层安装模式。
- [ ] `voc-token-preflight` 与 `set-voc-token.js` 在课程包中可见。
- [ ] npm 包名、仓库名、skill package name 三者关系写清楚。
- [ ] 课程每节课映射到具体 skill 与输出字段。
- [ ] `voc-report-factory` 至少先以 Markdown SOP 发布。