Tuần: W2 | Sprint: S1
Task ID v5.0: 1.6
Phân loại: Hỗn hợp
Effort NCS: 2h | Effort CVYK: 0h | Effort AI: 1.2h
Mô tả
Tạo các template chuẩn (KC, FAQ, Case, MOC) dùng trong Obsidian, bao gồm định dạng Markdown và YAML frontmatter, kèm theo JSON schema nếu cần.
File Input
t:/Shared drives/VAGA/Working/CXK/docs/research/plans/KIEN_TRUC_DU_AN.md
File Output
t:/Shared drives/VAGA/Working/CXK/knowledge-base/knowledge-cards/_schema.jsont:/Shared drives/VAGA/Working/CXK/knowledge-base/faq/_schema.json- Mẫu template .md cho Obsidian
Definition of Done (DoD)
- [ ] Template Markdown + Frontmatter được thiết lập đúng chuẩn.
- [ ] AI có thể sử dụng các template này một cách chuẩn xác cho những sprint tới.
Rủi ro & Xử lý
| Rủi ro | Xác suất | Xử lý |
|---|---|---|
| CVYK không quen với YAML | Cao | Ẩn các field không cần thiết, hướng dẫn trực quan trong README.md. |
Mô tả chi tiết
Bối cảnh
Để việc tạo thẻ tri thức (knowledge card) được chuẩn hoá và AI dễ dàng đọc (parse) sau này, cần thiết lập các template tĩnh.
Các bước thực hiện
- AI sinh mẫu Markdown với frontmatter (YAML).
- NCS tạo JSON schema cho tính toàn vẹn.
- Test thử tạo 1 thẻ mẫu.
Kết quả mong đợi
- Schema định nghĩa và template file.
Tiêu chuẩn Hoàn thành (Scoring Rubric)
| # | Tiêu chí | Chưa đạt (0đ) | Đạt (1đ) | Tốt (2đ) |
|---|---|---|---|---|
| 1 | Frontmatter | Lỗi cú pháp | Có YAML block | YAML block có mô tả cho CVYK |
| 2 | Khả năng mở rộng | Cứng ngắc | Thêm field được | JSON schema strict validator |
| 3 | Truy vết nguồn | Không có field | Có URL/Source | Yêu cầu bắt buộc (required) |
| 4 | Cờ đỏ | Thiếu sót | Có đánh dấu | Đánh dấu mức độ cờ đỏ |
| 5 | UX cho CVYK | Khó nhìn | Dễ đọc | Tối giản, có preview đẹp |
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 | Review schema và test trong Obsidian | 2.0h | T3 |
| AI | Sinh mã JSON/YAML template | 1.2h | T3 |
Đá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 nghĩa JSON Schema | 1h | Thiếu strict rules |
AI KHÔNG nên làm gì?
- Chèn các logic động quá rườm rà vào thẻ tĩnh.
Phụ lục A: Sub-task AI
A.1 Obsidian Knowledge Template
Input: Format yêu cầu
Output:template_knowledge_card.md
Prompt thực thi
## Nhiệm vụ
Tạo một template Markdown chuẩn cho thẻ tri thức y khoa (knowledge card)
## 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 định dạng thẻ tri thức trong Obsidian bằng template chứa khối YAML frontmatter và cấu trúc nội dung cố định.
## Input
- File: `N/A`
## Output
- File: `knowledge-base/templates/knowledge_card_template.md`
- Format: Markdown
- Số lượng: 1 template
## 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
- [ ] Khối YAML có đủ: id, nhóm bệnh, cờ đỏ, nguồn (truy vết nguồn), reviewer, status
- [ ] Khối nội dung có các heading: Định nghĩa, Triệu chứng, Lời khuyên tự chăm sóc, Khi nào cần gặp bác sĩ
- [ ] Không có mục kê đơn (tuân thủ giới hạn an toàn)