Tuần: W1 | Sprint: S1
Task ID v5.0: 1.9
Phân loại: NCS chính / Hỗn hợp
Effort NCS: 6h | Effort CVYK: 0.6h | Effort AI: 2.4h
Mô tả
Thiết lập Obsidian Vault cho dự án, cấu trúc folder knowledge-base, và tạo tài liệu hướng dẫn chi tiết cho Cố vấn y khoa (CVYK) để duyệt và chỉnh sửa thẻ tri thức y khoa.
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/README.md- Cấu trúc thư mục trong
knowledge-base(Obsidian Vault)
Definition of Done (DoD)
- [ ] Vault được tạo và cấu hình thành công (sync nếu cần).
- [ ] Cấu trúc thư mục (
MOCs,sources,knowledge-cards,faq, vv.) đúng chuẩn theo v5.0. - [ ] File README.md hướng dẫn CVYK rõ ràng, dễ hiểu.
- [ ] Cài đặt các plugin cần thiết cho việc quản lý thẻ tri thức (nếu có).
Rủi ro & Xử lý
| Rủi ro | Xác suất | Xử lý |
|---|---|---|
| CVYK gặp khó khăn khi dùng Obsidian | Cao | Viết tài liệu hướng dẫn thật đơn giản, tập trung vào việc đọc và edit markdown thuần tuý. Có thể quay video ngắn. |
| Xung đột phiên bản khi sync file | TB | Đề xuất dùng Git hoặc công cụ sync an toàn. |
Mô tả chi tiết
Bối cảnh
Để CVYK có thể dễ dàng kiểm soát nội dung chuyên môn, dự án sử dụng Obsidian Vault. Task này chuẩn bị workspace đó.
Các bước thực hiện
- Khởi tạo Obsidian Vault nội bộ.
- Tổ chức các thư mục thẻ tri thức, MOC.
- Viết README hướng dẫn CVYK.
Kết quả mong đợi
- Vault sẵn sàng, có tài liệu hướng dẫn cực kỳ dễ hiểu.
Tiêu chuẩn Hoàn thành (Scoring Rubric)
| # | Tiêu chí | Chưa đạt (0đ) | Đạt (1đ) | Tốt (2đ) |
|---|---|---|---|---|
| 1 | Obsidian Setup | Lỗi mở file | Vault mở được | Cấu hình template sẵn sàng |
| 2 | Cấu trúc Vault | Lộn xộn | Theo chuẩn v5.0 | Có liên kết chéo tốt |
| 3 | File README | Không có | Có hướng dẫn | Có hình ảnh minh họa chi tiết |
| 4 | Tính dễ dùng | Phức tạp | Đủ xài | Cực kỳ trực quan cho CVYK |
| 5 | Thời gian setup | Quá lố budget | Đúng budget | Xong sớm, gọn gàng |
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 | Tạo vault, cài plugin, duyệt README | 6.0h | CN |
| AI | Viết nháp README hướng dẫn | 2.4h | CN |
Đánh giá AI hỗ trợ
AI có thể làm gì?
| # | Việc AI làm | Tiết kiệm | Rủi ro |
|---|---|---|---|
| 1 | Viết tài liệu hướng dẫn kỹ thuật | 2h | Dùng từ vựng quá chuyên ngành IT |
AI KHÔNG nên làm gì?
- Cấu hình các plugin quá rườm rà làm khó CVYK.
Phụ lục A: Sub-task AI
A.1 Viết hướng dẫn Obsidian cho CVYK
Input: Workflow duyệt thẻ
Output:README.md
Prompt thực thi
## Nhiệm vụ
Viết tài liệu README.md hướng dẫn sử dụng Obsidian cho Cố vấn y khoa
## 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)
- Cố vấn y khoa (không rành công nghệ) cần hướng dẫn đơn giản nhất để mở phần mềm, tìm kiếm thẻ tri thức và thêm nhận xét.
## Input
- File: `N/A`
## Output
- File: `docs/guides/CVYK_README.md`
- Format: Markdown
- Số lượng: 1 file
## 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
- [ ] Có các bước 1-2-3 rõ ràng, cực kỳ đơn giản
- [ ] Không chứa jargon IT không cần thiết
- [ ] Giải thích dễ hiểu khái niệm cờ đỏ (red flag) và cách chỉnh sửa nội dung