Tuần: W10 | Sprint: S4
Task ID v5.0: 4.4
Phân loại: Hỗn hợp
Effort NCS: 2h | Effort CVYK: 0h | Effort AI: 1h
Mô tả
Chạy thử script Context Loader đã viết với 5 thẻ tri thức (knowledge card) mẫu để kiểm tra xem script có load đúng nội dung, giữ nguyên format và phân tách metadata chính xác hay không.
File Input
docs/design/context_loader.md- Code thực thi của Context Loader
- 5 thẻ tri thức mẫu từ thư mục
data/cards/loang_xuong/
File Output
- Kết quả test hiển thị trên terminal hoặc file log.
Definition of Done (DoD)
- [ ] Code Context Loader chạy không lỗi trên 5 file mẫu
- [ ] Output thể hiện đúng việc load dữ liệu
Rủi ro & Xử lý
| Rủi ro | Xác suất | Xử lý |
|---|---|---|
| Lỗi parse markdown/metadata | TB | AI debug và fix trực tiếp |
Chi tiết nhiệm vụ (Deep Research)
1. Mô tả chi tiết
Nhiệm vụ tập trung vào hệ thống Context Loader (nạp trực tiếp các file Markdown chứa thẻ tri thức vào context window 1M tokens của Gemini, hoàn toàn KHÔNG sử dụng RAG), xây dựng Prompt Template và chuẩn bị cổng kiểm soát (Gate A) cho các thẻ tri thức chuyên đề loãng xương và lão khoa. Dựa trên nguồn tài liệu: ĐHYHN Tập 2/22 và Tập 1/35.
2. Rubric 5 tiêu chí
| Tiêu chí | Mô tả | Trọng số |
|---|---|---|
| Task Context Loader | Pass toàn bộ test cases, code quality đảm bảo, không hardcode path thư mục. | 25% |
| Task Gate A | Checklist hoàn thành ≥ 80 thẻ tri thức, CVYK sign-off, có đầy đủ cờ đỏ và truy vết nguồn. | 25% |
| Chuẩn Y khoa | Đảm bảo nguyên tắc KHÔNG chẩn đoán bệnh, KHÔNG kê đơn thuốc, luôn có lời khuyên an toàn. | 20% |
| Tích hợp Prompt | Prompt Template system được cấu trúc hóa tốt, tái sử dụng cao. | 15% |
| Tính tương thích | Tương thích môi trường FastAPI, Python 3.11+, tuân thủ PEP 8. | 15% |
3. Phân vai trò
- NCS (Nghiên cứu sinh): Chịu trách nhiệm code Context Loader, code Prompt Template system, và trích xuất/soạn thảo thẻ tri thức ban đầu. Chạy bộ kiểm thử chuẩn.
- CVYK (Cố vấn y khoa): Đọc, đánh giá và sign-off nội dung thẻ tri thức, cờ đỏ, lời khuyên an toàn.
- GVHD (Giáo viên hướng dẫn): Review kiến trúc code và đánh giá cổng kiểm soát (Gate A).
- AI: Hỗ trợ code Context Loader, gen draft cho thẻ tri thức và Prompt Template theo yêu cầu.
4. Đánh giá AI hỗ trợ
- Mức độ hỗ trợ: Rất cao. AI tiết kiệm đáng kể thời gian trong việc xây dựng code boilerplate cho Context Loader và cấu trúc Prompt.
- Rủi ro & Giảm thiểu: AI có thể bị "ảo giác" (hallucinate) nội dung y khoa. Cần bộ lọc an toàn (safety layer) và bắt buộc CVYK rà soát lại (sign-off) ở cổng kiểm soát (quality gate).
5. Sub-task AI + Prompt
- Task:
1. AI code Context Loader module (Python).
2. AI code Prompt Template system.
3. AI sinh draft thẻ tri thức (knowledge card) loãng xương. - Prompt Template:
text Bạn là một AI Software Engineer và Trợ lý Y khoa. Nhiệm vụ 1 (Context Loader): Viết module Context Loader. Tech spec: Python 3.11+, FastAPI, tuân thủ PEP 8. Đường dẫn thư mục phải đọc từ biến môi trường (env var), KHÔNG hardcode. Nhiệm vụ 2 (Prompt Template): Xây dựng hệ thống Prompt Template bao gồm system prompt structure rõ ràng và cung cấp các few-shot examples. Nhiệm vụ 3 (Gate A): Thiết lập cổng kiểm soát Gate A với checklist đạt ≥80 thẻ tri thức (KC) và tích hợp quy trình CVYK sign-off protocol. Nhiệm vụ 4 (Thẻ tri thức): Sinh các draft thẻ tri thức (KC) về loãng xương dựa trên nguồn chapter 22 (ĐHYHN Tập 2/22 và Tập 1/35). Bắt buộc có "cờ đỏ" (red flag), "lời khuyên an toàn" (disclaimer), và "truy vết nguồn" (provenance). Tuyệt đối KHÔNG đưa ra chẩn đoán hay kê đơn thuốc.