{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}
Obsidian
Đọc, tìm kiếm, tạo và chỉnh sửa ghi chú trong kho Obsidian.
Siêu dữ liệu kỹ năng
| Nguồn | Đi kèm (được cài đặt theo mặc định) |
| Đường dẫn |
skills/note-taking/obsidian ` | | Nền tảng | Linux, macOS, Windows |
Tham khảo: đầy đủ SKILL.md
Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.
Hầm Obsidian
Sử dụng kỹ năng này cho công việc về hầm Obsidian đầu tiên trên hệ thống tệp: đọc ghi chú, liệt kê ghi chú, tìm kiếm tệp ghi chú, tạo ghi chú, nối thêm nội dung và thêm liên kết wiki.
Đường dẫn Vault
Sử dụng đường dẫn vault đã biết hoặc đã giải quyết trước khi gọi file tools.
Quy ước đường dẫn vault được ghi lại là biến môi trường `OBSIDIAN_VAULT_PATH
, ví dụ từ
~/.Hermes/.env
. Nếu nó không được đặt, hãy sử dụng
~/Documents/Obsidian Vault
.
Công cụ tệp không mở rộng các biến shell. Không chuyển các đường dẫn chứa
$OBSIDIAN_VAULT_PATH
tới read_file
, `write_file
,
patch hoặc
`search_files
; giải quyết đường dẫn vault trước và chuyển một đường dẫn tuyệt đối cụ thể. Đường dẫn vault có thể chứa khoảng trắng, đó là một lý do khác để thích các công cụ tệp hơn các lệnh shell.
Nếu không xác định được đường dẫn vault,
terminal có thể được chấp nhận để phân giải
OBSIDIAN_VAULT_PATH hoặc kiểm tra xem đường dẫn dự phòng có tồn tại hay không. Khi đã biết đường dẫn, hãy quay lại file tools.
Đọc ghi chú
Sử dụng
read_file với đường dẫn tuyệt đối đã được giải quyết đến ghi chú. Thích điều này hơn
cat vì nó cung cấp số dòng và phân trang.
Liệt kê ghi chú
Sử dụng
search_files với
target: "files" và đường dẫn vault đã giải quyết. Thích cái này hơn
find hoặc
`ls
.
- Để liệt kê tất cả các ghi chú đánh dấu, hãy sử dụng
pattern: "*.md"trong đường dẫn vault. - Để liệt kê một thư mục con, tìm kiếm theo đường dẫn tuyệt đối của thư mục con đó.
Tìm kiếm
Sử dụng
search_files cho cả tìm kiếm tên tệp và nội dung. Thích điều này hơn
`grep
,
find hoặc
`ls
.
- Đối với tên tệp, sử dụng
search_filesvớitarget: "files"và tên tệp `pattern
.
- Đối với nội dung ghi chú, hãy sử dụng
search_filesvới `target: "content"
, biểu thức chính quy nội dung là
pattern và
file_glob: "*.md" khi bạn muốn hạn chế kết quả trùng khớp với ghi chú đánh dấu.
Tạo ghi chú
Sử dụng
write_file với đường dẫn tuyệt đối đã được giải quyết và nội dung đánh dấu đầy đủ. Thích điều này hơn shell heredocs hoặc
echo vì nó tránh được các vấn đề trích dẫn shell và trả về kết quả có cấu trúc.
Thêm vào ghi chú
Ưu tiên quy trình làm việc của công cụ tệp gốc khi nó không gây khó xử:
- Đọc ghi chú mục tiêu với `read_file
.
- Sử dụng
patchcho phần bổ sung được neo khi có ngữ cảnh ổn định, chẳng hạn như thêm phần sau tiêu đề hiện có hoặc phần thêm trước khối cuối đã biết. - Sử dụng
write_filekhi viết lại toàn bộ ghi chú sẽ rõ ràng hơn việc xây dựng một bản vá dễ vỡ.
Đối với phần bổ sung được neo bằng `patch
, hãy thay thế neo bằng neo cùng với nội dung mới.
Đối với phần bổ sung đơn giản không có ngữ cảnh ổn định,
terminal có thể chấp nhận được nếu đó là tùy chọn an toàn rõ ràng nhất.
Chỉnh sửa có mục tiêu
Sử dụng
patch để thay đổi ghi chú tập trung khi nội dung hiện tại cung cấp cho bạn ngữ cảnh ổn định. Thích điều này hơn việc viết lại văn bản shell.
Liên kết Wiki
Obsidian liên kết các ghi chú với cú pháp
[[Note Name]]
. Khi tạo ghi chú, hãy sử dụng những ghi chú này để liên kết nội dung liên quan.