Appearance
/debug
Debug vấn đề bằng cách xác định gap giữa kỳ vọng và thực tế.
Mô tả
Command này hướng dẫn debug có cấu trúc, từ xác định vấn đề đến đề xuất giải pháp.
Cách sử dụng
/debugQuy trình
Bước 1: Thu thập context
- Mô tả vấn đề
- Expected behavior
- Actual behavior + errors
- Recent changes
- Scope of impact
Bước 2: Làm rõ
- So sánh thực tế vs kỳ vọng
- Xác nhận requirements liên quan
- Định nghĩa tiêu chí fix thành công
Bước 3: Tái tạo
- Xác định reproducibility
- Ghi lại steps
- Xác định suspected components
Bước 4: Phân tích
- Brainstorm root causes
- Thu thập evidence (logs, metrics)
- Highlight unknowns
Bước 5: Đề xuất options
| Option | Pros | Cons | Risk |
|---|---|---|---|
| Quick fix | Fast | Tech debt | Low |
| Refactor | Clean | Time | Medium |
| Rollback | Safe | Lose feature | Low |
Bước 6: Xác nhận path
- Chọn option
- Plan validation steps
- Document next actions
Ví dụ
User: /debug
AI: Mô tả vấn đề bạn đang gặp?
User: API trả về 500 khi login với email có special characters
AI:
Expected: Login thành công với email hợp lệ
Actual: 500 Internal Server Error
Suspected: Input validation trong AuthService
Evidence: Error log shows "Invalid email format"
Options:
1. Fix regex pattern (Low risk)
2. Use email validation library (Medium effort)
Khuyến nghị: Option 1 - Fix regex pattern