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 小时课映射
对外录课和用户教学时，优先使用总入口：
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 阶段标准化报告生产 |
课程设计检查问题
每节课设计完成前必须回答：
- 这节课服务哪个具体业务问题？
- 调用哪些 skill？
- 采集哪些平台与字段？
- 2 小时内能不能稳定完成？
- 交付物是否能被学员直接复制使用？
- 是否能引导购买技能包或系统课？
- 是否有样例数据兜底？
- 是否有审计或质量检查环节？
