Prompt — Tài liệu & Tự động hoá CXK × Obsidian × Antigravity

Chế độ: Viết mới + Thực thi
Phạm vi: 3 deliverable (Hướng dẫn + Workspace Skill + AGENTS.md update)

Prompt hoàn chỉnh

## Nhiệm vụ

Xây dựng hệ thống tài liệu và tự động hoá quy trình làm việc giữa
project CXK (Obsidian Vault) và Antigravity, gồm 3 deliverable:

1. Tài liệu hướng dẫn NCS sử dụng Antigravity với CXK
2. Workspace skill `cxk-obsidian` tự động hoá 7 quy trình
3. Cập nhật AGENTS.md

---

## Bối cảnh

- Dự án CXK: Trợ lý AI Cơ Xương Khớp Tuổi Bạc
- Kiến trúc GĐ1: Obsidian-Markdown → Context Loading (Gemini 1M tokens)
- Obsidian Vault đã setup tại `t:/Shared drives/VAGA/Working/CXK/`
  - `.obsidian/` config: app, core-plugins, templates, daily-notes
  - `knowledge-base/_templates/`: KC, FAQ, CASE, EC, DIARY templates
  - MOC files: MOC_TONG_QUAN, MOC_THOAI_HOA_KHOP, MOC_DAU_LUNG, MOC_LOANG_XUONG
- AGENTS.md: v1.4, có Section 9 (cleanup) + Section 10 (diary)
- Tools đã có: validate_schema.py, check_glossary.py, build_docs_site.py
- NCS là học sinh PTTH, dùng Antigravity 2.0 trên Windows

---

## Deliverable 1: Hướng dẫn NCS

**File:** `docs/guides/HUONG_DAN_ANTIGRAVITY_CXK.md`

### Nội dung bắt buộc:

#### A. Giới thiệu Antigravity cho NCS
- Antigravity là gì (1 đoạn, đơn giản)
- Cách mở project CXK trong Antigravity
- AGENTS.md tự động nạp — tại sao quan trọng

#### B. 10 quy trình chính NCS cần biết
| # | Quy trình | Lệnh/Cách dùng | Output |
|---|---|---|---|
| 1 | Tạo thẻ tri thức từ giáo trình | Copy prompt từ D*.md, paste vào chat | KC-*.md trong knowledge-cards/ |
| 2 | Validate thẻ tri thức | "Chạy validate_schema.py" | Pass/Fail report |
| 3 | Kiểm tra thuật ngữ | "Chạy check_glossary.py" | Danh sách vi phạm |
| 4 | Cập nhật MOC | "Cập nhật MOC_THOAI_HOA_KHOP với KC mới" | MOC file updated |
| 5 | Build website docs | "Build lại website HTML" | html/ folder |
| 6 | Viết nhật ký | "Ghi nhật ký hôm nay" | docs/diary/YYYY-MM-DD.md |
| 7 | Deep research task | Copy prompt từ D*.md | Kết quả task |
| 8 | Review kế hoạch tuần | "Xem kế hoạch tuần W{n}" | README tuần |
| 9 | Tạo slide/báo cáo | "Tạo outline slide cho Sprint X" | Markdown draft |
| 10 | Dọn dẹp project | "Dọn dẹp file tạm" | Clean workspace |

#### C. Tips & Tricks
- Slash commands hữu ích: /goal, /plan, /boost
- Cách dùng subagent cho task lớn
- Cách đọc kế hoạch tuần và chạy prompt AI
- Quy tắc an toàn: KHÔNG cho AI chẩn đoán bệnh

#### D. Workflow Obsidian + Antigravity
Sơ đồ quy trình:

NCS mở Obsidian → Đọc MOC → Chọn task →
Mở Antigravity → Paste prompt từ D*.md →
AI sinh draft → NCS review →
Lưu vào knowledge-cards/ → Validate →
Gửi CVYK duyệt → APPROVED

---

## Deliverable 2: Workspace Skill `cxk-obsidian`

**Thư mục:** `.agents/skills/cxk-obsidian/`

### Cấu trúc:

.agents/skills/cxk-obsidian/
├── SKILL.md # Main instruction
├── scripts/
│ ├── create_kc.py # Tạo KC file từ template
│ ├── update_moc.py # Cập nhật MOC khi thêm KC
│ ├── audit_vault.py # Kiểm tra vault integrity
│ └── sync_diary.py # Tạo/cập nhật diary entry
└── references/
└── workflows.md # Chi tiết 7 quy trình

### SKILL.md phải có:
- Frontmatter: name, description (trigger keywords)
- 7 quy trình tự động:

| # | Quy trình | Trigger | Script |
|---|---|---|---|
| 1 | Tạo KC mới | "tạo thẻ tri thức", "tạo KC" | create_kc.py |
| 2 | Validate vault | "kiểm tra vault", "validate" | validate_schema.py (existing) |
| 3 | Audit thuật ngữ | "kiểm tra thuật ngữ" | check_glossary.py (existing) |
| 4 | Cập nhật MOC | "cập nhật MOC", "sync MOC" | update_moc.py |
| 5 | Tạo diary | "ghi nhật ký", "diary" | sync_diary.py |
| 6 | Build HTML | "build website", "tạo HTML" | build_docs_site.py (existing) |
| 7 | Audit vault | "audit vault", "rà soát vault" | audit_vault.py |

### Script specs:

**create_kc.py:**
- Input: category (oa/lbp/osteo), title, source chapter
- Process: Copy template, fill ID (auto-increment), fill metadata
- Output: File mới trong knowledge-cards/{category}/

**update_moc.py:**
- Input: MOC file path
- Process: Scan knowledge-cards/{category}/, build table, update MOC
- Output: MOC file updated với danh sách KC mới

**audit_vault.py:**
- Process: Kiểm tra tất cả KC files
  - YAML frontmatter hợp lệ?
  - Có red_flags field?
  - Có disclaimer?
  - Có provenance?
  - Status hợp lệ?
  - Link trong MOC khớp files?
- Output: Báo cáo audit (Pass/Fail per file)

**sync_diary.py:**
- Input: Ngày (default: hôm nay)
- Process: Kiểm tra docs/diary/YYYY-MM-DD.md
  - Chưa có → tạo từ template
  - Đã có → mở để append
- Output: Diary file path

---

## Deliverable 3: Cập nhật AGENTS.md

Thêm Section 11: "Quy trình Antigravity + Obsidian"

Nội dung:
- Khi nào dùng Antigravity vs Obsidian
- Quy trình tạo KC: AI draft → NCS review → CVYK approve
- Reference đến skill `cxk-obsidian`
- Quy trình validate bắt buộc trước mỗi Gate

---

## Ràng buộc

1. Ngôn ngữ: Tiếng Việt, đơn giản, cho học sinh PTTH
2. Thuật ngữ: Theo AGENTS.md (thẻ tri thức, cờ đỏ, bộ lọc an toàn...)
3. Scripts: Python 3.11+, PEP 8, docstring tiếng Việt
4. Paths: Relative, tương thích Windows + Google Drive
5. KHÔNG sửa nội dung y khoa
6. KHÔNG hardcode absolute paths trong scripts

## Tiêu chí nghiệm thu

- [ ] Hướng dẫn NCS ≤ 500 dòng, có sơ đồ workflow
- [ ] Skill cài được: `.agents/skills/cxk-obsidian/SKILL.md` hợp lệ
- [ ] 4 scripts chạy không lỗi trên Windows
- [ ] AGENTS.md cập nhật, version bump
- [ ] Glossary check: 0 HIGH violations mới

Kế hoạch triển khai