| name | ops-incident |
| description | Hướng dẫn triage incident, điều tra song song 3 hướng, tạo RCA template với 5 Whys. Trigger khi: user nói "có incident", "hệ thống bị lỗi production", "triage sự cố", "viết RCA", "root cause analysis", "on-call incident", hoặc gõ /ops-incident.
|
Skill: /ops-incident
Role: DevOps / On-call Engineer
Mục đích: Hướng dẫn triage incident, tạo RCA template, document bài học.
Hướng dẫn thực hiện
Bước 1 — Triage nhanh (KHÔNG dừng để hỏi, chạy ngay)
Khi incident xảy ra, triage theo thứ tự:
## INCIDENT TRIAGE
| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | IMPACT: Bao nhiêu user/service bị ảnh hưởng? | _(điền vào)_ |
| 2 | SEVERITY | A: P1 — down hoàn toàn / B: P2 — degraded / C: P3 — minor / D: Khác: ___ |
| 3 | STARTED: Lúc nào bắt đầu? | _(điền thời gian)_ |
| 4 | SYMPTOMS: Biểu hiện cụ thể? | _(điền vào)_ |
Bước 2 — Hỗ trợ Investigation
Dựa trên symptoms, đề xuất 3 hướng điều tra song song:
## Incident [INC-XXX] — P[N]
**Impact**: [Mô tả]
**Started**: [Time]
### 3 hướng điều tra ưu tiên:
**Hướng A**: [Giả thuyết 1] — Check: [command/dashboard cụ thể]
**Hướng B**: [Giả thuyết 2] — Check: [...]
**Hướng C**: [Giả thuyết 3] — Check: [...]
Tôi suggest bắt đầu với Hướng A vì [lý do].
Ai sẽ check Hướng nào?
Bước 3 — Tạo RCA Template
Sau khi incident được resolve, tạo docs/reports/INC-[XXX]-RCA.md dùng template templates/incident-report.md.
Điền vào:
- Frontmatter: incidentId, severity (P1-P4), startTime/endTime/durationMinutes, incidentCommander
- Tóm tắt: 2-3 câu — chuyện gì xảy ra, khi nào, ảnh hưởng user
- Ảnh hưởng: số user bị ảnh hưởng, tính năng bị ảnh hưởng, SLA impact, có notify khách JP không
- Timeline: timestamps thực tế từ incident; bao gồm detect → ack → tìm root cause → fix → resolved
- Root Cause: trigger event + phân tích 5 Whys + contributing factors
- Điều tốt / Cần cải thiện: blameless — focus vào hệ thống, không phải con người
- Action Items: tối thiểu AI-001 (prevent recurrence), AI-002 (improve detection), AI-003 (update runbook)
- Tài liệu hỗ trợ: link đến logs, dashboards, PR liên quan
Bước 4 — Gate cuối RCA
RCA draft hoàn thành.
Câu hỏi quan trọng:
| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | "5 Whys" — root cause [X] có đúng không? | A: Đúng / B: Còn layer sâu hơn — layer đó là: ___ / C: Khác: ___ |
| 2 | Action Items — AI-001 có realistic trong deadline không? | A: Có / B: Không — cần adjust: ___ / C: Khác: ___ |
| 3 | Có contributing factor nào bị bỏ sót không? | A: Không / B: Có — factor: ___ / C: Khác: ___ |
| 4 | Ai cần review RCA này trước khi share rộng? | _(điền tên)_ |
