---
name: qna-triage
description: Use before sending questions to the customer — answers what the sources already decide (with citations), merges duplicates, drops out-of-scope questions, and builds one short batch of self-contained questions for the customer following the QnA-Log template. Used by BA (manual, create-spec Gate 1/2) and the PO Agent of Light-out Agents (qna:triage).
keywords: qna triage, question batch, customer questions, deduplicate, citations, PO agent, create-spec gate 2
---

# QnA Triage — lọc và gom lô câu hỏi gửi khách (KIT-32)

> **Ai dùng:** BA (manual) hoặc PO Agent (`qna:triage`, Light-out Agents).
> **Khi nào:** sau khi Analysis (G1) hoặc Readiness sinh câu hỏi, **trước** khi gửi khách. Human duyệt lô trước khi gửi.
> **Quy tắc câu hỏi:** `custom/rules/ba-question-rules.md` (Blocking/Non-blocking, phụ thuộc, chống hỏi thừa, chống hỏi trùng). **Format:** `custom/skills/ba-skills/skill-ba-qna-template-v1.md`.

---

## 1. Trả lời từ nguồn có sẵn

Nguồn: yêu cầu thô (`RAW-x`), câu trả lời đã Confirmed của khách (mọi chức năng), Glossary, business rule dùng chung, UC Spec đã ký.

- Câu đã có câu trả lời trong nguồn → **trả lời**, kèm trích dẫn (`RAW-3`, `CQ-002`, `Glossary#group`, `UC-Spec_v1.md#BR1.2`). **Không có trích dẫn thì không được coi là đã trả lời.**
- Câu suy ra được từ một quyết định đã chốt → xác nhận một lần (mục 3 "chống hỏi trùng" của quy tắc câu hỏi), không hỏi chi tiết lại.

## 2. Gộp, bỏ

- Gộp câu trùng hoặc chồng nhau thành một; ghi các câu gốc đã gộp.
- Bỏ câu ngoài phạm vi chức năng, kèm lý do.
- Câu không làm đổi nội dung output → không hỏi, ghi thành giả định `[PENDING]` (chống hỏi lấy số lượng).
- Câu phụ thuộc câu khác còn Open → trạng thái `Blocked-by QA-xx`, **không** đưa vào lô này.

## 3. Lập lô gửi khách

Mỗi câu trong lô:

- Tự chứa: người không đọc code hiểu được; tiêu đề `[Màn hình/Chức năng] Về {chủ đề}` (cụm danh từ).
- **Hiện trạng** (hệ thống đang làm gì) và **Bối cảnh** (vì sao bây giờ phải hỏi, chưa chốt thì ảnh hưởng gì) tách riêng.
- Một câu hỏi, ưu tiên câu hỏi đóng; các lựa chọn `A:`, `B:`… + `Khác / Chưa quyết định`, đề xuất kèm lý do.
- Nhãn 🔴 Blocking / 🟡 Non-blocking.
- Lô ngắn: chỉ những câu thực sự cần khách quyết.

## 4. Output

**Manual:** cập nhật `AK-Docs/02.BA-Specs/02.QnA/[functionId]/QnA-Log_vN.md` theo template; câu trả lời từ nguồn ghi `Nguồn:` là trích dẫn.

**Light-out Agents (`qna:triage`):** output có cấu trúc: `answeredFromSources[]` (questionRef, answer, citations), `batch[]` (question, blocking, options, fromQuestions, và nếu có: topic, screen, currentState, context, recommendation), `dropped[]` (questionRef, reason). Orchestrator ghi QnA-Log và tạo điểm Human "duyệt lô câu hỏi".
