Prompt Deep Research — Làm rõ & Thiết kế Prompt cho 117 Task

Chế độ: Viết mới
Phạm vi: 117 file D.md trong W1–W21
Triển khai:* 8 subagent song song (1/Sprint)

Prompt hoàn chỉnh — Sẵn copy

## Nhiệm vụ

Với MỖI file D*.md trong các tuần được giao, thực hiện deep research
để làm rõ nội dung, thiết kế tiêu chuẩn hoàn thành, phân vai trò,
đánh giá AI hỗ trợ, và viết prompt thực thi cho các sub-task AI.

---

## Bối cảnh

- Dự án CXK: Trợ lý AI Cơ Xương Khớp Tuổi Bạc (NCKH cấp PTTH)
- NCS: Võ Trần Gia Hiếu (học sinh lớp 10A6)
- CVYK: Lương y Vũ Thế Sỹ (part-time)
- GVHD: Nguyễn Đảm
- Kiến trúc GĐ1: Obsidian-Markdown thuần, Context Loading (KHÔNG RAG)
- Source of truth: `docs/research/plans/10_KIEN_TRUC_VA_KE_HOACH_TRIEN_KHAI.md`

---

## Input

1. Đọc file `10_KIEN_TRUC_VA_KE_HOACH_TRIEN_KHAI.md` để hiểu Sprint context
2. Đọc README.md của tuần để hiểu mục tiêu tuần
3. Đọc TỪNG file D*.md cần xử lý

---

## Quy trình — 6 bước cho MỖI file D*.md

### Bước 1: Làm rõ nội dung (What / Why / How)

Phân tích file hiện tại và BỔ SUNG vào mục "Mô tả":

```markdown
## Mô tả chi tiết

### Bối cảnh
[Tại sao task này cần làm? Nó nằm ở đâu trong Sprint? Phụ thuộc gì?]

### Các bước thực hiện
1. [Bước 1 — cụ thể, đo được]
2. [Bước 2]
3. ...

### Kết quả mong đợi
- [Output 1 — file/artifact cụ thể]
- [Output 2]

### Lưu ý quan trọng
- [Ràng buộc y khoa nếu có]
- [Dependency với task khác]

Bước 2: Thiết kế Rubric chấm điểm hoàn thành

Tạo bảng scoring thay thế/bổ sung DoD hiện tại:

## Tiêu chuẩn Hoàn thành (Scoring Rubric)

| # | Tiêu chí | Chưa đạt (0đ) | Đạt (1đ) | Tốt (2đ) |
|---|---|---|---|---|
| 1 | Đầy đủ output | Thiếu >50% | Có đủ file nhưng sơ sài | Đủ + chi tiết |
| 2 | Chất lượng nội dung | Sai/thiếu logic | Đúng cơ bản | Chính xác + có dẫn nguồn |
| 3 | An toàn y khoa | Vi phạm | Không vi phạm | Có disclaimer rõ ràng |
| 4 | Đúng format | Sai format | Đúng format | Đúng + có metadata |
| 5 | Đúng tiến độ | Trễ >1 ngày | Đúng hạn | Sớm + dư buffer |

**Ngưỡng pass:** ≥7/10 và KHÔNG có tiêu chí nào = 0đ.

Tuỳ chỉnh 5 tiêu chí cho phù hợp với loại task:
- Task trích xuất KC → nhấn mạnh "truy vết nguồn" và "an toàn y khoa"
- Task code/kỹ thuật → nhấn mạnh "test pass" và "code quality"
- Task review/gate → nhấn mạnh "checklist đủ" và "sign-off"
- Task nhật ký/sync → đơn giản hoá, chỉ 3 tiêu chí

Bước 3: Phân vai trò chi tiết

Tạo bảng phân công rõ ràng:

## Phân công vai trò

| Vai trò | Hành động cụ thể | Thời lượng | Khi nào |
|---|---|---|---|
| NCS | [Hành động 1, 2, 3...] | Xh | [Thời điểm trong ngày] |
| AI | [Hành động 1, 2, 3...] | Xh | [Trước/song song NCS] |
| CVYK | [Hành động nếu có] | Xh | [Khi nào] |
| GVHD | [Hành động nếu có] | Xh | [Khi nào] |

Bước 4: Đánh giá AI hỗ trợ

Phân tích task và xác định:

## Đánh giá AI hỗ trợ

### AI có thể làm gì?
| # | Việc AI làm | Loại hỗ trợ | Tiết kiệm | Rủi ro |
|---|---|---|---|---|
| 1 | [Ví dụ: Sinh draft KC từ tài liệu] | Sinh nội dung | ~4h NCS | TB (cần review) |
| 2 | [Ví dụ: Validate format YAML] | Kiểm tra tự động | ~1h | Thấp |

### AI KHÔNG nên làm gì?
- [Ví dụ: Quyết định loại bỏ nội dung y khoa — phải do CVYK]
- [Ví dụ: Ký duyệt Gate — phải do NCS + CVYK]

Bước 5: Tách Sub-task AI + Thiết kế Prompt

Nếu Bước 4 xác định AI hỗ trợ được → tạo sub-task và prompt:

## Phụ lục A: Sub-task AI

### A.1 [Tên sub-task AI]

> **Loại:** [Sinh nội dung / Kiểm tra / Phân tích / Code]
> **Input:** [File/dữ liệu cần nạp]
> **Output:** [File/artifact tạo ra]
> **Effort AI:** Xh | **Effort NCS review:** Xh

#### Prompt thực thi

```text
[PROMPT HOÀN CHỈNH — thiết kế theo vg-prompter]

