voc-claude-skills
面向 Claude Code 的客户之声技能
一个 VoC 管道,在多个独立渠道达成一致之前拒绝报告模式。 从通话录音、评论网站、内部聊天、会议记录以及你连接的任何其他内容中提取。根据说话者身份对每个信号进行加权。仅报告经过验证的内容。将结果路由给能够采取行动的人,并附上客户的原始话语。
大多数"AI 用于客户反馈"的工作流止步于总结此内容。一百次对话的总结只是一段没人会采取行动的段落,人类仍然是瓶颈。这是系统版本:信号持续输入,确认自动应用,人类的注意力只用于判断决策。
输出内容
以下是输出格式。公司名称是虚构的,数字仅供说明 — 这是格式示例,不是实际运行。
SYNTHESIS — rule: 3+ independent channels, or 2+ with a tier-A account. Minimum 3 mentions.
──────────────────────────────────────────────────────────────────────────────
34 clusters in → 6 confirmed · 9 watchlist · 19 dropped
CONFIRMED
[HIGH ] Export is slow on large datasets
pain · 11 mentions · 3 channels (call, review, chat) · 7 accounts · A:2 B:8 C:1
3 independent channels
+4 unattributed signal(s) excluded from the count
[HIGH ] Cannot buy without SSO
request · 6 mentions · 2 channels (call, ticket) · 4 accounts · A:2 B:4
2 channels including a tier-A account
[MEDIUM] Onboarding felt long
pain · 5 mentions · 2 channels · 1 account · B:5
2 channels, no tier-A contributor — downgraded: all mentions from one
account (Northwind Trading)
WATCHLIST (single channel — not reported, kept for corroboration)
· Reporting filters are confusing (review, 3 mentions)
DROPPED (19) — kept in 2026-04-26-dropped.json for traceability最后那个降级就是整个事情的关键。五次提到某个痛点看起来像是一个趋势,直到你注意到它们都来自同一个客户。这个管道会在代码中检查账户分布,每次如此,所以没人需要记住去做。
Related MCP server: Feedback Synthesis MCP
这个的不足之处
在相信它输出的任何内容之前,请阅读以下内容。
确认规则是一种启发式方法,而非事实检验。 三个渠道可能都反映了同一个喧闹的市场细分。它能过滤噪音,但无法确立事实。
每个来源都是有偏样本。 销售电话只包含参加会议的人。评论只包含满意、愤怒或受激励的人。聊天只包含同事认为值得粘贴的内容。这些都不是你的市场。
添加连接器使确认更容易,而非更真实。 连接六个渠道,原本不应该确认的事情也开始确认。添加来源时请提高
min_independent_sources。跨源重复会制造虚假信心。 同一个投诉在聊天中转发、在通话中捕捉、并作为工单提交,这是一个事件,不是三个。去重发生在分析之前,如果你跳过它,规则也无法拯救你。
它无法告诉你没人说过的话。 人们不购买的最大原因通常对这里的每个来源都是不可见的。
三十秒验证
git clone <this-repo> && cd voc-claude-skills
npm install
npm run checknpm run check 验证每个技能的前置元数据,捕获在 Linux 上会出问题的小写 skill.md 文件,扫描绝对路径和泄露的凭据,对每个脚本进行语法检查,并确认阈值配置可解析。无需凭据。失败时返回非零退出码,因此可在 CI 中使用。
然后,在尚未配置任何内容的情况下:
node scripts/synthesize.js examples/clusters.sample.json --out /tmp/voc-demo它会针对样本集群运行实际的确认规则,并精确显示哪些内容确认了、哪些进入监视列表、哪些被丢弃。这是系统的核心,无需 API 密钥即可运行。
架构
calls · reviews · chat · notes · custom
│
▼
/voc-source-* normalize to one signal shape
│
▼
/voc-profiler CRM context, ICP fit, weight tier
│ (tier U = unattributed = quarantined)
▼
/voc-synthesize cluster by meaning (subagents)
│ apply the rule (code)
▼
/voc-route testimonial · case study · objection map
│ product feedback · exec memo
▼
/voc-dispatch outreach emails · copy briefs
PM one-pagers · exec memo聚类是判断,所以由模型完成。计数不是判断,所以由代码完成。 确认规则位于 scripts/synthesize.js 中,读取 config/thresholds.json,且仅此一处 — 它是一个你调节的阈值,而不是每次运行模型不同解释的段落。
技能
技能 | 功能 |
| 每周运行。包含所有六个阶段,带有预检查。 |
| 从你的通话录音机拉取转录文本 |
| 转录文本 → 潜在客户情报报告 |
| G2、Capterra 等 → 消息简报。需要付费。 |
| 你团队粘贴到 Slack 中的客户引用 |
| AI 会议笔记,用于录音机遗漏的对话 |
| 调查、工单、CRM 邮件、任何其他内容 |
| 为单个信号附加 CRM 上下文和权重 |
| 跨源确认 |
| 将每个主题发送到能采取行动的地方 |
| 生成实际的可交付成果 |
设置
完整指南请参阅 docs/SETUP.md。简短版本:
cp .env.example .env # call recorder + tokens
cp .mcp.json.example .mcp.json # MCP servers
cp context/product-context.example.md context/product-context.md然后填写 product-context.md。大约需要二十分钟,这是有用输出与通用主题之间的区别。
你不需要全部。 管道只需一个来源即可运行,并诚实地告诉你没有任何内容能达到高置信度。从通话开始,添加聊天,然后评论。
连接任何 MCP 服务器后,运行 /mcp 并将确切的工具名称复制到相关技能的 allowed-tools 中。 同一产品的不同服务器之间工具命名空间不同,如果一个技能声明了你的服务器未暴露的名称,它会在第一次调用时失败,同时看起来像是运行过。这是最常见的设置失败原因,远远超过其他原因。
成本
除了评论挖掘(使用付费爬虫)外,一切都是免费的。一次四域运行通常花费 2 到 8 美元。Apify 的免费层级是总计 5 美元的额度,不是每月 — 一次大范围运行可能消耗完。在首次评论运行前请参阅 docs/COST.md。
隐私
此管道将客户对话转录写入磁盘。根据 GDPR 和 CCPA,这些属于个人数据。
将
VOC_OUTPUT_DIR指向一个本地、已 gitignore 的路径。不要用 Dropbox,不要用 iCloud。编排器的预检查会警告你,但请自行检查。录音法律因司法管辖区而异。此工具假设你已经拥有合法录音。
告知你的团队聊天采集正在运行。
公开评论并非允许将某人的话连同其标志放入广告中。此仓库中的任何内容都不会将引用标记为已批准。
要求
Node 18+、Claude Code。带有转录 API 的通话录音机是几乎必需的依赖项;其他都是可选的。
贡献
添加通话录音机适配器是最有用的贡献 — 请参阅 scripts/providers/README.md,它包含四个函数。在提交 PR 之前运行 npm run check。
许可证
MIT。请参阅 LICENSE。
技能中引用的框架在 CREDITS.md 中致谢。
This server cannot be deployed
Maintenance
Related MCP Connectors
Analyze customer feedback at scale — reviews, surveys, calls. AI-powered themes and sentiment.
- SquadOAuthai.meetsquad
Decision intelligence for product teams. Turn scattered feedback into signal you can act on.
Run in-product voice interviews with AI agents and analyze source-linked evidence.
- EvermuseOAuthcom.evermuse
Search your customer interviews, calls, feedback, competitor intel and roadmap from any AI agent.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceTransforms scattered customer feedback from sources like Slack, Zoom, and JIRA into actionable product insights and AI-generated PRDs. It features over 50 tools for semantic clustering, sentiment analysis, and VOC-based prioritization to streamline product management workflows.1MIT
- AlicenseAqualityDmaintenanceMCP server that synthesizes user feedback from multiple sources into actionable insights. Aggregates reviews, support tickets, and survey responses to identify patterns and priorities.4MIT
- FlicenseNot gradedqualityFmaintenanceBackEngine is a multi-tenant SaaS platform that ingests all of an organization's customer and prospect communications — Slack threads, emails, call and meeting transcripts, and support tickets — and distills them into structured, queryable context. Raw conversations are processed into signals (categorized, attributed moments), sources (the underlying transcripts, emails, and tickets), and rolling1-
- FlicenseNot gradedqualityBmaintenanceEnables collection and scoring of sales chat conversations via CDP, computing response times and generating evidence-linked LLM quality reviews.-