AgentSkillsCN

Skill

技能

SKILL.md

Zettelkasten Skills (Python Version)

Đây là danh sách các "kỹ năng" (script Python) có sẵn để quản lý hệ thống Zettelkasten của bạn.

Tất cả các script đều nằm trong thư mục skill/ và được chạy bằng python3.

1. Tạo ghi chú mới (create_note.py)

Script này giúp bạn nhanh chóng tạo một ghi chú (zettel) mới với đúng định dạng.

Cách sử dụng:

bash
python3 skill/create_note.py "Tiêu đề cho ghi chú mới"

2. Tìm kiếm ghi chú (find_note.py)

Script này cho phép bạn tìm kiếm toàn văn trong tất cả các ghi chú.

Cách sử dụng:

bash
python3 skill/find_note.py "<từ_khóa_tìm_kiếm>"

3. Tìm liên kết ngược (find_backlinks.py)

Script này giúp bạn tìm tất cả các ghi chú có liên kết đến một ghi chú cụ thể.

Cách sử dụng:

bash
python3 skill/find_backlinks.py <UID_của_ghi_chú>

4. Tìm theo Thẻ (find_by_tag.py)

Tìm tất cả các ghi chú được gán một thẻ (tag) cụ thể.

Cách sử dụng:

bash
python3 skill/find_by_tag.py "<tên_thẻ>"

Ví dụ:

bash
python3 skill/find_by_tag.py "python"

5. Tìm Ghi chú Mồ côi (find_orphans.py)

Tìm các ghi chú không có bất kỳ liên kết đến hoặc liên kết đi nào.

Cách sử dụng:

bash
python3 skill/find_orphans.py

6. Xem Thống kê (stats.py)

Hiển thị các số liệu thống kê tổng quan về Zettelkasten của bạn.

Cách sử dụng:

bash
python3 skill/stats.py

Kết quả ví dụ:

code
--- Zettelkasten Statistics ---
Total Notes: 50
Total Links: 123

--- Top 5 Tags ---
- python: 15 times
- productivity: 10 times
- AI: 8 times
- learning: 7 times
- project-management: 5 times
---------------------------

7. Xuất Đồ thị Mạng lưới (export_graph.py)

Xuất cấu trúc liên kết của Zettelkasten ra một file JSON để có thể sử dụng cho việc trực quan hóa.

Cách sử dụng:

bash
python3 skill/export_graph.py

Lệnh này sẽ tạo một file có tên zettelkasten_graph.json trong thư mục gốc của dự án. File này chứa danh sách các "nodes" (ghi chú) và "edges" (liên kết) mà bạn có thể dùng với các công cụ như Gephi hoặc các thư viện JavaScript như Vis.js/D3.js.

Chạy Unit Tests

Dự án này bao gồm các unit test để đảm bảo các skill hoạt động chính xác. Các file test được đặt trong thư mục tests/.

Để chạy toàn bộ các bài test, sử dụng lệnh sau từ thư mục gốc của dự án:

bash
python3 -m unittest discover tests