# 04. 技能支撑矩阵：课程、工作流与报告字段映射

## 目标

建立一张“课程 - 工作流 - skill - 输出字段 - 报告章节”的对应表，确保每一节课、每一个报告步骤、每一个产品卖点都有明确技能支撑。

这份矩阵用于：

- 检查 `voc-skills` 发布包是否缺技能。
- 设计课程时明确每节课调用哪些 skill。
- 设计报告工厂时明确每个字段从哪里来。
- 给技能市场用户解释“买了这个包能产出什么”。

## 总体能力分层

| 层级 | 说明 | 代表能力 |
|---|---|---|
| L0 配置层 | token、安装、预飞、凭证 | `set-voc-token.js`、`voc-token-preflight` |
| L1 数据采集层 | 单平台、单接口、原子数据获取 | product、keyword、review、xiaohongshu、douyin、tiktok、instagram |
| L2 数据整理层 | 合并、去重、标签、结构化 | normalizer、comments-flat、stage output |
| L3 分析编排层 | 品类、竞品、VOC、社媒、画像 | category-landscape、competitor-analysis、review-analysis |
| L4 报告生成层 | 提案、HTML、审计、交付 | voc-proposal、html-report-generator、report-auditor |
| L5 教学/工作坊层 | playbook、session、side quest、课程模板 | workshop session、product-analysis-playbook |
| L6 用户总入口层 | 对 OpenClaw 用户屏蔽脚本和多技能串联 | `voc-single-platform-report` |

## 6 阶段报告工作流映射

| 阶段 | 工作内容 | 当前支撑 | 缺口/建议 |
|---|---|---|---|
| Phase 1 需求摄入 | 品牌、产品、目标、平台、竞品 | `brand-context-builder`、workshop session 0 | 增加 `voc-intake-builder` 文档/skill |
| Phase 2 假设结构 | H1-H8、章节框架、交付范围 | 现有方法论文档、人工判断 | 增加 `hypothesis-generator` 模板 |
| Phase 3 采集矩阵 | 关键词 x 平台 x 批次 | fmode 方法论、人工表格 | 增加 `collection-matrix-builder` |
| Phase 4 数据采集 | API 调用、合并、去重 | 平台 skills、collect 脚本模式 | 抽象统一 `voc-data-normalizer` |
| Phase 5 分析生成 | 章节洞察、VOC 证据卡、HTML | review/competitor/synthesis/report skills | 固化 v2 报告组件库 |
| Phase 6 审计交付 | placeholder、样本、假设、证据回溯 | 审计方法论、人工检查 | 增加 `voc-report-auditor` |

## 工作坊 session 与技能映射

| Session | 目标 | 关键 skills | 输出文件 | 报告章节 |
|---|---|---|---|---|
| Session 0 品牌建档 | 收集品牌、品类、ASIN、目标 | `brand-context-builder`、`voc-token-preflight` | `brand-context.json`、`workshop-progress.json` | 项目背景 |
| Session 1 品类全景 | 判断品类机会、搜索、价格、竞争 | `category-landscape`、`product-search`、`keyword-search`、`keyword-search-trend`、`category-tree` | `stage-1-output.json` | 品类全景 |
| Session 2 品牌竞品 | 发现竞品、画像、对比、定价 | `brand-profile`、`competitor-discovery`、`product-deep-analysis`、`competitor-product-comparison`、`competitor-pricing-analysis` | `stage-2-output.json` | 竞品矩阵/品牌画像 |
| Session 3 评论 VOC | 采评论、情感、关键词 | `review-batch-collection`、`review-sentiment-analysis`、`review-keyword-cloud` | `stage-3-output.json` | 用户声音/情感地图 |
| Session 4 深度 VOC | 痛点、亮点、场景、社媒、画像 | `review-pain-point-extraction`、`review-highlight-extraction`、`tiktok-category-voc`、`instagram-brand-voc`、`douyin-general-search`、`social-trend-analysis`、`user-persona` | `stage-4-output.json` | 痛点/亮点/社媒/画像 |
| Session 5 最终报告 | 提案、行动、HTML 报告 | `voc-proposal`、`html-report-generator` | proposal + HTML | 最终报告/行动计划 |

## 单平台 2 小时课映射

对外录课和用户教学时，优先使用总入口：

```text
voc/voc-single-platform-report
```

平台 mini VOC skill 用于解释底层采集链路；本地脚本仅用于助教验证和开发者调试。

### 小红书 VOC 课

| 模块 | 学员动作 | 技能支撑 | 交付字段 |
|---|---|---|---|
| 总入口 | 输入平台、品类、关键词和业务问题 | `voc-single-platform-report` | mini report / HTML report |
| 关键词矩阵 | 写产品词、竞品词、场景词、问题词 | `voc-single-platform-report` 入参或 `xiaohongshu-mini-voc` 的 `keywordMatrix` | `keywords[]` |
| 笔记采集 | 获取高赞/新近/相关笔记 | `xiaohongshu-mini-voc` → `xiaohongshu-search-notes`、`xiaohongshu-note-detail` | `notes[]` |
| 评论采集 | 抽取真实用户评论 | `xiaohongshu-mini-voc` → `xiaohongshu-note-comments` | `commentsFlat[]` |
| 报告生成 | 聚合主题、证据卡、机会点 | `voc-single-platform-report` 编排报告生成层 | `themes`、`evidenceCards`、`actions` |

**发布缺口**：小红书采集技能已进入 `voc-social-data`；课程主入口需要继续把报告生成层包装为可执行 Skill。

### 抖音 VOC 课

