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

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

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

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

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

Obsidian Vault

Используйте этот навык для работы с хранилищем 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-содержимым. Предпочитайте этот способ shell-heredoc или echo, так как он избегает проблем с экранированием оболочки и возвращает структурированные результаты.

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

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

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

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

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

Вики-ссылки​

Obsidian связывает заметки с помощью синтаксиса [[Note Name]]. При создании заметок используйте их для связи связанного содержимого. * Метаданные навыка * Справочник: полный SKILL.md * Путь к хранилищу * Чтение заметки * Список заметок * Поиск * Создание заметки * Добавление к заметке * Целевые правки * Вики-ссылки