도움말 센터 글 생성기 — 티켓을 문서로 전환 — Claude Skill

도움말 센터 글 생성기

지원 티켓을 셀프서비스 답변으로 바꿉니다. 반복 질문, 기능 문서, 제품 명세를 받아 티켓 양을 줄이는 도움말 센터 글을 생성합니다.

대상: 같은 20개 질문이 지원 티켓의 80%를 차지하지만 도움말 문서를 쓸 시간이 없는 초기 팀입니다. 목표는 오후 한 번의 글 생성으로 몇 달 동안 티켓을 줄이는 효과를 만드는 것입니다.

사용 시점

• "상위 지원 질문에 대한 도움말 센터 글을 작성해 줘"
• "이 지원 티켓을 FAQ 글로 바꿔 줘"
• "[feature] 문서를 생성해 줘"
• "우리 지식 기반을 구축해 줘"
• "지원 문의가 너무 많아. 셀프서비스 콘텐츠를 만들게 도와줘"

0단계: 입력 수집

콘텐츠 출처(하나 이상 제공)

1. 지원 티켓 내보내기 — 최근 티켓의 CSV/목록(제목, 설명, 해결 방법). 스킬이 이를 클러스터링해 가장 반복되는 주제를 찾습니다.
2. FAQ 목록 — 이미 상위 질문을 알고 있나요? 직접 제공하세요.
3. 기능 문서 — 고객용 글이 필요한 기능의 내부 문서, PRD, 명세입니다.
4. 제품 안내 흐름 — 워크플로를 단계별로 설명하면 스킬이 글을 생성합니다.
5. 개선할 기존 글 — 다시 작성해야 하는 현재 도움말 글의 URL 또는 텍스트입니다.

구성

6. 제품명 — 제품 이름은 무엇인가요?
7. 대상 독자 — 누가 읽나요? (기술 사용자, 비기술 사용자, 혼합)
8. 톤 — 캐주얼/친근함, 전문적, 기술/개발자 문서?
9. 글 구조 선호:
   • 표준 — 개요 → 단계 → 문제 해결 → 관련 글
   • 개발자 — 개요 → API 참조 → 코드 예시 → 오류
   • 빠른 시작 — 무엇 → 왜 → 방법(최대 3단계) → 다음
10. 스크린샷 규칙 — 스크린샷을 사용하나요? (스킬은 [Screenshot: description] 자리표시자를 삽입합니다)
11. 일괄 또는 단일? — 글 하나인가요, 아니면 티켓 내보내기에서 여러 글을 생성하나요?

1단계: 주제 클러스터링(일괄 모드)

티켓 내보내기가 제공되면 티켓을 글 주제로 클러스터링합니다.

클러스터링 방식

1. 유사도 기준 그룹화 — 제목/설명이 비슷한 티켓을 클러스터링합니다
2. 빈도순 순위화 — 가장 흔한 클러스터가 우선순위가 가장 높은 글입니다
3. 클러스터별 글 유형 식별:

클러스터 출력

주제 클러스터(티켓 빈도순):

1. [주제] — [N개 티켓] — 유형: [방법 안내]
   공통 표현: "[고객이 이 질문을 하는 방식]"
   해결 패턴: [지원팀이 보통 안내하는 내용]

2. [주제] — [N개 티켓] — 유형: [문제 해결]
   ...

3. ...

2단계: 글 생성

글 템플릿 — 방법 안내

# [행동 중심 제목 — 예: "이메일 연동 설정 방법"]

[1-2문장 개요: 이 글이 다루는 내용과 대상 독자]

**완료 시간:** [X분]
**사전 조건:** [시작 전에 필요한 것 — 예: "관리자 권한, API 키"]

---

## 1단계: [동작 동사 + 해야 할 일]

[이 단계를 설명하는 1-2문장]

[Screenshot: 사용자가 봐야 하는 화면 설명 — 예: "Integrations 탭이 강조된 Settings 페이지"]

> **팁:** [유용한 맥락 또는 지름길]

## 2단계: [동작 동사 + 해야 할 일]

[절차]

[Screenshot: 설명]

## 3단계: [동작 동사 + 해야 할 일]

[절차]

---

## 작동 확인

[설정이 성공했는지 확인하는 방법]

[Screenshot: 성공 상태 설명]

---

## 문제 해결

### [일반적인 문제 1]
**증상:** [사용자가 보는 것]
**원인:** [이 문제가 발생하는 이유]
**해결:** [단계별 해결 방법]

### [일반적인 문제 2]
**증상:** [...]
**원인:** [...]
**해결:** [...]

---

## FAQ

**Q: [일반적인 후속 질문]**
A: [답변]

**Q: [또 다른 일반 질문]**
A: [답변]

---

## 관련 글

- [[글 제목]] — [언제 읽어야 하는지 1줄 설명]
- [[글 제목]] — [...]

