# 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 @gangvy/claude-code-voc-intelligence@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 @gangvy/claude-code-voc-intelligence claude-voc install --smoke ``` 或免全局安装： ```powershell npx --yes @gangvy/claude-code-voc-intelligence@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 到口播共创的轻量出口。