Bug report viết sao để dev fix nhanh gấp đôi

Dev thường không chậm vì bug quá khó. Nhiều khi chậm vì ticket không tái hiện được.

Bug report tốt cắt vòng 「em không thấy」, 「chụp thêm đi」, 「môi trường nào vậy?」. Mục tiêu: dev mở ticket là bắt đầu sửa, không phải điều tra thêm hai giờ.

Dành cho: QA, BA, PM, hoặc dev tự log bug — ai viết ticket cũng nên đọc.

Ý chính: Một report đủ ngữ cảnh có thể rút ngắn thời gian fix tới một nửa.

Template · Copy vào Jira / Linear / GitHub

## [Module] Mô tả ngắn hành vi sai

**Môi trường**
- URL:
- Build / version:
- Trình duyệt + hệ điều hành:
- Tài khoản / quyền:

**Các bước tái hiện**
1.
2.
3.

**Kết quả mong đợi**
...

**Kết quả thực tế**
...

**Tần suất:** luôn | thường xuyên | một lần
**Mức độ đề xuất:** S1–S4 + lý do (1 dòng)
**Ảnh hưởng:** ai bị, bao nhiêu người, có cách tạm không
**Đính kèm:** screenshot, video, HAR, request id

Ví dụ · Report tệ vs report tốt

Không đạt

「Trang checkout lỗi, fix gấp.」

Dev phải hỏi lại: trình duyệt nào? user nào? trắng trang, 500, hay nút bị disable?

Đạt

[Checkout] Safari mobile — đã Paid nhưng UI vẫn Pending

• Môi trường: staging, build 512bd8d, iPhone 15 / Safari 17, buyer@test.local
• Các bước: Đăng nhập → Giỏ 1 sản phẩm → Thanh toán 4242… → Redirect /orders → Refresh ngay
• Mong đợi: Đơn #1234 chuyển Paid trong 30 giây
• Thực tế: Pending sau 2 phút; Network: webhook 200 nhưng GET /orders vẫn pending
• Tần suất: 3/3 lần khi refresh sớm trên mobile
• Ảnh hưởng: user tưởng chưa trả tiền; ~5 ticket support/tuần

Cùng một bug — thời gian fix có thể khác gấp đôi.

Quy trình · AI soạn nháp, QA duyệt

1. QA ghi ghi chú thô lúc đang test (bullet, không cần đẹp).
2. Dán vào AI với prompt:

Từ ghi chú QA bên dưới, viết bug report gồm:
Tiêu đề, Môi trường, Các bước, Mong đợi, Thực tế, Mức độ, Ảnh hưởng.
Không thêm bước không có trong ghi chú.

Ghi chú:
[dán tại đây]

3. QA rà soát ~2 phút: bước đúng chưa, mức độ hợp lý chưa, có lộ dữ liệu nhạy cảm không.
4. Giao cho dev.

AI tiết kiệm 10–15 phút format. QA vẫn ký tên — chỉ QA nắm đủ ngữ cảnh.

Bảng mức độ nhanh (đỡ tranh cãi)

Một câu ảnh hưởng rõ ràng quan trọng hơn tranh priority trừu tượng.

Đính kèm đáng giá

• Screenshot có URL và thời gian trên thanh địa chỉ
• Video dưới 30 giây, một lần tái hiện
• HAR hoặc request id nếu liên quan API
• Dòng lỗi console copy nguyên văn

Tránh gửi 40 ảnh không thứ tự.

Checklist · Dev đọc xong cần gì?

Trước khi submit, QA tự hỏi:

• Dev reproduce được mà không hỏi thêm?
• Biết module nào có khả năng liên quan?
• Biết tiêu chí 「xong」 khi fix?

Ba ô tick — report đạt.

---

Lưu template vào snippet. Lần sau đo thử: từ mở ticket đến dev comment 「reproduce được」 mất bao lâu?