Skip to main content
Glama

面向 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 check

npm 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,且仅此一处 — 它是一个你调节的阈值,而不是每次运行模型不同解释的段落。

技能

技能

功能

/voc-orchestrator

每周运行。包含所有六个阶段,带有预检查。

/voc-source-calls

从你的通话录音机拉取转录文本

/voc-analyze-calls

转录文本 → 潜在客户情报报告

/voc-source-reviews

G2、Capterra 等 → 消息简报。需要付费。

/voc-source-chat

你团队粘贴到 Slack 中的客户引用

/voc-source-notes

AI 会议笔记,用于录音机遗漏的对话

/voc-source-custom

调查、工单、CRM 邮件、任何其他内容

/voc-profiler

为单个信号附加 CRM 上下文和权重

/voc-synthesize

跨源确认

/voc-route

将每个主题发送到能采取行动的地方

/voc-dispatch

生成实际的可交付成果

设置

完整指南请参阅 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 中致谢。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Transforms 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.
    1
    MIT
  • F
    license
    Not graded
    quality
    F
    maintenance
    BackEngine 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 rolling
    1
    -