Hướng dẫn sử dụng Antigravity với dự án CXK

Dành cho: NCS Võ Trần Gia Hiếu (NCS1), Đỗ Đoàn Anh Tuấn (NCS2)
Mục đích: Hướng dẫn dùng Antigravity để làm việc hiệu quả với CXK Obsidian Vault
Thời gian đọc: 15 phút

1. Antigravity là gì?

Antigravity là trợ lý AI lập trình của Google. Nó có thể:
- Đọc, tạo và sửa file trong project
- Chạy lệnh trên máy tính
- Tìm kiếm web
- Chia nhỏ công việc cho nhiều agent chạy song song
- Ghi nhớ quy tắc project qua file AGENTS.md

💡 Quan trọng: Khi mở project CXK trong Antigravity, file AGENTS.md tự động được nạp. Mọi agent đều tuân thủ thuật ngữ, an toàn y khoa, và quy trình duyệt.

2. Cách mở project

Bước 1: Mở Antigravity

• Mở ứng dụng Antigravity 2.0 trên máy tính

Bước 2: Mở workspace CXK

• Trỏ đến thư mục: T:\Shared drives\VAGA\Working\CXK
• Antigravity sẽ tự động đọc AGENTS.md và hiểu quy tắc project

Bước 3: Bắt đầu chat

• Gõ yêu cầu vào ô chat — Antigravity sẽ thực hiện

3. Mười quy trình chính

3.1. Tạo thẻ tri thức từ giáo trình

Khi nào: Sprint 2–4, cần trích xuất thẻ tri thức (knowledge card) từ sách ĐHYHN.

Cách làm:
1. Mở file kế hoạch ngày: docs/research/plans/W{n}/D{nn}_*.md
2. Kéo xuống phần "Sub-task AI + Prompt"
3. Copy prompt trong khung text
4. Paste vào Antigravity chat
5. AI sinh draft → NCS kiểm tra → lưu vào knowledge-base/knowledge-cards/

Ví dụ:

Trích xuất dữ liệu y khoa thành các thẻ tri thức về thoái hoá khớp.
Input: knowledge-base/sources/textbooks/dhyhn/tap2/21-thoai-hoa-khop.md
Output: knowledge-base/knowledge-cards/knee-oa/KC-OA-001.md

3.2. Validate thẻ tri thức

Khi nào: Sau khi tạo hoặc sửa thẻ tri thức.

Gõ:

Chạy validate_schema.py để kiểm tra thẻ tri thức

Kết quả: Danh sách file Pass/Fail theo schema YAML.

3.3. Kiểm tra thuật ngữ

Khi nào: Sau khi viết hoặc sửa file .md.

Gõ:

Chạy check_glossary.py

Kết quả: Danh sách vi phạm HIGH/MEDIUM/LOW. Sửa HIGH ngay.

3.4. Cập nhật MOC

Khi nào: Sau khi thêm thẻ tri thức mới vào knowledge-cards/.

Gõ:

Cập nhật MOC_THOAI_HOA_KHOP với các KC mới tạo

Kết quả: MOC file có thêm link đến KC mới.

3.5. Build website tài liệu

Khi nào: Khi muốn xem tài liệu trên trình duyệt.

Gõ:

Build lại website HTML cho docs/

Kết quả: Thư mục html/ được tạo/cập nhật.

3.6. Viết nhật ký nghiên cứu

Khi nào: Cuối mỗi buổi làm việc.

Gõ:

Ghi nhật ký hôm nay — tôi đã [mô tả công việc]

Kết quả: File docs/diary/YYYY-MM-DD.md được tạo/cập nhật.

3.7. Deep research một task

Khi nào: Cần AI phân tích sâu một chủ đề.

Cách làm:
1. Mở file kế hoạch ngày tương ứng
2. Copy prompt AI
3. Dùng /boost trước prompt nếu cần phân tích phức tạp

