고객 음성(VoC) 스킬 for 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

마지막 등급 하락이 전체의 핵심입니다. 다섯 번의 불만 언급이 추세처럼 보이지만, 모두 동일한 고객임을 알게 되면 그렇지 않습니다. 이 파이프라인은 매번 코드에서 계정 분포를 확인하므로 누구도 기억할 필요가 없습니다.

이 시스템의 한계

출력 결과를 신뢰하기 전에 이 내용을 읽어보십시오.

• 확인 규칙은 휴리스틱이며, 진실을 검증하는 도구가 아닙니다. 세 개의 채널이 모두 하나의 큰 시장 세그먼트를 반영할 수 있습니다. 노이즈를 필터링할 뿐, 사실을 확립하지는 않습니다.

• 모든 소스는 편향된 표본입니다. 영업 통화에는 미팅에 참석한 사람만 포함됩니다. 리뷰에는 만족한 사람, 분노한 사람, 인센티브를 받은 사람만 포함됩니다. 채팅에는 동료가 붙여넣기할 만큼 주목할 만하다고 생각한 내용만 포함됩니다. 이 중 어느 것도 시장 전체를 대표하지 않습니다.

• 커넥터를 추가하면 확인이 더 쉬워질 뿐, 더 정확해지지 않습니다. 여섯 개의 채널을 연결하면 확인되어서는 안 될 내용도 확인되기 시작합니다. 소스를 추가할 때 min_independent_sources 값을 높이십시오.

• 소스 간 중복은 자신감을 인위적으로 높입니다. 채팅에서 전달되고, 통화에서 캡처되고, 티켓으로 접수된 동일한 불만은 하나의 이벤트이지 세 개가 아닙니다. 중복 제거는 프로파일링 전에 이루어지며, 이를 생략하면 규칙이 당신을 구할 수 없습니다.

• 아무도 말하지 않은 것을 알려줄 수 없습니다. 사람들이 구매하지 않는 가장 큰 이유는 일반적으로 여기 있는 모든 소스에 보이지 않습니다.

30초 만에 확인하기

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

npm run check는 모든 스킬의 프론트매터를 검증하고, Linux에서 문제를 일으키는 소문자 skill.md 파일을 잡아내며, 절대 경로와 유출된 자격 증명을 스캔하고, 모든 스크립트의 구문을 검사하며, 임계값 설정이 파싱되는지 확인합니다. 자격 증명이 필요하지 않습니다. 실패 시 0이 아닌 종료 코드를 반환하므로 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를 작성하십시오. 약 20분이 소요되며, 유용한 출력과 일반적인 테마를 구분하는 핵심 요소입니다.

모든 것이 필요하지는 않습니다. 파이프라인은 하나의 소스로도 실행되며, 높은 신뢰도에 도달할 수 없다는 점을 정직하게 알려줍니다. 통화로 시작하고, 채팅을 추가하고, 그다음 리뷰를 추가하십시오.

MCP 서버를 연결한 후에는 /mcp를 실행하고 정확한 도구 이름을 관련 스킬의 allowed-tools에 복사하십시오. 동일한 제품에 대해 서버마다 도구 네임스페이스가 다르며, 서버가 노출하지 않는 이름을 선언한 스킬은 첫 번째 호출에서 마치 실행된 것처럼 보이다가 실패합니다. 이는 가장 흔한 설정 오류입니다.

비용

유료 스크래퍼를 실행하는 리뷰 마이닝을 제외한 모든 것은 무료입니다. 4개 도메인 실행은 일반적으로 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에 명시되어 있습니다.