init git

.claude/skills/ba-4-delivery-support/templates/clarification-log.md

@@ -0,0 +1,101 @@
+# QLOG — Clarification Log — <PROJECT / US-id>
+
+| | |
+|---|---|
+| **Version** | *(cập nhật liên tục, tăng 0.1 mỗi lần thêm mục)* |
+| **Cập nhật** | YYYY-MM-DD |
+| **Author** | <BA> (skill ba-4-delivery-support) |
+| **Scope** | |
+
+> 🔴 **Mọi câu trả lời cho dev/QA phải nằm ở đây.** Trả lời miệng hoặc qua chat rồi để đó
+> là cách chắc chắn nhất khiến ba tháng sau không ai biết vì sao hệ thống hành xử như vậy.
+
+---
+
+## 1. Bảng theo dõi
+
+| ID | Ngày hỏi | Người hỏi | Câu hỏi (tóm tắt) | Loại | Người trả lời | Ngày trả lời | Tài liệu đã sửa | Trạng thái |
+|---|---|---|---|---|---|---|---|---|
+| Q-001 | | Dev A | | 2 | BA | | SRS v1.1 §2.3.3 | ✅ Đã đóng |
+| Q-002 | | QA B | | 3 | PO | — | — | 🔴 Quá hạn 4 ngày |
+
+**Bốn loại câu hỏi:**
+
+| Loại | Mô tả | Ai trả lời được | Hạn mục tiêu | Có phải sửa tài liệu |
+|---|---|---|---|---|
+| 1 | Spec đã nói rõ, người hỏi chưa đọc thấy | BA — trích dẫn đích danh | Trong ngày | ❌ Không |
+| 2 | Spec nói mơ hồ, hiểu được hai cách | BA — làm rõ | 1 ngày | ✅ **Bắt buộc** |
+| 3 | Spec không nói gì | PO / Tech Lead | 2 ngày | ✅ **Bắt buộc** |
+| 4 | Spec nói sai | PO → thành `CR` | 2 ngày | ✅ **Bắt buộc, qua CR** |
+
+🔴 Ba loại sau đều phải sửa tài liệu. Trả lời cho một dev mà không sửa spec nghĩa là người
+tiếp theo sẽ hỏi lại đúng câu đó.
+
+---
+
+## 2. Chi tiết
+
+### Q-001
+
+| | |
+|---|---|
+| **Ngày hỏi** | |
+| **Người hỏi** | |
+| **Kênh** | Chat / Họp / PR comment |
+| **Liên quan** | US-011 · SCR-03 · F04 · AC-05 |
+| **Loại** | 2 — spec mơ hồ |
+| **Chặn gì** | Dev đang chờ để code màn hình form |
+
+**Câu hỏi (nguyên văn):**
+> "…"
+
+**Câu trả lời:**
+> *(dứt khoát — không "có thể", không "tuỳ")*
+
+**Nguồn của câu trả lời:**
+
+| | |
+|---|---|
+| Trích dẫn | `SRS_US011_v1.0.md` §2.3.3, dòng F04 |
+| Hoặc: ai quyết định | STK-01, ngày… → `DEC-nn` |
+
+**Hành động kèm theo:**
+
+| # | Việc | Tài liệu | Version | Trạng thái |
+|---|---|---|---|---|
+| 1 | Làm rõ mô tả F04 | `SRS_US011` | v1.0 → v1.1 | ☐ |
+| 2 | Cập nhật RTM | `RTM_…` | | ☐ |
+| 3 | Báo cho Dev B và QA (đang dùng bản cũ) | — | | ☐ |
+
+**Nếu chưa trả lời được:**
+
+| | |
+|---|---|
+| Đã tạo | `OQ-0nn` |
+| Người phải trả lời | |
+| Hạn | |
+| **Phương án tạm cho dev** | *(kèm cảnh báo rõ: đây là tạm, có thể phải sửa lại)* |
+
+---
+
+## 3. Câu hỏi lặp lại
+
+*Cùng một câu hỏi từ ≥2 người ⇒ tài liệu có vấn đề ở chỗ đó, không phải người hỏi có vấn đề.*
+
+| Câu hỏi | Số lần được hỏi | Mục tài liệu liên quan | Đã sửa để không ai hỏi nữa |
+|---|---|---|---|
+| | | | ☐ |
+
+Đây là nguồn cải tiến chất lượng đặc tả tốt nhất — ghi lại và mang vào bài học ở GĐ5.
+
+## 4. Thống kê
+
+| Chỉ số | Giá trị | Ý nghĩa |
+|---|---|---|
+| Tổng câu hỏi | | |
+| Loại 1 (spec đã nói rõ) | | Cao ⇒ tài liệu khó tra cứu, cần mục lục/chỉ mục tốt hơn |
+| Loại 2 (mơ hồ) | | Cao ⇒ vi phạm quy tắc W2, cần viết chặt hơn |
+| Loại 3 (không nói) | | Cao ⇒ đặc tả thiếu phạm vi, rà lại checklist G3 |
+| Loại 4 (sai) | | Cao ⇒ GĐ2 hiểu sai nghiệp vụ |
+| Thời gian trả lời trung bình | | |
+| Đang quá hạn | | 🔴 nếu > 0 |