Nhiệm vụ: ...
Bối cảnh: ...
Input: ...
Ràng buộc: ...
Output: ...

Tiêu chí nghiệm thu

• [ ] ...

Mỗi prompt phải:
- Có nhiệm vụ rõ ràng (1 câu)
- Có bối cảnh đủ (dự án, vai trò, hạn chế)
- Chỉ rõ input file path
- Mô tả output format chính xác
- Có ràng buộc an toàn y khoa (nếu liên quan)
- NCS có thể copy-paste chạy ngay

### Bước 6: Cập nhật file D*.md

GHI THÊM (append) tất cả nội dung Bước 1–5 vào cuối file D*.md hiện tại.
KHÔNG xoá nội dung cũ. Chỉ bổ sung.

Cấu trúc file sau khi cập nhật:

[Nội dung cũ giữ nguyên]

Mô tả chi tiết

[Bước 1]

Tiêu chuẩn Hoàn thành (Scoring Rubric)

[Bước 2]

Phân công vai trò

[Bước 3]

Đánh giá AI hỗ trợ

[Bước 4]

Phụ lục A: Sub-task AI

[Bước 5 — nếu có]

---

## Ràng buộc

1. **Thuật ngữ AGENTS.md:** thẻ tri thức, cờ đỏ, bộ lọc an toàn,
   cổng kiểm soát, truy vết nguồn, bộ kiểm thử chuẩn.
2. **An toàn y khoa:** Prompt AI KHÔNG chẩn đoán, KHÔNG kê đơn,
   KHÔNG gợi ý điều trị. Luôn có disclaimer.
3. **NCS là học sinh PTTH:** Ngôn ngữ đơn giản, rõ ràng.
4. **Prompt phải copy-paste được:** NCS không cần sửa prompt.
5. **Relative path:** Mọi link file dùng relative path.
6. **KHÔNG xoá nội dung cũ:** Chỉ append thêm.
7. **Task nhật ký/sync GVHD:** Đơn giản hoá — chỉ cần 3 tiêu chí,
   không cần sub-task AI phức tạp.
8. **Task Gate/Milestone:** Nhấn mạnh checklist và sign-off.

---

## Đầu ra

117 file D*.md đã được cập nhật, mỗi file có thêm:
- Mô tả chi tiết (5W1H)
- Rubric chấm điểm (bảng 5 tiêu chí)
- Phân công vai trò (bảng)
- Đánh giá AI hỗ trợ
- Sub-task AI + prompt (nếu có)

Cách triển khai

8 subagent song song, mỗi agent xử lý 1 Sprint:

Giới hạn

• Prompt AI trong phụ lục chỉ hiệu quả khi NCS nạp đúng file input.
• Task nhật ký/sync có ít giá trị khi thêm prompt AI — giữ đơn giản.
• Chất lượng prompt phụ thuộc vào mức độ hiểu context của agent.