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

Читайте, ищите, создавайте и редактируйте заметки в Obsidian Vault.

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

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

Справка: полный SKILL.md

Ниже приведено полное определение навыка, которое Hermes загружает при его активации. Именно эти инструкции агент видит во время работы навыка.

Obsidian Vault

Используйте этот навык для работы с Obsidian Vault по принципу filesystem-first: чтение заметок, просмотр списка заметок, поиск по файлам заметок, создание заметок, дописывание контента и добавление wikilinks.

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

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

Документированная конвенция для пути - переменная окружения OBSIDIAN_VAULT_PATH, например из ~/.hermes/.env. Если она не задана, используйте ~/Documents/Obsidian Vault.

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

Если путь к vault неизвестен, допустимо использовать terminal, чтобы получить OBSIDIAN_VAULT_PATH или проверить существование fallback-пути. Как только путь известен, возвращайтесь к файловым инструментам.

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

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

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

Используйте search_files с target: "files" и вычисленным путем к vault. Это предпочтительнее find или ls.

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

Поиск

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

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

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

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

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

Предпочитайте нативный workflow файловых инструментов, если он не становится громоздким:

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

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

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

Точечные правки

Используйте patch для небольших изменений заметок, когда текущее содержимое дает стабильный контекст. Это предпочтительнее shell-перезаписи текста.

Wikilinks

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