# Skill: Xử lý và Thiết kế Q&A (Q&A Specification) - Phiên bản v1

## 1. Mục đích (Purpose)
Kỹ năng này giúp BA thiết kế các câu hỏi rõ ràng, khách quan và chuyên nghiệp để gửi tới khách hàng/stakeholders nhằm làm rõ các khoảng trống nghiệp vụ (Gaps). Đồng thời, hướng dẫn cách tiếp nhận câu trả lời để cập nhật tài liệu phân tích một cách nhất quán, tránh hiểu sai hoặc tự ý giả định thông tin.

Ngôn ngữ output: auto-detect theo ngôn ngữ của ticket/task input — xem `custom/rules/output-language.md` (input tiếng Việt → output tiếng Việt; ngược lại mặc định tiếng Anh).

Thuật ngữ nghiệp vụ: bắt buộc theo `custom/rules/domain-terminology.md` — đọc `AK-Docs/00.Project-Overview/Glossary.md` trước khi soạn câu hỏi đầu tiên, gặp từ thiếu thì hỏi user rồi ghi ngược vào file đó.
Động từ thao tác UI và thuật ngữ IT: bắt buộc theo `custom/rules/ui-action-wording.md` (kế thừa `qa-writing-standards.md` mục 6.11) — câu mô tả thao tác dùng động từ chuẩn (`Click button`, `Click menu item`, `Enter <value> into <field>`, `Select`, `Check`, `Open modal`, `Press Enter`…), câu mô tả kết quả dùng trạng thái chuẩn (`Displayed`, `Enabled` / `Disabled`, `Checked`…), thuật ngữ IT giữ tiếng Anh (field, button, toast, modal, server, cache, redirect, validate…); không viết "bấm", "nhấn", "tích chọn", "chọn tay", "máy chủ", "bộ nhớ đệm". Câu mô tả nghiệp vụ vẫn viết tiếng Việt.

## 2. Kiến thức cần có (Prerequisite Knowledge)
- **Kỹ năng giao tiếp bằng văn bản (Written Communication):** Sử dụng câu từ ngắn gọn, lịch sự, đi thẳng vào vấn đề.
- **Kỹ thuật đặt câu hỏi mở và đóng:**
    - Tránh câu hỏi mập mờ (ví dụ: "Hệ thống có cần khóa tài khoản không?").
    - Nên đưa ra các tùy chọn rõ ràng (ví dụ: "Khi nhập sai mật khẩu liên tiếp, hệ thống sẽ xử lý thế nào? Tùy chọn A: Khóa tài khoản sau 5 lần sai trong 30 phút. Tùy chọn B: Chỉ hiển thị thông báo lỗi mà không khóa tài khoản. Tùy chọn C: Ý kiến khác...").
- **Tư duy kiểm thử (Testing Mindset):** Đứng dưới góc nhìn của Tester để hỏi về các biên dữ liệu, các trường hợp lỗi mạng, mất kết nối cơ sở dữ liệu, hoặc dữ liệu không hợp lệ.

## 3. Quy trình thực hiện (Step-by-step Process)
- **Bước 1: Chuyển đổi Gap thành câu hỏi Q&A:**
  Từ danh sách khoảng trống phát hiện ở bước Phân tích ban đầu, chuyển mỗi dòng thành một câu hỏi Q&A cụ thể. Số lượng câu hỏi phải phản ánh đúng số Gap thực tế — không tự giới hạn theo một số cố định (ví dụ luôn dừng ở 5-6 câu) bất kể yêu cầu đơn giản hay phức tạp. Nếu phát sinh Gap mới trong lúc soạn câu hỏi (đọc kỹ hơn thấy còn điểm mơ hồ), bổ sung ngay câu hỏi mới, không bỏ qua để "gọn danh sách".
- **Bước 2: Gắn nhãn mức độ ảnh hưởng (Blocking/Non-blocking):**
  Trước khi chuẩn hóa câu hỏi, gắn nhãn:
  - 🔴 **Blocking** — ảnh hưởng cấu trúc dữ liệu, luồng chính (happy path), phân quyền/bảo mật, hoặc quyết định kiến trúc khó đảo ngược sau khi code.
  - 🟡 **Non-blocking** — chi tiết UI/text, giá trị mặc định có thể đổi sau, alternative/exception flow hiếm gặp.
  Nhãn này quyết định câu hỏi có bắt buộc phải Confirmed trước khi qua gate tiếp theo hay được phép defer.
