지식 베이스 구축 가이드. faq-builder와 manual-writer 에이전트가 FAQ, 트러블슈팅 가이드를 체계적으로 구성할 때 참조. 'FAQ 설계', '지식 관리', '트러블슈팅 가이드' 요청 시 사용. 단, 위키 시스템 구축은 범위 밖.
faq-builder / manual-writer 에이전트의 지식 체계화 역량 강화.
1단계: 사용자 여정 기반 분류
시작하기 → 기본 사용 → 고급 기능 → 트러블슈팅 → 관리
2단계: 각 카테고리 5~10개 질문
- 빈도 높은 순 정렬
- 질문은 사용자 언어로
3단계: 크로스 레퍼런스
- 관련 FAQ 간 링크
- 매뉴얼 해당 섹션 링크
## Q: [사용자가 실제로 묻는 형태의 질문]
**A:** [1~2문장 핵심 답변]
[필요 시 상세 설명]
**단계:**
1. [구체적 행동 1]
2. [구체적 행동 2]
3. [구체적 행동 3]
> 참고: [관련 매뉴얼 섹션 링크]
> 관련 질문: [관련 FAQ 링크]
| 규칙 | 설명 |
|---|
| 질문 = 사용자 언어 | 전문용어 아닌 일상 표현 |
| 답변 = 1줄 요약 + 상세 | 스캔하기 쉽게 |
| 1 FAQ = 1 주제 | 복합 질문은 분리 |
| 스크린샷/다이어그램 | 시각적 설명 포함 |
| 갱신 날짜 | 마지막 검증일 명시 |
flowchart TD
S([증상: X가 안 됩니다]) --> Q1{네트워크 연결 상태?}
Q1 -->|연결됨| Q2{로그인 상태?}
Q1 -->|안됨| FIX1[네트워크 확인 → 재시도]
Q2 -->|로그인됨| Q3{권한 있는가?}
Q2 -->|안됨| FIX2[재로그인]
Q3 -->|있음| FIX3[캐시 삭제 → 재시도]
Q3 -->|없음| FIX4[관리자에게 권한 요청]
## 문제: [증상 설명]
### 영향
- 영향 범위: [전체/부분/개인]
- 긴급도: [즉시/24시간/72시간]
### 원인 후보
| # | 원인 | 확률 | 확인 방법 |
|---|------|------|----------|
| 1 | [가장 흔한 원인] | 높음 | [확인 명령/방법] |
| 2 | [두 번째 원인] | 중간 | [확인 명령/방법] |
| 3 | [드문 원인] | 낮음 | [확인 명령/방법] |
### 해결 절차
**원인 1일 경우:**
1. [단계 1]
2. [단계 2]
3. 확인: [성공 기준]
### 에스컬레이션
- 30분 내 미해결 → [L2 담당자]
- 서비스 장애 → [긴급 연락처]
| 단계 | 활동 | 주기 |
|---|---|---|
| 생성 | 신규 절차/FAQ 작성 | 수시 |
| 검토 | 정확성/최신성 확인 | 분기 |
| 갱신 | 변경사항 반영 | 수시 |
| 폐기 | 불필요 문서 아카이브 | 연간 |
| 측정 | 조회수, 유용성, 피드백 | 월간 |
| 기법 | 설명 |
|---|---|
| 키워드 태깅 | 사용자 검색어 기반 태그 |
| 동의어 매핑 | "안 됨" = "오류" = "에러" |
| 카테고리 계층 | 최대 3단계 |
| 관련 문서 링크 | 상호 참조 5개 이내 |
| 요약 (Excerpt) | 검색 결과에 표시될 요약 |
| 항목 | 기준 |
|---|---|
| FAQ 수 | 카테고리당 5~10개 |
| 트러블슈팅 | 상위 10개 문제 커버 |
| 진단 트리 | 3단계 이내 해결 도달 |
| 에스컬레이션 | 시간 기준 명시 |
| 갱신 날짜 | 모든 문서에 표시 |