Ngày 04 — Thứ Năm, 24/09/2026 — Ontology & Knowledge Schema

Tuần: 1/23 | : S1/8
effort: 2h (max 2h)
: Không
Checkpoint cuối ngày: validator chạy thành công trên ≥20

Task 1: Xây dựng Taxonomy & Thẻ Tri Thức

ID: W1-D04-T01
Phân loại: 🤖 AI tự làm / 📝 NCS review
Effort NCS: 90 phút
Dependency: W1-D03-T01

Mô tả Chi tiết

AI thiết kế cho 7 nhóm bệnh. AI định nghĩa JSON/ schema cho thẻ tri thức và bắt đầu chuyển đổi các Clinical Claims thành Thẻ Tri thức (Knowledge Cards). NCS chạy script validate_schema.py để đảm bảo toàn bộ thẻ được parse đúng định dạng.

File Tham chiếu (Input)

# File Path Mô tả Tồn tại?
1 Validate script tools/validate_schema.py Script kiểm tra schema ✅

File Kết quả (Output)

# File Path Dự kiến Mô tả Format
1 MSK Taxonomy knowledge-base/taxonomy/msk_taxonomy_v1.yaml Taxonomy YAML
2 Knowledge Cards knowledge-base/knowledge-cards/ Thư mục chứa thẻ YAML

Hành động Cụ thể

Vai trò Hành động
🤖 Generate Taxonomy v1 và các file YAML.
📝 NCS Chạy python tools/validate_schema.py để verify, báo AI sửa lỗi nếu có.

DoD (Definition of Done)

  • [ ] File msk_taxonomy_v1.yaml hợp lệ định dạng.
  • [ ] Chạy script validate trả về 0 lỗi.
  • [ ] Có tối thiểu 20 thẻ tri thức trạng thái DRAFT.

Rủi ro & Xử lý

Rủi ro Xác suất Cách xử lý
YAML format error Trung bình Sử dụng linter tích hợp hoặc python yaml parser để kiểm tra tự động.

Task 2: Nhật ký Ngày 04

Task ID: W1-D04-T02
Phân loại: 🤖 AI tự làm
Effort NCS: 30 phút
Dependency: Khong

Mô tả Chi tiết

NCS ghi chép tiến độ ngày.

File Tham chiếu (Input)

Không có

File Kết quả (Output)

# File Path Dự kiến Mô tả Format
1 Nhật ký ngày 04 docs/diary/2026-09-24.md Ghi chép cá nhân MD

Hành động Cụ thể

Vai trò Hành động
📝 NCS Viết nhật ký ngày 4.

DoD (Definition of Done)

  • [ ] File tồn tại ở docs/diary/2026-09-24.md

Rủi ro & Xử lý

Rủi ro Xác suất Cách xử lý
None Thấp None
---

Mô tả chi tiết

Bối cảnh

Cuối tuần 1 của Sprint 1, dự án cần một bảng phân loại (taxonomy) vững chắc và định dạng cấu trúc chuẩn cho thẻ tri thức (knowledge card).

Các bước thực hiện

  1. AI sinh MSK Taxonomy cho 7 nhóm bệnh.
  2. Thiết kế schema JSON/YAML.
  3. Chạy script validate.

Kết quả mong đợi

  • File taxonomy và khoảng 20 thẻ tri thức ở trạng thái DRAFT.

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

# Tiêu chí Chưa đạt (0đ) Đạt (1đ) Tốt (2đ)
1 Định dạng YAML Lỗi cú pháp Parse được Có validator linter
2 Bảng phân loại Thiếu sót lớn Đủ 7 nhóm bệnh Có sub-category rõ ràng
3 Số lượng thẻ <10 thẻ 20 thẻ >20 thẻ đa dạng
4 Trạng thái Validation Báo lỗi Chạy thành công Không có warning nào
5 Cấu trúc Schema Sơ sài Đủ metadata cơ bản Hỗ trợ sâu

Ngưỡng pass: ≥7/10.

Phân công vai trò

Vai trò Hành động cụ thể Thời lượng Khi nào
NCS Chạy validation, soát lỗi taxonomy 1.0h T5
AI Sinh taxonomy và thẻ DRAFT 1.0h T5

Đánh giá AI hỗ trợ

AI có thể làm gì?

# Việc AI làm Tiết kiệm Rủi ro
1 Định dạng YAML/JSON hàng loạt 2h Lỗi cú pháp thụt lề YAML

AI KHÔNG nên làm gì?

  • Tự thêm các nhóm bệnh ngoài scope 7 nhóm bệnh MVP.

Phụ lục A: Sub-task AI

A.1 Xây dựng Thẻ tri thức DRAFT

Input: W1_D03_ClinicalClaims_v0.1.csv
Output: Thư mục thẻ tri thức YAML

Prompt thực thi

## Nhiệm vụ
Thiết kế bảng phân loại (taxonomy) và tạo 20 thẻ tri thức dạng YAML

## Bối cảnh
- Dự án: Trợ lý AI Cơ Xương Khớp Tuổi Bạc (CXK)
- Kiến trúc: Context Loading (Markdown → Gemini 1M tokens, KHÔNG RAG)
- Chuẩn hóa cấu trúc lưu trữ tri thức cho 7 nhóm bệnh cơ xương khớp theo chuẩn YAML frontmatter để dễ dàng nạp vào hệ thống.

## Input
- File: `knowledge-base/evidence-matrix/W1_D03_ClinicalClaims_v0.1.csv`

## Output
- File: `knowledge-base/knowledge-cards/ (20 files YAML)`
- Format: YAML
- Số lượng: 20 thẻ tri thức

## Ràng buộc
1. An toàn y khoa: KHÔNG chẩn đoán, KHÔNG kê đơn, luôn có lời khuyên an toàn
2. Đảm bảo chất lượng định dạng và nội dung đầu ra theo yêu cầu kỹ thuật
3. Thuật ngữ: thẻ tri thức, cờ đỏ, bộ lọc an toàn, truy vết nguồn
4. Ngôn ngữ: Tiếng Việt, đơn giản, dễ hiểu

## Tiêu chí nghiệm thu
- [ ] YAML không lỗi cú pháp
- [ ] Taxonomy bám sát các tài liệu y khoa
- [ ] Mỗi thẻ có frontmatter đầy đủ: ID, nhóm bệnh, cờ đỏ, và liên kết truy vết nguồn