- **Bước 2.5: Dựng bản đồ phụ thuộc và lọc câu hỏi thừa:**
  Trước khi hỏi câu đầu tiên, điền trường `Phụ thuộc` cho từng câu: `—` (độc lập) hoặc `QA-xx` (chỉ trả lời được sau khi QA-xx Confirmed). Dấu hiệu phụ thuộc: câu hỏi chi tiết hoá một quyết định phạm vi/rule của QA-xx, hoặc tập Option của nó đổi theo đáp án QA-xx.
  Sắp thứ tự hỏi theo topo: câu cha trước câu con; trong cùng mức, 🔴 Blocking trước 🟡 Non-blocking.
  Trước mỗi câu, kiểm tra đủ 3 điều kiện mới được hỏi:
  - (a) Chưa được trả lời ở QnA-Log version trước, trong tài liệu phân tích, hoặc trong chính câu trả lời vừa nhận.
  - (b) Mọi câu cha đã **Confirmed**. Câu cha còn Open → ghi trạng thái **`Blocked-by QA-xx`**, KHÔNG hỏi, dùng chung marker `[PENDING - QA-xx]` của câu cha.
  - (c) Đáp án làm đổi nội dung Analysis / UI Prototype / UC Spec / test case. Nếu chỉ đổi câu chữ hiển thị hay một giá trị mặc định chỉnh được sau → không hỏi, ghi thành Assumption kèm marker `[PENDING]`.

  Trượt điều kiện nào thì bỏ qua câu đó và ghi lý do vào QnA-Log (`Đã trả lời tại QA-xx` / `Blocked-by QA-xx` / `Assumption — không hỏi`). Cấm tách nhỏ hoặc diễn đạt lại một câu bị chặn để hỏi lách.

- **Bước 2.6: Chống hỏi trùng — suy ra từ quyết định đã chốt:**
  Duy trì bảng **"Quyết định đã chốt + hệ quả suy ra"**: sau mỗi câu trả lời, ghi quyết định kèm các hệ quả suy ra trực tiếp. Ví dụ "Không retry khi gửi thất bại" suy ra: không có số lần retry, không có khoảng cách giữa các lần retry, không retry cho các kênh khác trong cùng luồng gửi, không có màn hình theo dõi retry. Hệ quả suy ra là **một phần của câu trả lời**, không phải câu hỏi mới.
  So khớp câu hỏi sắp gửi với bảng này theo **ý định nghiệp vụ**, không theo chữ — `retry` = `gửi lại` = `thử lại` = `chạy lại`; `khoá tài khoản` = `tạm ngưng đăng nhập`. Trùng ý định → không hỏi, ghi `Suy ra từ QA-xx: <nội dung suy ra>`, trạng thái **Confirmed**.
  Không chắc đáp án cũ có bao phủ hay không → hỏi **đúng một câu xác nhận yes/no** (`Xác nhận nhanh: theo QA-xx đã chốt "<quyết định>", suy ra "<hệ quả>". Đúng không?`), một lần duy nhất, thay vì soạn câu hỏi mới.
  Số lượng câu hỏi **không phải** thước đo chất lượng phân tích — cấm thêm câu hỏi để danh sách trông đầy đủ hoặc để "phòng hờ". Nếu BA/khách hàng hỏi ngược "câu này có cần thiết không?" → đó là tín hiệu đã vi phạm quy tắc này: trả lời thẳng, rút câu hỏi nếu suy ra được (`Rút — suy ra từ QA-xx`), và rà lại toàn bộ câu chưa hỏi trước khi hỏi tiếp.

