@vocmarket/voc-skill 0.3.15

package/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "voc-intelligence",
+  "description": "VOC intelligence skills for Claude Code: end-to-end VOC business workflows, Xiaohongshu and Douyin trend reports, live social VOC collection, token/recharge checks, evidence-card outputs, prioritized issue pools, single-problem deep dives, competitor maps, 7-day content plans, VOC-backed speaking script co-creation, boss/operator action plans, and multi-turn memory.",
+  "version": "0.3.15",
+  "author": {
+    "name": "nkkj-BrainHack"
+  }
+}

package/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "voc": {
+      "command": "node",
+      "args": [
+        "E:\\workspace\\openclaw-voc-skill\\claude-code-voc-intelligence\\mcp\\src\\server.js"
+      ],
+      "cwd": "E:\\workspace\\openclaw-voc-skill\\claude-code-voc-intelligence"
+    }
+  }
+}

package/README.md

@@ -0,0 +1,334 @@
+# Claude Code VOC Intelligence
+
+面向 Claude Code 的 VOC 用户洞察技能包。它不是单纯的报告生成器，而是一套“采集真实用户声音 -> 看市场 -> 看竞品 -> 整理问题池 -> 深挖关键问题 -> 生成内容选题 -> 沉淀偏好记忆 -> 下一轮继续优化”的工作流。
+
+当前能力覆盖：
+
+- VOC 经营闭环：适合用户只说“看顾客关心什么、先改哪里、下周发什么”时，一次串起趋势、问题池、单点深挖、内容计划和口播稿。
+- 小红书趋势情报：适合看行业趋势、用户顾虑、内容选题和销售话术。
+- 抖音趋势情报：适合看短视频平台上的用户真实反馈、评论问题、内容机会和门店转化线索。
+- VOC 竞品图谱：适合在竞品不清楚时先找候选竞品，再判断别人被夸什么、被骂什么、我方怎么错位竞争。
+- VOC 问题池：适合把评论、报告证据或用户反馈整理成可排序、可跟进、可继续深挖的问题列表。
+- 单点 VOC 深挖：适合把一个具体问题转成老板能执行的经营动作、内容选题和 7 天验证计划。
+- VOC 内容选题：适合把用户问题转成 7 天短视频选题、口播脚本、镜头建议和验证指标。
+- VOC 口播脚本共创：适合把一条 VOC 选题继续打磨成 60 秒稿、30 秒稿、提词器版，并支持多轮改稿和定稿记忆。
+
+这套技能包不覆盖创始人故事、品牌自传或老板个人 IP 长文。口播脚本要做，但必须来自 VOC 用户问题、竞品评论差异、问题池 Top 问题或单点深挖动作。
+
+## 什么时候用
+
+用户说这些话时，Claude Code 应优先使用本技能包，而不是让用户自己设计提示词：
+
+- “帮我看看这个行业用户最近在关心什么”
+- “跑一份小红书/抖音趋势情报”
+- “先用演示样例跑通流程，不要真实采集”
+- “切到 live，真实采集一下”
+- “帮我看看竞品都在做什么”
+- “我不知道竞品是谁，帮我先做一份竞品图谱”
+- “这些评论里用户到底在吐槽什么”
+- “把这些评论整理成问题池”
+- “哪些问题最影响生意，先改哪个”
+- “这个问题老板该怎么解决”
+- “继续深挖排队/价格/服务/味道这个问题”
+- “下周账号发什么内容”
+- “根据这些顾客吐槽生成 7 天口播脚本”
+- “这个动作不适合我们，下次别推荐”
+- “这个有效，后面优先按这个方向来”
+- “帮我看看顾客关心什么，告诉我先改哪里、下周发什么”
+- “跑一遍完整 VOC 经营闭环”
+
+## 能交付什么
+
+第一轮趋势情报会输出：
+
+- 第一轮初步判断
+- 数据口径
+- 样本观察
+- 机会假设
+- 用户顾虑/决策阻力
+- 证据样本
+- 可继续验证的选题方向
+- 待确认问题
+
+VOC 问题池会输出：
+
+- 问题优先级
+- 每个问题的状态、证据数、影响环节和建议动作
+- 本周建议推进
+- 下一步深挖入口
+- 问题池记忆文件
+
+VOC 竞品图谱会输出：
+
+- 竞品候选清单
+- 用户可能被竞品吸引的点
+- 用户可能吐槽竞品的点
+- 我方错位机会
+- 可转成内容的选题方向
+- 下一步问题池入口
+
+单点 VOC 深挖会输出：
+
+- 一句话判断
+- 优先级判断
+- 用户原话证据
+- 表层问题 vs 深层问题
+- 老板视角影响
+- 今天就能做、7 天内验证、长期沉淀
+- 可转化内容选题
+- 7 天验证计划
+- 下轮验证指标
+- 已应用的使用记忆
+
+VOC 内容选题会输出：
+
+- 7 天内容表
+- 每天对应的用户问题
+- 前 3 秒钩子
+- 30-60 秒口播脚本
+- 镜头建议
+- 评论区引导
+- 验证指标
+
+## 安装
+
+推荐安装到当前工作区，适合 VSCode Claude Code：
+
+```powershell
+npx --yes @vocmarket/voc-skill@latest workspace --smoke
+```
+
+安装后会生成：
+
+```text
+.mcp.json
+.claude/skills/xiaohongshu-trend-intelligence/SKILL.md
+.claude/skills/douyin-trend-intelligence/SKILL.md
+.claude/skills/voc-issue-pool/SKILL.md
+.claude/skills/voc-problem-deep-dive/SKILL.md
+.claude/skills/voc-content-plan/SKILL.md
+.claude/skills/voc-speaking-script/SKILL.md
+.claude/skills/voc-competitor-map/SKILL.md
+.claude/skills/voc-business-workflow/SKILL.md
+.claude/plugins/voc-intelligence
+```
+
+也可以全局安装：
+
+```powershell
+npm install -g @vocmarket/voc-skill
+claude-voc install --smoke
+```
+
+或免全局安装：
+
+```powershell
+npx --yes @vocmarket/voc-skill@latest install --smoke
+```
+
+## 推荐用户话术
+
+小红书演示样例：
+
+```text
+帮我做一份家装全屋定制行业的小红书趋势情报。
+先用演示样例跑通流程，不要真实采集。
+在聊天里给我第一轮样本观察和待确认问题。
+```
+
+抖音演示样例：
+
+```text
+帮我做一份本地生活餐饮行业的抖音趋势情报。
+先用演示样例跑通流程，不要真实采集。
+在聊天里给我第一轮样本观察和待确认问题。
+```
+
+问题池：
+
+```text
+把这些评论整理成问题池，告诉我哪些问题最影响生意，先改哪个。
+```
+
+单点 VOC 深挖：
+
+```text
+继续深挖“排队”这个问题，站在老板视角告诉我怎么解决，给出今天能做的动作和 7 天验证计划。
+```
+
+竞品图谱：
+
+```text
+我是南昌做烧烤的，不知道竞品是谁，帮我先做一份竞品图谱和错位竞争建议。
+```
+
+7 天内容选题：
+
+```text
+根据“排队久、人均贵、第一次来怕踩雷”这些顾客问题，帮我生成 7 天短视频选题和口播脚本。
+```
+
+多轮记忆反馈：
+
+```text
+这个店不想做等位饮品，更想先改评论区回复和预点单，后面按这个方向继续优化。
+```
+
+## Claude Code 应如何调用
+
+优先使用技能入口：
+
+- `xiaohongshu-trend-intelligence`
+- `douyin-trend-intelligence`
+- `voc-issue-pool`
+- `voc-problem-deep-dive`
+- `voc-content-plan`
+- `voc-speaking-script`
+- `voc-competitor-map`
+- `voc-business-workflow`
+
+MCP 工具：
+
+- `voc_business_workflow_run`
+- `voc_xiaohongshu_trend_run`
+- `voc_xiaohongshu_preference_update`
+- `voc_xiaohongshu_token_check`
+- `voc_douyin_trend_run`
+- `voc_douyin_preference_update`
+- `voc_douyin_token_check`
+- `voc_issue_pool_run`
+- `voc_problem_deep_dive_run`
+- `voc_content_plan_run`
+- `voc_competitor_map_run`
+- `voc_speaking_script_run`
+
+命令行入口：
+
+```powershell
+npm --prefix claude-code-voc-intelligence run xhs:sample
+npm --prefix claude-code-voc-intelligence run dy:sample
+npm --prefix claude-code-voc-intelligence run voc:issue-pool
+npm --prefix claude-code-voc-intelligence run voc:deep-dive
+npm --prefix claude-code-voc-intelligence run voc:business-workflow
+npm --prefix claude-code-voc-intelligence run mcp:smoke
+npm --prefix claude-code-voc-intelligence run smoke:package
+```
+
+更完整的能力索引见：
+
+- `docs/capability-map.md`
+- `docs/boss-prompt-templates.md`
+- `docs/deliverables/trend-insight-report.md`
+- `docs/deliverables/competitor-map-report.md`
+- `docs/deliverables/voc-issue-pool-report.md`
+- `docs/deliverables/single-problem-action-plan.md`
+- `docs/deliverables/seven-day-content-plan.md`
+- `docs/live-manual-acceptance-checklist.md`
+- `docs/payment-package-links.md`
+- `docs/context-budget-implementation-plan.md`
+- `skills/voc-content-plan/references/restaurant-content-framework.md`
+- `skills/voc-content-plan/references/restaurant-speaking-script-patterns.md`
+- `skills/voc-competitor-map/references/restaurant-competitor-framework.md`
+- `skills/voc-competitor-map/references/restaurant-differentiation-patterns.md`
+
+## 工作坊输出口径
+
+面向老板或线下工作坊时，优先按这五段表达：
+
+1. 你这轮能拿到什么。
+2. 我会怎么做。
+3. 第一版结果。
+4. 你需要确认什么。
+5. 下一步建议。
+
+每个模块都要对应一个交付物：趋势清单、竞品图谱、问题清单、单点行动计划、7 天内容选题。不要在前台讲 MCP、schema、提示词工程。
+
+## VOC 经营闭环
+
+当用户想一次拿到“市场真实声音 -> 先改哪个问题 -> 老板能做什么 -> 下周发什么 -> 第一条口播稿”时，优先使用：
+
+```text
+voc_business_workflow_run
+```
+
+典型话术：
+
+```text
+帮我看一下南昌餐饮最近顾客在关心什么，并告诉我先改哪里、下周发什么。
+```
+
+这条链路会自动串起趋势情报、VOC 问题池、单点深挖、7 天内容计划和口播脚本。第一轮仍然是初步判断，必须提示用户结合门店、销售、私域反馈校准。
+
+## token 和充值口径
+
+sample 模式不需要 token。live 模式需要 VOC-AI 数据服务 token。
+
+允许读取 token 的位置：
+
+- 本次请求参数
+- 当前工作区 `.env.local`
+- 系统环境变量
+- `~/.claude/voc-credentials.json`
+
+Claude Code 技能包不读取 `~/.openclaw/voc-credentials.json`。
+
+如果没有 token 或余额不足，应给用户充值/开通链接，不要暴露底层接口 403、权限堆栈或上游响应体：
+
+```text
+https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF
+```
+
+## 记忆能力
+
+趋势情报支持偏好记忆，适合记录“保留哪些方向、屏蔽哪些方向、下一轮关注什么”。
+
+问题池支持分桶记忆，适合记录同一客户/门店的已发现问题、状态和历史证据。
+连续更新同一个问题池时，会输出“问题变化”，对比上轮/本轮证据数，标记新增、变多、变少、持平或本轮未再出现的问题。
+
+单点 VOC 深挖支持分桶记忆。默认按 `project/brand/store + industry + scenario + audience` 隔离，避免不同客户、不同行业串味。
+当用户反馈“这个有效/无效”后，工具会记录动作验证次数，后续建议会优先推有效动作、降低无效动作，并解释为什么这样排序。
+
+示例：
+
+```text
+这个动作不适合我们，下次别推荐等位饮品。
+这个有效，后面优先做评论区回复和预点单。
+```
+
+工具会把反馈沉淀为偏好动作、屏蔽动作、验证有效动作或验证无效动作，让后续建议逐步贴近真实业务。
+
+## 发布前验证
+
+```powershell
+npm --prefix claude-code-voc-intelligence run mcp:smoke
+npm --prefix claude-code-voc-intelligence run smoke:package
+npm run claude-voc:build
+npm run claude-voc:npm-publish
+```
+
+真实采集不默认放入自动 smoke。发布前或课程现场前，按 `docs/live-manual-acceptance-checklist.md` 做一次小规模 live 验收。
+## VOC 口播脚本共创
+
+`voc-content-plan` 负责把 VOC 问题转成 7 天内容计划；`voc-speaking-script` 负责把其中一条选题继续打磨成能拍的口播稿。
+
+典型话术：
+
+```text
+选题 2，进入脚本共创。
+```
+
+```text
+开头更狠一点，老板视角，少讲概念，多给一个真实场景。
+```
+
+```text
+定稿，并把这个风格记住。以后少讲工具清单，多讲老板判断。
+```
+
+对应 MCP 工具：
+
+```text
+voc_speaking_script_run
+```
+
+它会输出 60 秒稿、30 秒压缩版、提词器版、标题备选、镜头建议、评论区引导和质量门槛，并把“保留/不要/定稿”等反馈写入脚本记忆。完整的抖音日更、对标账号监控、逐字稿拆解仍属于 `douyin-speaking-daily` 的深度能力；本包提供的是 VOC 到口播共创的轻量出口。