Obsidian

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

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

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

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

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Хранилище Obsidian

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

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

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

Документированное соглашение о пути к хранилищу — переменная окружения OBSIDIAN_VAULT_PATH, например из ${VIBEOS_HOME:-~/.vibeos}/.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 связывает заметки с помощью синтаксиса [[Имя Заметки]]. При создании заметок используйте их для связывания связанного содержимого.