- **Bước 3: Chuẩn hóa câu hỏi theo mẫu `@skill-ba-qna-template-v1.md` — viết cho người không chuyên kỹ thuật:**
  - Xác định phân vùng nghiệp vụ (Module/Screen).
  - **Mỗi câu hỏi là một khối, không dùng bảng.** Bảng nhiều cột buộc người đọc quét ngang mới ghép được nghĩa một câu hỏi, và cột nào cũng hẹp nên chữ xuống dòng vụn. Khối gồm: tiêu đề `Q{n}. [Màn hình/Chức năng] Về {chủ đề}` → hai dòng thông tin → các mục `Hiện trạng:`, `Bối cảnh:`, `Vấn đề:`, `Câu hỏi:`, `Lựa chọn và đề xuất:`, `Ví dụ minh họa:`, `Câu trả lời:` → ba dòng `Người trả lời:`, `Ngày trả lời:`, `Nguồn:`.
  - **Trình bày như người viết tay** (mẫu ở `@skill-ba-qna-template-v1.md`): tên mục in đậm, kết bằng `:`, **không đánh số**. Mỗi mục cách mục sau đúng 1 dòng trống, không có dòng trống giữa tên mục và nội dung. Nội dung thụt **4 dấu cách**, mỗi ý một dòng, **không** dùng bullet `・` hay `-`. Mọi dòng trong cùng một khối, trừ dòng cuối, kết thúc bằng 2 dấu cách để khi render markdown không bị gộp dòng.
  - **Hai dòng thông tin viết như người nói:** dòng 1 `QA-01 ・ 🔴 Blocking ・ Đã chốt (Confirmed)` — trạng thái tiếng Việt, giữ từ khoá gốc trong ngoặc (`Đang chờ trả lời (Open)`, `Chờ QA-xx chốt trước (Blocked-by QA-xx)`). Dòng 2 một câu gộp người cần trả lời, hạn và phụ thuộc: `Cần PM / Khách hàng trả lời. Chưa đặt hạn, không phụ thuộc câu hỏi nào khác.` / `Cần PM / Khách hàng trả lời trước 15/10. Chỉ trả lời được sau khi QA-02 được chốt.` Không dùng dấu `—` cho trường trống.
  - **Tiêu đề là cụm danh từ, không phải câu hỏi.** `Về phạm vi sản phẩm hiển thị cho buyer chưa thuộc group nào` — không viết `Buyer chưa thuộc group thì thấy gì?`. Câu hỏi nằm ở mục 4. Mục đích của tiêu đề là để người đọc lướt qua biết ngay câu này nói về việc gì.
  - **Mục `Vấn đề` và `Ví dụ minh họa` bỏ hẳn khi không có nội dung** — không để lại tên mục rỗng hay dấu `—`.
  - **Hiện trạng:** hệ thống hiện đang làm gì. Tính năng mới thì ghi `Chưa có (tính năng mới)`. Chỉ ghi sự thật đang có, không trộn thứ sắp làm.
  - **Bối cảnh (1–3 câu):** yêu cầu nào dẫn tới câu hỏi, và **chưa chốt thì ảnh hưởng gì**. Phần "vì sao cần hỏi" đã gộp vào đây, viết thành ý cuối của Bối cảnh chứ không tách thành mục riêng.
  - **Vấn đề:** điểm chưa rõ, mâu thuẫn giữa hai nguồn, hoặc rủi ro phát hiện được.
  - **Câu hỏi:** đúng **một ý**, ưu tiên câu hỏi đóng; hai ý → tách hai câu hỏi (và điền `Phụ thuộc` giữa chúng nếu có). **KHÔNG** viết mục "Vì sao cần hỏi" thành một mục riêng — khách hàng cần biết phải quyết cái gì, không cần một mục kể lại vì sao BA cần nó. Phản hồi thật từ PM khi đọc câu hỏi có mục này: "nội dung khá rườm rà".
  - **Lựa chọn và đề xuất:** mỗi option một dòng `A: …`, `B: …`, nói rõ option dẫn tới kết quả gì cho người dùng. Chữ cái kế tiếp luôn là `Khác (khách tự mô tả) / Chưa quyết định, cần thời gian.` Sau đó là dòng `Đề xuất của Relipa: <chữ cái>. Lý do: <lý do>` — lý do viết thành câu, không để trong ngoặc; nội dung Relipa tự đề xuất phải ghi rõ là đề xuất, không viết như yêu cầu đã có. **Không ghi công số** (cao/thấp/số ngày) trong file; hệ quả nghiệp vụ (chi phí phát sinh, `(chưa có, cần làm mới)`) vẫn ghi.
  - **Ví dụ minh họa:** một dòng tình huống, rồi kết quả theo từng option: `Nếu chọn A: … Nếu chọn B: …`.
  - **Câu trả lời:** chỉ chứa nội dung trả lời; câu còn Open ghi `Chưa trả lời.` (kèm lý do nếu có) để khách điền vào. `Người trả lời:`, `Ngày trả lời:`, `Nguồn:` là ba dòng riêng **ngang cấp** với `Câu trả lời:` — tên in đậm, giá trị cùng dòng, không thụt, ba dòng liền nhau. Câu còn Open thì ghi `—`.
  - **Bối cảnh phải nêu mốc sự kiện cụ thể, không nói tắt.** Cấm các cách nói không tương ứng với một thao tác hay một mốc có thật: "khi bật `group`", "sau khi có tính năng X", "lúc áp dụng quy tắc mới". Người đọc không biết đó là lúc phát hành mã nguồn, lúc dữ liệu được gán xong, hay lúc có một công tắc cấu hình — ba thời điểm này cách nhau nhiều ngày và dẫn tới ba câu trả lời khác nhau.
    Viết đúng là nêu thẳng hành động hoặc mốc: "sau khi phát hành chức năng quản lý `group`", "khi `admin` tạo `group` đầu tiên", "từ lúc `admin` xếp xong `buyer` vào `group`". Không chắc mốc nào thì nêu cả hai và hỏi luôn trong câu hỏi, đừng gộp thành một từ mơ hồ.
  - **Bám sát hệ thống thực tế** (xem mục 3bis bên dưới): mọi option và mọi ví dụ chỉ được dùng màn hình, nút, trường, vai trò, trạng thái, dữ liệu **có thật** trong mô tả yêu cầu / tài liệu `AK-Docs/` / mã nguồn. Cấm bịa thêm chức năng chưa có.
  - **Ngôn ngữ:** không dùng tên bảng/cột/API/biến/file trong phần câu hỏi (cần thì để trong ngoặc phụ chú cuối câu). Thuật ngữ nghiệp vụ lấy nguyên từ Glossary, **cấm tự dịch** (`group` không viết thành "nhóm", `buyer` không viết thành "cửa hàng", `import` không viết thành "nhập") — xem `custom/rules/domain-terminology.md`. **Mọi từ viết tắt/thuật ngữ nội bộ phải giải nghĩa ngay lần đầu xuất hiện**, dạng `<viết tắt> (<nghĩa đầy đủ>)`.
  - **Thuật ngữ tiếng Nhật không đứng một mình trong câu tiếng Việt/tiếng Anh.** Viết tên gọi theo cột `Viết trong tài liệu` của Glossary, kèm chữ gốc trong ngoặc ở lần đầu trong mỗi khối câu hỏi: "nhà cung cấp (サプライヤー)", "danh sách `buyer` (得意先一覧)". Glossary chưa có tên gọi → đề xuất một tên để BA xác nhận rồi ghi vào Glossary, không tự dịch rồi dùng luôn. Chi tiết: `custom/rules/domain-terminology.md`, mục "Thuật ngữ tiếng Nhật".
  - **Câu hỏi phức tạp** (≥2 điều kiện, ảnh hưởng nhiều màn hình/luồng, hoặc nói về thứ tự/ưu tiên/thời điểm) bắt buộc kèm khối `Ví dụ minh hoạ` — một tình huống cụ thể lấy từ màn hình/dữ liệu có thật, kèm kết quả theo từng option. Bối cảnh không tóm được trong 3 câu → câu hỏi đang gộp nhiều vấn đề, phải tách.
  - Điền hai dòng thông tin: `Mức độ` (🔴 Blocking / 🟡 Non-blocking) đã gắn ở Bước 2, phụ thuộc đã gắn ở Bước 2.5, `Mã` cố định theo câu hỏi, hạn trả lời lấy theo lịch dự án — không có thì ghi `Chưa đặt hạn`, cấm tự đặt hạn.
  - **Hỏi trong chat dùng dạng gọn, ghi file dùng dạng đầy đủ.** Khối đầy đủ ở trên là dạng ghi vào `QnA-Log` cho khách hàng đọc. Khi hỏi BA trực tiếp trong hội thoại, dùng **dạng gọn** khoảng 12 dòng theo mục 1b "Quy tắc chất lượng câu hỏi" của `create-spec-workflow.md` (mẫu đầy đủ ở `@skill-ba-qna-template-v1.md`, mục "Dạng gọn khi hỏi trong chat"): một dòng đầu `Q{n}/{tổng} · Mức độ · Mã — [Màn hình] chủ đề`, hai dòng `Hiện tại:` / `Thay đổi:` (mỗi dòng tối đa 2 câu), `❓` câu hỏi, mỗi option một dòng kèm công số và `⭐` cho option Relipa đề xuất, dòng `Khác / chưa quyết`, ví dụ một dòng nếu câu phức tạp, dòng `↳ Trả lời`. BA gõ `chi tiết` → in khối đầy đủ, đúng format ghi file. Khi ghi file, mở rộng về khối đầy đủ với cùng câu hỏi, cùng options, cùng đề xuất — không thêm option hay sự thật mới, không chép ghi chú công số.

