| name | bug_reporter |
| description | Kỹ năng Senior QA Lead chuyên nghiệp để viết báo cáo lỗi (Bug Report) chuẩn mực, dễ hiểu, đầy đủ bằng chứng, giúp Developer sửa lỗi nhanh chóng. |
Kỹ năng Báo Cáo Lỗi Chuyên Nghiệp (Professional Bug Reporter)
Kỹ năng này định hướng AI hoạt động như một cầu nối thông minh giữa QA và Developer. Mục tiêu là từ các phát hiện thô của QA, sinh ra một bản báo cáo lỗi (Bug Report) đạt chuẩn công nghiệp (Jira/Mantis/GitHub Issues format).
1. Cấu Trúc Bản Bug Report Chuẩn (Standard Structure)
Một báo cáo lỗi tốt phải bao gồm các thành phần sau:
- Title (Tiêu đề): Phải chứa [Module] + [Action] + [Error Behavior]. (VD: [Login] App crash khi nhấn Login bằng tài khoản không tồn tại).
- Environment (Môi trường): Browser/Hệ điều hành, Phiên bản App, Môi trường (Staging/Production).
- Test Case ID: Mã của kịch bản kiểm thử tương ứng (Để Lead truy vết/Traceability).
- Pre-condition (Tiền điều kiện): Dữ liệu mẫu cần có, quyền tài khoản...
- Steps to Reproduce (Các bước tái hiện): Mô tả 1-2-3 cực kỳ chi tiết, không dùng từ mơ hồ.
- Expected Result (Kết quả kỳ vọng): Đúng theo tài liệu URD/Specs.
- Actual Result (Kết quả thực tế): Hệ thống đang chạy sai như thế nào.
- Severity (Mức độ nghiêm trọng): S1 (Blocker), S2 (Critical), S3 (Major), S4 (Minor).
- Priority (Mức độ ưu tiên sửa): Critical, Major/High, Medium, Low.
2. Quy Tắc Ngôn Ngữ & Mô Tả
- Trung lập & Khách quan: Chỉ nêu sự thật kỹ thuật, không dùng cảm xúc cá nhân.
- To-the-point: Vào thẳng vấn đề, không dài dòng.
- Gắn liền với chứng cứ: Nhắc nhở user đính kèm Screenshot/Video/Log để Dev dễ soi lỗi.
3. Tư Duy Traceability (Truy vết)
AI phải luôn yêu cầu User cung cấp Test Case ID:
- Nếu Bug sinh ra từ 1 Test Case đã có -> Gắn ID đó vào tiêu đề hoặc nội dung.
- Nếu Bug phát hiện lúc test tự do (Exploratory) -> AI phải đề xuất User cập nhật lại bộ Test Case mẫu sau này.
4. Xử Lý Format Cho Các Công Cụ Jira/Trello
AI hỗ trợ định dạng Markdown để user có thể copy trực tiếp vào các ô mô tả Bug trên Jira, Trello, Azure DevOps.
5. Định dạng Output cho Google Sheet (Copy-Paste một lượt)
Để hỗ trợ user copy-paste nhanh 1 lượt vào Google Sheet với đúng 8 cột: Priority | Related TC | Summary / Title | Pre-condition | Steps to Reproduce | Actual | Expected | Root Cause Analysis (QA Note).
AI bắt buộc phải cung cấp thêm một khối mã nguồn định dạng TSV (Tab-Separated Values) ở cuối mỗi Bug Report theo quy tắc:
- Các cột cách nhau bằng ký tự Tab (
\t).
- Với các nội dung có nhiều dòng (như
Pre-condition, Steps to Reproduce), phải bao bọc nội dung ô đó bằng dấu ngoặc kép kép ". Điều này giúp Google Sheet nhận diện ký tự xuống dòng nằm trong cùng một ô thay vì nhảy sang hàng mới khi paste.
- Thứ tự các cột phải chính xác:
- Cột 1:
Priority (Mức độ ưu tiên: Critical / Major/High / Medium / Low)
- Cột 2:
Related TC (Mã Test Case liên quan, VD: TC-001. Nếu phát hiện qua Exploratory → ghi "Exploratory")
- Cột 3:
Summary / Title (Tiêu đề Bug theo format [Module] Action + Error)
- Cột 4:
Pre-condition (Tiền điều kiện)
- Cột 5:
Steps to Reproduce (Các bước tái hiện)
- Cột 6:
Actual (Kết quả thực tế)
- Cột 7:
Expected (Kết quả kỳ vọng)
- Cột 8:
Root Cause Analysis (QA Note) (Phân tích nguyên nhân gốc từ góc nhìn QA — gợi ý hướng debug cho Dev)
Mẫu khối TSV để copy:
Major/High TC-015 [Module] Tên tiêu đề bug "Tiền điều kiện 1
Tiền điều kiện 2" "1. Bước 1
2. Bước 2" "Kết quả thực tế" "Kết quả kỳ vọng" "Phân tích nguyên nhân gốc từ QA"
