{/ Эта страница автоматически генерируется из SKILL.md навыка с помощью website/scripts/generate-skill-docs.py. Редактируйте исходный SKILL.md, а не эту страницу. /}

Obsidian

Чтение, поиск, создание и редактирование заметок в хранилище Obsidian.

Метаданные навыка


Источник	Встроенный (установлен по умолчанию)
Путь	`skills/note-taking/obsidian`
Платформы	linux, macos, windows

Справочник: полный SKILL.md
ℹ️ Info

Ниже приведено полное определение навыка, которое Hermes загружает при его активации. Это то, что агент видит в качестве инструкций, когда навык активен.

Хранилище Obsidian

Используйте этот навык для работы с хранилищем Obsidian, ориентированным на файловую систему: чтение заметок, составление списка заметок, поиск по файлам заметок, создание заметок, добавление содержимого и добавление вики-ссылок.

Путь к хранилищу

Используйте известный или разрешенный путь к хранилищу перед вызовом файловых инструментов.

Документированное соглашение о пути к хранилищу — это переменная окружения OBSIDIAN_VAULT_PATH, например из ~/.hermes/.env. Если она не установлена, используйте ~/Documents/Obsidian Vault.

Файловые инструменты не раскрывают переменные оболочки. Не передавайте пути, содержащие $OBSIDIAN_VAULT_PATH, в read_file, write_file, patch или search_files; сначала разрешите путь к хранилищу и передайте конкретный абсолютный путь. Пути к хранилищу могут содержать пробелы, что является еще одной причиной предпочитать файловые инструменты командам оболочки.

Если путь к хранилищу неизвестен, terminal допустим для разрешения OBSIDIAN_VAULT_PATH или проверки существования запасного пути. Как только путь станет известен, переключайтесь обратно на файловые инструменты.

Чтение заметки

Используйте read_file с разрешенным абсолютным путем к заметке. Предпочитайте это cat, так как это предоставляет номера строк и пагинацию.

Список заметок

Используйте search_files с target: "files" и разрешенным путем к хранилищу. Предпочитайте это find или ls.

Чтобы вывести список всех markdown заметок, используйте pattern: "*.md" в пути к хранилищу.
Чтобы вывести список подпапки, выполните поиск по абсолютному пути этой подпапки.

Поиск

Используйте search_files как для поиска по именам файлов, так и по содержимому. Предпочитайте это grep, find или ls.

Для имен файлов используйте search_files с target: "files" и шаблоном имени файла pattern.
Для содержимого заметок используйте search_files с target: "content", регулярным выражением содержимого в pattern и file_glob: "*.md", когда вы хотите ограничить совпадения markdown заметками.

Создание заметки

Используйте write_file с разрешенным абсолютным путем и полным markdown содержимым. Предпочитайте это heredocs оболочки или echo, так как это позволяет избежать проблем с кавычками оболочки и возвращает структурированные результаты.

Добавление в заметку

Предпочитайте нативный рабочий процесс с файловыми инструментами, когда это не неудобно:

Прочитайте целевую заметку с помощью read_file.
Используйте patch для добавления с привязкой, когда есть стабильный контекст, например, добавление раздела после существующего заголовка или добавление перед известным конечным блоком.
Используйте write_file, когда перезапись всей заметки понятнее, чем создание хрупкого патча.

Для добавления с привязкой с помощью patch замените якорь на якорь плюс новое содержимое.

Для простого добавления без стабильного контекста terminal допустим, если это самый понятный безопасный вариант.

Целевые правки

Используйте patch для целенаправленных изменений заметок, когда текущее содержимое дает вам стабильный контекст. Предпочитайте это перезаписи текста через оболочку.

Вики-ссылки

Obsidian связывает заметки с помощью синтаксиса [[Note Name]]. При создании заметок используйте их для связывания связанного содержимого.