- **Bước 3bis: Kiểm chứng option và ví dụ trước khi gửi — cấm giả định ngoài hệ thống:**
  Option và ví dụ sai thực tế làm khách hàng hiểu nhầm hệ thống đang có thứ nó không có, rồi chốt theo cái không tồn tại. Với **từng** option và **từng** ví dụ, chỉ ra được nguồn thì mới giữ:
  - Nguồn hợp lệ: mô tả yêu cầu/ticket; tài liệu trong `AK-Docs/` (UC Spec, QnA-Log version trước, biên bản); màn hình/nhãn thật trong mã nguồn frontend; hành vi thật trong mã nguồn backend.
  - Không chỉ ra được nguồn → **bỏ option/ví dụ đó**. Cần nêu một hướng xử lý chưa có trong hệ thống → gộp vào option `Khác — mô tả ngắn`, không dựng thành một option nghe như đã có sẵn.
  - Option mô tả một hành vi **chưa chắc** hệ thống có → ghi rõ `(chưa có, cần làm mới)` ngay trong option, không để khách hàng tưởng là tuỳ chọn sẵn dùng.
  - Ví dụ minh hoạ dùng tên màn hình, tên vai trò, tên trạng thái **đúng như hệ thống đang gọi** (theo Glossary), không đặt tên mới cho dễ đọc.
  - Số liệu/ngày giờ trong ví dụ là dữ liệu minh hoạ — được phép bịa **giá trị**, không được phép bịa **trường** hay **màn hình** chứa giá trị đó.