글 템플릿 — 문제 해결

# 수정: [문제 설명 — 예: "이메일이 전송되지 않음"]

[1-2문장: 이 문제가 언제 발생하는지]

---

## 빠른 해결

먼저 이것을 시도하세요(사례의 약 80% 해결):

1. [가장 흔한 해결 방법 — 1단계]
2. [2단계]
3. [확인]

---

## 그래도 해결되지 않으면

### 확인 1: [먼저 확인할 항목]
[확인 방법 + 살펴볼 내용]

✅ [예상 결과]이면 → 이 문제가 아닙니다. 확인 2로 이동하세요.
❌ [예상 밖 결과]이면 → [이 경우의 구체적 해결]

### 확인 2: [두 번째로 확인할 항목]
[확인 방법]

✅ 정상이라면 → 확인 3으로 이동하세요.
❌ 아니라면 → [해결]

### 확인 3: [세 번째로 확인할 항목]
[확인 방법]

✅ 정상이라면 → "아직 작동하지 않나요?"로 이동하세요.
❌ 아니라면 → [해결]

---

## 아직 작동하지 않나요?

위 방법으로 문제가 해결되지 않았다면:

1. [수집할 정보 — 예: "오류 메시지 스크린샷"]
2. [도움을 받을 위치 — 예: "위 정보를 포함해 [email protected]으로 이메일 보내기"]
3. [예상 응답 시간]

---

## 왜 이런 일이 발생하나요?

[궁금해하는 사용자를 위해 근본 원인을 설명하는 2-3문장. 선택 사항이지만 신뢰를 높입니다.]

## 관련 글

- [[글]] — [맥락]

글 템플릿 — 시작하기 / 빠른 시작

# [Feature/Product] 시작하기

[1문장: 이 안내가 끝나면 사용자가 할 수 있는 것]

**시간:** [X분] | **난이도:** [초급/중급]

---

## 필요한 것

- [사전 조건 1]
- [사전 조건 2]

---

## 1단계: [첫 번째로 할 일] (2분)

[명확한 절차]

[Screenshot: 설명]

## 2단계: [두 번째 작업] (3분)

[절차]

## 3단계: [세 번째 작업] (2분)

[절차]

---

## 준비 완료

[이제 할 수 있는 것]

**다음 단계:**
- [논리적인 다음 조치 — 다음 글 링크]
- [고급 사용자 팁 — 고급 글 링크]
- [커뮤니티 참여 — 해당되는 경우 링크]

3단계: 글 품질 점검

생성된 각 글에 대해 확인합니다.

• 제목이 행동 중심 — "방법", "수정:", "시작하기", "이해하기"로 시작
• 훑어보기 쉬움 — 제목, 번호 단계, 굵은 핵심 용어. 긴 텍스트 벽 없음.
• 완전함 — 성공 경로뿐 아니라 전체 워크플로를 다룸
• 문제 해결 포함 — 일반적인 실패 시나리오 최소 2개
• 전문 용어 없음 — 내부 용어가 아니라 고객의 언어 사용
• 스크린샷 자리표시자 — UI가 포함된 모든 단계에 자리표시자 있음
• 관련 글 링크 — 사용자가 도움말 센터 안에 머물도록 교차 참조
• 검색 친화적 — 제목과 첫 문단에 고객이 실제로 검색하는 키워드 포함

4단계: 출력

단일 글 모드

clients/<client-name>/customer-success/help-center/[article-slug].md에 저장합니다.

일괄 모드

저장 위치:

• clients/<client-name>/customer-success/help-center/ — 글마다 파일 하나
• clients/<client-name>/customer-success/help-center/_index.md — 범주가 포함된 목차

색인 템플릿

# 도움말 센터 — [제품명]
생성일: [DATE] | 글 수: [N]

## 시작하기
- [[getting-started-guide.md]] — 최초 설정 안내
- [[quick-start.md]] — 5분 빠른 시작

## 방법 안내
- [[how-to-setup-email.md]] — 이메일 연동 설정
- [[how-to-invite-team.md]] — 팀원 초대
- ...

## 문제 해결
- [[fix-emails-not-sending.md]] — 이메일이 전송되지 않음
- [[fix-login-issues.md]] — 로그인할 수 없음
- ...

## 참조
- [[api-rate-limits.md]] — API 제한과 할당량
- [[billing-plans.md]] — 요금제 비교와 결제 FAQ

비용

필요한 도구

없습니다. 도구 없이 추론만 사용하는 스킬로, 원시 입력을 받아 구조화된 글을 생성합니다.

트리거 문구

• "지원 티켓에서 도움말 센터 글을 작성해 줘"
• "[feature] 문서를 생성해 줘"
• "우리 지식 기반을 구축해 줘"
• "FAQ를 도움말 글로 바꿔 줘"
• "도움말 센터 글 생성기를 실행해 줘"