AI Skill Report Card
Diagnosing PHealer Incidents
Quick Start13 / 15
Given a ticket (site incident or bug report), produce this output immediately:
대상 구성요소: RabbitMQ
증상 요약: dead queue 가 존재하는 현상
진단 절차: (조사 중 — 2단계에서 상세화 예정)
Do not skip straight to root cause. Step 1 only establishes what broke and how it was observed.
Recommendation▾
Clarify this is 'step 1 of N' workflow explicitly with a pointer to what step 2 covers, since the skill references a larger multi-step process but only implements step 1 — risks confusion about scope.
Workflow13 / 15
Progress:
- Step 1: 일감 조사 (Investigate the ticket)
- 1-1. 증상 파악 — identify the symptom and the discovery path (alert, log, user report, monitoring dashboard, manual check, etc.)
- 1-2. 증상 명명 — name the symptom and bind it to the specific target component
- Step 2: 출력 형식에 맞춰 정리
1-1. 증상 파악 (Identify Symptom + Discovery Path)
Ask and answer:
- 무엇이 비정상인가? (What is abnormal?)
- 어떻게 발견되었는가? (alert/monitoring, 사용자 신고, 로그 확인, 수동 점검 중 발견 등)
- 발견 시점/빈도는? (최초 1회성인지, 반복되는지)
If the ticket lacks this info, infer from attached logs/screenshots first; only mark as "확인 필요" if truly unavailable — don't fabricate a discovery path.
1-2. 증상 명명 (Name Symptom + Target Component)
- 대상 구성요소는 가능한 한 구체적으로 특정한다 (e.g., "RabbitMQ"가 아니라 가능하면 "RabbitMQ - Queue A" 수준까지).
- 증상 요약은 한 문장, 현상 중심으로 기술한다 (원인 추정 금지 — 그건 다음 단계).
- 증상명은 재사용 가능한 패턴명처럼 짓는다 (예: "dead queue 존재", "connection pool exhaustion", "4노드 재부팅 후 불안정").
Recommendation▾
Consider adding an English translation or bilingual glossary for key terms since the skill mixes Korean content with English frontmatter/headers, which may reduce accessibility for non-Korean-reading reviewers.
Output Format
대상 구성요소: <component name>
증상 요약: <one-line symptom description, no root cause>
진단 절차: <investigation steps taken so far, or TBD if step 1 only>
Examples15 / 20
Example 1: Input: "사이트 일감 - RabbitMQ 큐에 메시지가 쌓이고 consumer가 처리하지 않는다는 신고. 모니터링 알람으로 발견됨." Output:
대상 구성요소: RabbitMQ
증상 요약: dead queue 가 존재하는 현상
진단 절차: 모니터링 알람을 통해 발견, 해당 큐의 consumer 상태 확인 필요
Example 2: Input: "4노드 구성 재부팅 이후 일부 서비스가 비정상 상태. 운영자가 수동 점검 중 발견." Output:
대상 구성요소: 4노드 클러스터 (서비스 레벨 미특정)
증상 요약: 재부팅 이후 서비스 안정화 실패 현상
진단 절차: 운영자 수동 점검을 통해 발견, 각 노드별 서비스 상태 개별 확인 필요
Example 3: Input: "버그 보고 - scale-out 실행 시 신규 노드가 클러스터에 조인되지 않음." Output:
대상 구성요소: Scale-out 모듈 (클러스터 조인 로직)
증상 요약: scale-out 실행 후 신규 노드 join 실패 현상
진단 절차: 버그 보고를 통해 발견, 신규 노드 로그 및 클러스터 membership 상태 확인 필요
Recommendation▾
Add an edge case example where the ticket is too vague to extract a component/symptom, showing the '확인 필요' fallback in practice rather than just describing it in prose.
Best Practices
- 한 티켓 = 한 증상. 여러 증상이 섞여 있으면 분리해서 각각 명명한다.
- 구성요소명은 팀 내 표준 명칭(예: RabbitMQ, 4노드 클러스터, scale-out 모듈)을 사용해 다음 단계(심화 진단)와 용어를 통일한다.
- 증상 요약에 "~때문에", "~로 인해" 같은 인과 표현이 있으면 그건 원인 추정이지 증상 기술이 아니다 — 제거할 것.
- 진단 절차는 "앞으로 할 일" 또는 "이미 한 일"을 명시적으로 구분해 적는다.
Common Pitfalls
- 증상 명명 단계에서 바로 근본 원인을 단정하지 말 것 (예: "RabbitMQ 설정 오류로 인한 dead queue" ❌ → "dead queue 존재 현상" ✅).
- 발견 경로를 생략하지 말 것 — 동일 증상이라도 발견 경로가 다르면 재현/검증 방법이 달라진다.
- 구성요소를 너무 포괄적으로 쓰지 말 것 (예: "시스템 전체" ❌, 가능한 한 세부 컴포넌트로 좁힐 것).