- **Bước 3ter: Phân nhóm câu hỏi theo role trước khi xuất file:**
  Danh sách phẳng 20+ câu buộc người đọc tự lọc câu nào thuộc phần việc của mình. Chia danh sách câu hỏi thành **nhiều nhóm, mỗi nhóm một role actor** của hệ thống — `Admin`, `Buyer`, `Guest`, `Operator`... Mỗi nhóm một heading `# Role: <tên>`. Tên role lấy đúng tên hệ thống đang dùng (theo Glossary), không tự dịch.
  - Nguồn xác định role: danh sách Actors trong `Analysis_v(n).md`, phân quyền trong mã nguồn, màn hình quản trị vs màn hình người dùng cuối.
  - Câu hỏi áp dụng cho **mọi** role hoặc không gắn với role nào (cấu hình hệ thống, batch, tích hợp ngoài) → đặt trong nhóm cuối cùng tên **`Chung / Cross-role`**. Không nhân bản một câu vào nhiều nhóm.
  - Một câu chạm **2 role** → xếp vào role **ra quyết định/chịu ảnh hưởng chính**, ghi role còn lại trong phần Bối cảnh.
  - Hệ thống chỉ có **một** role → bỏ cấp nhóm role, phân nhóm theo màn hình/module thay thế. Không dựng nhóm giả để trông có cấu trúc.
  - Nhóm không có câu hỏi nào thì **không in heading** — ghi một dòng ở phần Tóm tắt đầu tài liệu kèm lý do một mệnh đề.
  - **Mã** (`QA-01`, `QA-02`...) đánh số **liên tục toàn file**, không reset theo nhóm, và **không đổi giữa các version** — `Phụ thuộc` và marker `[PENDING - QA-xx]` trỏ theo Mã. Số thứ tự `Q1`, `Q2`… chỉ chạy theo thứ tự đọc của tài liệu và được phép đổi khi câu chuyển nhóm.
  - Thứ tự nhóm: role có nhiều câu 🔴 Blocking nhất lên trước; trong mỗi nhóm giữ thứ tự topo của bản đồ phụ thuộc (câu cha trước, 🔴 trước 🟡).