| 模块 | 学员动作 | 技能支撑 | 交付字段 |
|---|---|---|---|
| 总入口 | 输入平台、品类、关键词和业务问题 | `voc-single-platform-report` | mini report / HTML report |
| 内容搜索 | 搜索关键词和爆款视频 | `douyin-mini-voc` → `douyin-general-search` | `videos[]` |
| 评论观察 | 分析用户问题和情绪 | `douyin-mini-voc` → `douyin-video-comments`、`douyin-comment-replies` | `comments[]`、`replies[]` |
| 爆点拆解 | 看标题、钩子、场景、互动 | `douyin-mini-voc` + 报告生成层 | `contentSignals` |
| 行动建议 | 生成短视频选题/脚本方向 | `voc-single-platform-report` | `contentActions` |

### Amazon 评论 VOC 课

| 模块 | 学员动作 | 技能支撑 | 交付字段 |
|---|---|---|---|
| 找产品 | 搜索竞品与对标 ASIN | `product-search`、`product-detail-query` | `products[]` |
| 采评论 | 获取代表性评论 | `review-batch-collection` | `reviews[]` |
| 情感/关键词 | 看正负面与高频词 | `review-sentiment-analysis`、`review-keyword-cloud` | `sentiment`、`keywords` |
| 痛点/卖点 | 提取差评痛点和好评亮点 | `review-pain-point-extraction`、`review-highlight-extraction` | `painPoints`、`highlights` |
| Listing 优化 | 生成标题/Bullet/A+ 建议 | `voc-proposal` 可选 | `listingActions` |

### TikTok / Instagram VOC 课

| 模块 | 学员动作 | 技能支撑 | 交付字段 |
|---|---|---|---|
| 趋势观察 | 获取内容趋势和达人内容 | `tiktok-category-voc`、`tiktok-brand-voc`、`instagram-brand-voc` | `socialPosts[]` |
| 互动信号 | 看点赞、评论、标签、视觉元素 | social analysis | `engagementSignals` |
| 内容机会 | 总结内容钩子、场景、视觉风格 | synthesis prompts | `contentOpportunities` |
| 跨平台验证 | 与 Amazon/小红书/抖音信号对照 | `social-trend-analysis` | `crossPlatformSignals` |

## 报告字段与技能来源

| 报告字段 | 来源 skill/流程 | 质量要求 |
|---|---|---|
| 样本量 | 采集脚本 / merged data | 平台、关键词、批次可拆分 |
| 平台分布 | normalizer | 与封面数字一致 |
| H1-H8 覆盖 | 采集矩阵 + tags | 每个假设有证据或标注不足 |
| 用户痛点 | `review-pain-point-extraction` / 小红书评论归纳 | 有 VOC 原声支撑 |
| 用户亮点 | `review-highlight-extraction` / 好评归纳 | 能转成卖点表达 |
| 高频场景 | 评论/笔记/视频场景归纳 | 区分高频、失败、新兴场景 |
| 竞品矩阵 | `competitor-discovery` + comparison skills | 至少 3-6 个竞品 |
| 价格认知 | `competitor-pricing-analysis` + VOC | 不只列价格，要解释价值感 |
| 社媒趋势 | TikTok/Instagram/抖音/小红书 skills | 标注平台偏差 |
| 用户画像 | `user-persona` + VOC 聚类 | 画像要能指导行动 |
| 行动计划 | `voc-proposal` + 人工校准 | P0/P1/P2、周期、验证方式 |
| HTML 报告 | `html-report-generator` / v2 renderer | 无 placeholder，可演示 |

## 当前技能缺口清单

| 缺口 | 优先级 | 原因 | 建议落地 |
|---|---|---|---|
| `voc-single-platform-report` 执行层 | P0 | OpenClaw 用户课需要一个总入口，不能让学员串脚本 | 已新增规范，下一步接入报告生成执行层 |
| `voc-platform-mini-report-generator` Skill 化 | P0 | 当前 mini report 生成仍是本地脚本 | 包装 `platform-mini-report-generator.js` |
| `voc-html-report-generator` Skill 化 | P0 | 当前 HTML v2 生成仍是本地脚本 | 包装 `gen-report-template.js` |
| `voc-data-normalizer` Skill 化 | P1 | 多平台字段不统一影响审计和报告 | 包装 `_merged.json` schema 与 normalizer |
| `voc-report-auditor` Skill 化 | P1 | 企业交付必须可审计 | 包装 placeholder/样本/假设/证据检查 |
| `hypothesis-generator` | P1 | 可提升课程和交付效率 | 由 intake 自动生成 H1-H8 |
| `chapter-insight-writer` | P1 | 报告章节一致性关键 | 基于 stage output 生成章节草稿 |
| `collection-matrix-builder` | P2 | 系统训练营和企业报告需要，不是 2 小时课首要入口 | 先做 Markdown 模板，再做 skill |

## 发布包与课程的对应关系

| 发布包 | 支撑课程 | 支撑交付 |
|---|---|---|
| `voc-core` | Amazon 评论 VOC 课、系统训练营 Week 2-4 | 跨境品类/竞品/评论报告 |
| `voc-social-data` | 小红书课、抖音课、TikTok/Instagram 课 | 中文/海外社媒 VOC 报告 |
| `voc-workshop` | 企业工作坊、认证训练营 | 2 天工作坊完整交付 |
| `voc-report-factory` | 系统训练营、顾问认证 | 6 阶段标准化报告生产 |

## 课程设计检查问题

每节课设计完成前必须回答：

1. 这节课服务哪个具体业务问题？
2. 调用哪些 skill？
3. 采集哪些平台与字段？
4. 2 小时内能不能稳定完成？
5. 交付物是否能被学员直接复制使用？
6. 是否能引导购买技能包或系统课？
7. 是否有样例数据兜底？
8. 是否有审计或质量检查环节？