Навыки Voice of Customer для Claude Code

VoC-пайплайн, который не сообщает о паттерне, пока несколько независимых каналов не согласуются. Извлекает данные из записей звонков, сайтов с отзывами, внутреннего чата, заметок с совещаний и любых других источников, которые вы подключите. Взвешивает каждый сигнал по тому, кто его высказал. Сообщает только то, что подтверждается. Направляет результат тому, кто может на него повлиять, с точными словами клиента.

Большинство рабочих процессов «ИИ для обратной связи с клиентами» останавливаются на этапе резюмируй это. Резюме сотни разговоров — это абзац, на который никто не реагирует, и человек по-прежнему остаётся узким местом. Это системная версия: сигнал поступает непрерывно, подтверждение применяется автоматически, человеческое внимание тратится только на оценочные суждения.

Что он выдаёт

Вот как выглядит результат. Названия компаний вымышлены, а цифры приведены для иллюстрации — это пример формата, а не реальный прогон.

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

Это последнее понижение и есть суть всей системы. Пять упоминаний проблемы выглядят как тренд, пока вы не заметите, что все они от одного и того же клиента. Этот пайплайн каждый раз проверяет распределение по аккаунтам в коде, чтобы никому не приходилось помнить об этом.

Что в этом не так

Прочтите это, прежде чем доверять любым его результатам.

• Правило подтверждения — это эвристика, а не проверка истины. Три канала могут отражать одно громкое мнение рыночного сегмента. Оно фильтрует шум, но не устанавливает факт.

• Каждый источник — это смещённая выборка. Звонки отдела продаж содержат только тех, кто согласился на встречу. Отзывы содержат только восторженных, разгневанных и тех, кто получил стимул. Чат содержит только то, что коллега счёл достаточно важным, чтобы вставить. Ни один из них не представляет весь ваш рынок.

• Добавление коннекторов облегчает подтверждение, но не делает его истиннее. Подключите шесть каналов — и вещи начнут подтверждаться, хотя не должны. Увеличивайте min_independent_sources при добавлении источников.

• Межканальные дубликаты создают ложную уверенность. Одна и та же жалоба, переданная в чате, записанная на звонке и оформленная как тикет, — это одно событие, а не три. Дедупликация происходит до профилирования, и если вы её пропустите, правило вас не спасёт.

• Он не может сказать то, о чём никто не говорил. Самая главная причина, по которой люди не покупают, обычно невидима для всех источников здесь.

Проверьте за тридцать секунд

git clone <this-repo> && cd voc-claude-skills
npm install
npm run check

npm run check проверяет frontmatter всех навыков, находит файлы skill.md в нижнем регистре, которые не работают на Linux, сканирует на наличие абсолютных путей и утёкших учётных данных, проверяет синтаксис каждого скрипта и подтверждает, что конфигурация пороговых значений парсится. Никаких учётных данных не требуется. Завершается с ненулевым кодом при ошибке, поэтому работает в 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 и больше нигде — это настраиваемый порог, а не абзац, который модель интерпретирует по-разному при каждом запуске.

Навыки

Настройка

Полное руководство в 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 на локальный, игнорируемый git путь. Не Dropbox, не iCloud. Оркестратор предупредит вас при предварительной проверке, но проверьте это сами.

• Законы о записи разговоров различаются в зависимости от юрисдикции. Этот инструмент предполагает, что у вас уже есть законные записи.

• Сообщите своей команде, что сбор данных из чата запущен.

• Публичный отзыв — это не разрешение на использование чьих-то слов в рекламе с их логотипом. Ничто в этом репозитории никогда не помечает цитату как одобренную.

Требования

Node 18+. Claude Code. Система записи звонков с API для расшифровок — единственная почти обязательная зависимость; всё остальное опционально.

Участие в разработке

Добавление адаптера для системы записи звонков — самый полезный вклад — см. scripts/providers/README.md, это четыре функции. Запустите npm run check перед открытием PR.

Лицензия

MIT. См. LICENSE.

Фреймворки, упомянутые в навыках, указаны в CREDITS.md.