3.8. Xem kế hoạch tuần

Gõ:

Đọc kế hoạch tuần W3 và tóm tắt các task cần làm

Kết quả: Tóm tắt README + danh sách D*.md files.

3.9. Tạo slide / báo cáo

Khi nào: Sprint 8 (W20–W21), chuẩn bị báo cáo cuối.

Gõ:

Tạo outline 20 slides cho báo cáo cuối dự án CXK

Hoặc dùng /plan để Antigravity lập kế hoạch chi tiết trước khi thực hiện.

3.10. Dọn dẹp project

Khi nào: Sau mỗi phiên làm việc dài.

Gõ:

Dọn dẹp project: tìm và xoá file Python tạm, kiểm tra glossary

4. Slash Commands hữu ích

5. Workflow Obsidian + Antigravity

flowchart TD
    A["📖 Mở Obsidian"] --> B["📋 Đọc MOC Tổng Quan"]
    B --> C["📝 Chọn task từ kế hoạch tuần"]
    C --> D["🤖 Mở Antigravity"]
    D --> E["📋 Paste prompt từ D*.md"]
    E --> F["⚙️ AI sinh draft KC"]
    F --> G{"NCS review OK?"}
    G -- Sửa --> F
    G -- OK --> H["💾 Lưu vào knowledge-cards/"]
    H --> I["✅ Validate schema"]
    I --> J["📊 Cập nhật MOC"]
    J --> K["📤 Gửi CVYK duyệt"]
    K --> L{"CVYK approve?"}
    L -- Sửa --> F
    L -- OK --> M["✅ APPROVED"]

Quy trình chi tiết:

1. Mở Obsidian → Xem MOC_TONG_QUAN.md để biết tiến độ
2. Xem kế hoạch → Mở docs/research/plans/W{n}/README.md
3. Chọn task → Mở file D{nn}_*.md tương ứng
4. Copy prompt → Paste vào Antigravity
5. AI làm việc → Sinh draft thẻ tri thức / code / báo cáo
6. NCS review → Kiểm tra nội dung, sửa nếu cần
7. Validate → Chạy validate_schema.py + check_glossary.py
8. Lưu & cập nhật MOC → Thêm link vào MOC chuyên đề
9. Gửi CVYK → CVYK mở Obsidian, duyệt, đổi status → APPROVED
10. Ghi nhật ký → Cuối buổi, ghi vào docs/diary/

Workflow camera (NCS2)

Quy trình phát triển module camera quan sát cử động:
- Người phụ trách: NCS2 (Đỗ Đoàn Anh Tuấn — Lớp 10A6, PTTH Xuân Đỉnh).
- Kiến trúc hệ thống: Tuân thủ Kiến trúc v6.0 (Context Loading, không dùng RAG ở giai đoạn 1).
- Nguyên tắc an toàn: Camera chỉ dùng quan sát cử động, tuyệt đối không chẩn đoán bệnh.
- Kế hoạch chi tiết: Tham chiếu CAMERA_MODULE_TASK_BOARD.md.
- Các sprint chính của NCS2:
- Sprint C1: Thiết lập môi trường và chạy thử nghiệm BlazePose qua browser.
- Sprint C2: Đo đạc chỉ số TUG, 5STS, Gait Speed và so sánh sai số.
- Sprint C3: Xây dựng bộ lọc an toàn (safety filter) và chạy 15 ca kiểm thử.
- Sprint C4: Tích hợp giao diện và kết nối khi core MVP đạt từ 80% trở lên.
- Cách dùng Antigravity: NCS2 lấy prompt từ kế hoạch ngày để nhờ AI hỗ trợ viết code và tài liệu.

6. Quy tắc an toàn khi dùng AI

7. Khi gặp lỗi

Phiên bản: 1.0 | Ngày: 25/09/2026
Xem thêm: AGENTS.md | MOC Tổng Quan | Task Board Camera