bug-reporter

name	bug_reporter
description	Skill chuẩn hóa bug reports — phân loại bug type/severity/priority, sinh steps to reproduce rõ ràng, format sẵn sàng paste vào Backlog.

Bug Reporter

Description

Skill này giúp QC viết bug reports chuẩn, đủ thông tin, không mơ hồ — đảm bảo DEV hiểu được ngay mà không cần hỏi lại.

---

When to Use

• Sinh bug report từ mô tả lỗi của QC
• Chuẩn hóa bug report đang viết dở
• Phân loại severity/priority cho bug
• Không dùng skill này để sinh test cases → dùng rbt_manual_testing

---

Bug Report Fields (Bắt buộc)

Field	Mô tả
Bug ID	Format: BUG-[MODULE]-[SỐ] (VD: BUG-LOGIN-001)
Tiêu đề	Ngắn gọn, rõ impact: [Màn hình] [Hành động] → [Kết quả sai]
Bug Type	Xem bảng phân loại Bug Type bên dưới
Environment	OS, Browser/App version, URL/Build, Test account
Severity	Xem bảng phân loại bên dưới
Priority	Xem bảng phân loại bên dưới
Steps to Reproduce	Đánh số, đủ precondition, test data cụ thể
Expected Result	Kết quả đúng theo spec/requirements
Actual Result	Kết quả thực tế quan sát được
Reproducibility	Always / Intermittent (x/y lần) / Only once
Evidence	Screenshot, video, console log (nếu có)
Root Cause Hint	Gợi ý nơi có thể xảy ra lỗi (optional)

---

Phân Loại Bug Type

#	Bug Type	Tiêu chí phân loại
1	UI Bug	Sai font, màu sắc, layout, căn lề, padding/margin, responsive không đúng, không khớp Figma/Spec. Không ảnh hưởng logic
2	Functional Bug	Chức năng không hoạt động đúng yêu cầu, sai logic nghiệp vụ, sai flow, lỗi lưu/cập nhật/hiển thị data
3	Validation Bug	Sai format input, sai required/optional, thiếu hoặc sai error message, sai min/max length, chấp nhận data không hợp lệ
4	Performance Bug	Phản hồi chậm, tốn thời gian tải, bị treo khi thao tác — thường kèm ngưỡng cụ thể (VD: >3s, >10s)
5	Compatibility Bug	Giao diện hoặc chức năng không đúng trên một số browser, OS, hoặc thiết bị cụ thể
6	Security Bug	Lỗ hổng cho phép truy cập trái phép, thay đổi data không qua xác thực, lộ thông tin nhạy cảm
7	REQ Bug	Thiếu mô tả validation, thiếu màn hình, thiếu logic/công thức/trạng thái trong requirement — lỗi thuộc về spec, không phải code
8	Design Bug	Design chưa đồng bộ (cùng template nhưng nhiều nơi khác nhau), thiếu states (hover, loading, empty, error, disabled), thiếu flow/animation

Phân biệt UI Bug vs Design Bug: UI Bug = implement sai so với design đã có. Design Bug = design thiếu/sai từ đầu, chưa có gì để implement theo.

Phân biệt Functional Bug vs Validation Bug: Validation Bug = lỗi tại lớp kiểm tra đầu vào (input field). Functional Bug = lỗi ở logic xử lý sau khi data đã pass validation.

---

Phân Loại Severity

Severity	Tiêu chí	Ví dụ
Critical	Crash app, mất data, không thể tiếp tục sử dụng	App crash khi submit form, payment bị trừ tiền 2 lần
Major	Tính năng chính không hoạt động, không có workaround	Không thể đăng nhập, không lưu được dữ liệu
Minor	Tính năng bị ảnh hưởng nhưng có workaround	Dropdown không sort đúng, filter sai một case
Trivial	Lỗi UI/UX, không ảnh hưởng logic	Typo, màu sắc sai, icon lệch

---

Phân Loại Priority

Priority	Tiêu chí
P1 (Urgent)	Blocker — cần fix trước khi release
P2 (High)	Ảnh hưởng user thường xuyên, cần fix trong sprint này
P3 (Medium)	Cần fix nhưng có thể defer sang sprint sau
P4 (Low)	Nice-to-have, cosmetic, không ảnh hưởng nghiệp vụ

Lưu ý: Severity và Priority độc lập. Trivial bug có thể là P1 (VD: typo trên nút "Xác nhận thanh toán").

---

Steps to Reproduce — Quy tắc viết

❌ Sai:
1. Mở trang
2. Nhập thông tin
3. Nhấn Submit → lỗi

✅ Đúng:
Precondition: Đăng nhập tài khoản [e-mail], đang ở trang /users/create

1. Điền field "Email" với giá trị: [e-mail]
2. Điền field "Tên" với giá trị: Nguyễn Văn A
3. Để trống field "Số điện thoại"
4. Nhấn nút "Tạo tài khoản"

Nguyên tắc:

• Precondition phải đủ để DEV reproduce ngay lần đầu
• Test data phải cụ thể — không dùng "nhập email hợp lệ"
• Mỗi step là 1 action duy nhất
• Step cuối là action trigger lỗi

---

Output Format

## [BUG-MODULE-001] Tiêu đề ngắn gọn

| Field | Nội dung |
|-------|---------|
| **Bug Type** | Functional Bug |
| **Severity** | Major |
| **Priority** | P2 |
| **Environment** | Chrome 124, macOS 14, https://staging.app.com, account: [e-mail] |
| **Reproducibility** | Always |

### Steps to Reproduce
**Precondition:** [trạng thái ban đầu]

1. [action 1]
2. [action 2]
3. [action trigger lỗi]

### Expected Result
[Kết quả đúng theo spec]

### Actual Result
[Kết quả thực tế]

### Evidence
[Screenshot / Video / Console log]

---

Anti-Patterns

• ❌ Steps mơ hồ ("nhập thông tin", "thực hiện thao tác")
• ❌ Không có precondition → DEV không reproduce được
• ❌ Gộp nhiều bugs vào 1 report
• ❌ Expected Result copy nguyên văn spec mà không diễn giải
• ❌ Actual Result chỉ ghi "lỗi" — phải mô tả chính xác điều gì xảy ra
• ❌ Nhầm lẫn Severity với Priority