name: cxk-obsidian
description: >-
Tự động hoá quy trình làm việc với Obsidian Vault trong dự án CXK
(Trợ lý AI ). Dùng khi yêu cầu tạo thẻ
tri thức mới, validate vault, cập nhật MOC, audit vault, ghi nhật ký,
hoặc build website HTML. Triggers: "tạo KC", "tạo ",
"validate vault", "kiểm tra vault", "cập nhật MOC", "sync MOC",
"audit vault", "rà soát vault", "ghi nhật ký", "diary", "build HTML",
"build website".

Skill CXK-Obsidian — Tự động hoá Vault

Skill này cung cấp 7 quy trình tự động cho dự án CXK.

Quy tắc chung

  1. AGENTS.md là luật tối cao — luôn tuân thủ thuật ngữ, an toàn y khoa
  2. Paths: Dùng relative path, tương thích Windows
  3. Vault root: knowledge-base/ trong workspace CXK
  4. Templates: knowledge-base/_templates/
  5. Scripts: Chạy với $env:PYTHONIOENCODING = "utf-8" trên Windows (fix cp1252)
  6. Lệnh mẫu: $env:PYTHONIOENCODING = "utf-8"; python .agents/skills/cxk-obsidian/scripts/{script}.py

7 Quy trình

1. Tạo thẻ tri thức mới (KC)

Trigger: "tạo thẻ tri thức", "tạo KC", "knowledge card mới"

Bước thực hiện:
1. Hỏi NCS: category (oa/lbp/osteo/sarc/fall/neck/frail), title, source chapter
2. Chạy script: python .agents/skills/cxk-obsidian/scripts/create_kc.py --category {cat} --title "{title}" --chapter "{ch}"
3. Mở file mới tạo, điền nội dung từ nguồn
4. Chạy validate: python tools/validate_schema.py

2. Validate thẻ tri thức

Trigger: "validate", "kiểm tra ", "kiểm tra thẻ"

Bước: Chạy python tools/validate_schema.py

3. Kiểm tra thuật ngữ

Trigger: "kiểm tra thuật ngữ", "glossary check"

Bước: Chạy python tools/check_glossary.py
- HIGH → sửa ngay
- MEDIUM → sửa nếu đang chỉnh file đó

4. Cập nhật MOC

Trigger: "cập nhật MOC", "sync MOC"

Bước:
1. Chạy: python .agents/skills/cxk-obsidian/scripts/update_moc.py --category {cat}
2. Kiểm tra MOC file đã cập nhật

5. Ghi nhật ký

Trigger: "ghi nhật ký", "diary", "nhật ký hôm nay"

Bước:
1. Chạy: python .agents/skills/cxk-obsidian/scripts/sync_diary.py
2. Append nội dung công việc vào file diary

6. Build website HTML

Trigger: "build HTML", "build website", "tạo trang web"

Bước: Chạy python tools/build_docs_site.py

7. Audit vault toàn diện

Trigger: "audit vault", "rà soát vault", "kiểm tra vault toàn diện"

Bước:
1. Chạy: python .agents/skills/cxk-obsidian/scripts/audit_vault.py
2. Đọc báo cáo, sửa lỗi nếu có

Chi tiết workflows

Xem references/workflows.md cho hướng dẫn chi tiết từng bước.