- **Bước 4: Nhận phản hồi và Cập nhật (Process Responses):**
  - Khi nhận được câu trả lời: Đọc kỹ để đảm bảo câu trả lời đã giải quyết triệt để câu hỏi.
  - Ghi nhận đầy đủ 3 dòng theo dõi phản hồi (`Người trả lời:`, `Ngày trả lời:`, `Nguồn:` — ngang cấp với `Câu trả lời:`) cho mỗi câu đã trả lời:
    - **Người trả lời** — mặc định tự lấy từ `git config user.email` (chạy `git config user.email`, fallback `git config user.name` nếu email trống) của người đang thao tác trong phiên hiện tại; nếu BA chỉ định rõ người trả lời khác (ví dụ trả lời hộ khách hàng, hoặc người phản hồi không phải chính người đang chat) thì dùng giá trị BA nhập, không tự lấy git config.
    - **Ngày trả lời** — tự động lấy theo ngày giờ hệ thống hiện tại (không hỏi lại BA), định dạng `dd/mm/yyyy`.
    - **Nguồn** — luôn hỏi BA nhập tay (ví dụ: "Khách hàng", "Nội bộ team", "Team Marketing", "Team Dev"...); không tự suy đoán hoặc đặt giá trị mặc định.
    Câu hỏi còn **Open** ghi `—` cho cả 3 dòng này.
  - Đã rõ ràng → đánh dấu **Confirmed** (dòng thông tin 1 ghi `Đã chốt (Confirmed)`), cập nhật thông tin đó trực tiếp vào tài liệu phân tích hiện tại, xóa marker `[PENDING - QA-ID]` liên quan nếu có.
  - Chưa rõ ràng / khách hàng chưa trả lời được ngay:
    - 🟡 Non-blocking → giữ **Open** (deferred), tiếp tục các câu khác/gate tiếp theo bình thường, ghi marker `[PENDING - QA-ID]` tại vị trí nội dung liên quan trong tài liệu.
    - 🔴 Blocking → giữ **Open** nhưng cảnh báo rõ cho BA lý do đây là blocking và hệ quả nếu bỏ qua trước khi cho phép gate tiếp theo tiến hành; không tự hạ nhãn xuống Non-blocking để né cảnh báo.
  - **Cập nhật khoá phụ thuộc sau mỗi vòng trả lời:** câu cha chuyển **Confirmed** → soát các câu `Blocked-by` của nó: đáp án đã bao phủ → đóng thành **Confirmed**, không hỏi lại; chưa bao phủ → chuyển **Open** để hỏi vòng sau. Câu cha vẫn Open → câu con giữ nguyên `Blocked-by`, không đưa vào vòng hỏi mới.
  - Ghi nhận lịch sử thay đổi để Dev/Test nắm được lý do thay đổi logic.

## 4. Checklist kiểm tra (Checklist for Verification)
- [ ] Mỗi câu hỏi có chỉ rõ phần màn hình/tính năng liên quan không?
- [ ] Câu hỏi có sử dụng từ ngữ trung lập, không mang tính áp đặt ý kiến chủ quan của BA không?
- [ ] Có đưa ra các phương án gợi ý (Option A, Option B...) cho các vấn đề phức tạp để khách hàng dễ lựa chọn không?
- [ ] Các thuật ngữ viết tắt trong câu hỏi có được giải thích rõ ngay lần đầu xuất hiện không?
- [ ] Mỗi câu hỏi có đủ Bối cảnh / một ý duy nhất / Options kèm hệ quả không?
- [ ] Không còn mục "Vì sao cần hỏi" sót lại chứ? Phần đó đã gộp vào mục `Bối cảnh` chưa?
- [ ] Mỗi câu hỏi là một khối `Q{n}` có tiêu đề `[Màn hình/Chức năng] Về {chủ đề}`, không phải một dòng trong bảng chứ?
- [ ] Câu hỏi trong chat dùng dạng gọn (khoảng 12 dòng, không in khối đầy đủ trừ khi BA gõ `chi tiết`), còn file `QnA-Log` dùng khối đầy đủ chứ? Bản trong file có giữ đúng câu hỏi, options và đề xuất như lúc hỏi BA không?
- [ ] Tiêu đề viết thành cụm danh từ, không phải câu hỏi chứ?
- [ ] Mục `Vấn đề` và `Ví dụ minh họa` không có nội dung thì đã bỏ hẳn, không để tên mục rỗng chứ?
- [ ] File `QnA-Log`: tên mục in đậm có `:`, không đánh số; nội dung thụt 4 dấu cách; không còn bullet `・`; mỗi mục cách nhau 1 dòng trống chưa?
- [ ] Hai dòng thông tin đã đủ mã, mức độ, trạng thái (dòng 1) và người cần trả lời, hạn, phụ thuộc (dòng 2, viết thành câu) chưa?
- [ ] Mỗi option đã nói rõ kết quả cho người dùng, file không còn ghi chú công số, và có dòng `Đề xuất của Relipa` kèm lý do (đặt sau dòng Khác) chưa?
- [ ] Mọi câu đều có option `Khác (khách tự mô tả) / Chưa quyết định, cần thời gian` chứ?
- [ ] Bối cảnh có nêu mốc sự kiện cụ thể không? Còn cách nói tắt kiểu "khi bật <tính năng>", "sau khi có X" không?
- [ ] Mỗi option và mỗi ví dụ đều chỉ ra được nguồn thật (yêu cầu / `AK-Docs/` / mã nguồn) chứ? Có option hay ví dụ nào mô tả chức năng hệ thống chưa có mà không ghi `(chưa có, cần làm mới)` không?
- [ ] Thuật ngữ nghiệp vụ đã lấy từ `AK-Docs/00.Project-Overview/Glossary.md`, không có từ nào bị tự dịch (`group` → "nhóm", `buyer` → "cửa hàng") chứ?
- [ ] Từ nghiệp vụ nào chưa có trong Glossary đã được hỏi user và ghi ngược vào `Glossary.md` chưa?
- [ ] Còn chữ tiếng Nhật nào đứng một mình trong câu không? Mỗi thuật ngữ tiếng Nhật đã có tên gọi theo Glossary, kèm chữ gốc trong ngoặc ở lần đầu của khối câu hỏi chưa?
- [ ] Bảng Q&A đã chia nhóm theo role (Admin / Buyer / Guest / ... + `Chung / Cross-role`) chưa? ID có còn liên tục toàn file không?
- [ ] Người không chuyên kỹ thuật đọc câu hỏi có hiểu ngay mà không cần đọc lại tài liệu không?
- [ ] Câu hỏi phức tạp đã có khối `Ví dụ minh hoạ` với tình huống cụ thể chưa?
- [ ] Có câu nào hỏi lại điều đã suy ra được từ quyết định đã chốt (bảng Quyết định đã chốt) không?
- [ ] Mỗi câu hỏi đã có nhãn Mức độ ảnh hưởng (🔴 Blocking / 🟡 Non-blocking) chưa?
- [ ] Mỗi câu hỏi đã điền trường `Phụ thuộc` chưa?
- [ ] Có câu nào được hỏi trong khi câu cha của nó còn Open không? (Nếu có → sai, phải chuyển về `Blocked-by QA-xx`)
- [ ] Có câu nào hỏi lại nội dung đã Confirmed ở version trước hoặc đã được bao phủ bởi câu trả lời vừa nhận không?
- [ ] Số lượng câu hỏi có phản ánh đúng độ phức tạp thực tế của yêu cầu, không bị gò về một số cố định không?
- [ ] Đã cập nhật đúng và đầy đủ tất cả câu trả lời của khách hàng vào tài liệu phân tích chưa? (Không bỏ sót bất kỳ điểm chốt nào).
- [ ] Mỗi câu hỏi **Confirmed** đã điền đủ Người trả lời, Ngày trả lời, Nguồn chưa?
- [ ] Mọi nội dung phụ thuộc câu hỏi còn Open đã có marker `[PENDING - QA-ID]` tại đúng vị trí, chưa bị tự suy diễn để lấp đầy?

## 5. Output mong đợi (Expected Output)
- File danh sách câu hỏi Q&A định dạng markdown, cấu trúc thống nhất dựa theo `@skill-ba-qna-template-v1.md`, đặt tên theo chuẩn: `QnA-Log_v(m).md` trong thư mục `AK-Docs/02.BA-Specs/02.QnA/[functionId]/` — bảng câu hỏi chia theo nhóm role.
- `AK-Docs/00.Project-Overview/Glossary.md` được bổ sung các thuật ngữ mới phát sinh trong vòng Q&A này (tạo mới chỉ khi user đã xác nhận).
- Tài liệu phân tích được cập nhật tương ứng với phiên bản mới tăng dần `(n+1)`.
