Obsidian

Obsidian Vault

Единый навык для всех операций с хранилищем Obsidian: базовое управление заметками, приём клиппингов, проектные задачи, синтез исследований, записи решений (ADR), дневник, проектные брифы, периодические ревью и анализ графа тегов/ссылок. Все рабочие процессы — filesystem-first: навык работает с Markdown-файлами vault напрямую.

Инструменты

Работа идёт штатными инструментами ассистента над файлами vault:

Операция	Инструмент
Прочитать заметку	Read
Найти файлы по имени/маске	Glob (например **/*.md)
Найти по содержимому	Grep (regex, фильтр glob)
Создать/перезаписать заметку	Write
Точечная правка	Edit
Терминал (git, дата, скрипты)	Bash (POSIX) или PowerShell
Параллельная обработка пачки	Agent (субагенты)
Достать содержимое URL	WebFetch

Полноценная браузерная автоматизация (JS-heavy SPA, скриншоты, PDF в браузере) — вне ядра навыка. Для неё используй Playwright MCP или Claude-in-Chrome, если они подключены.

Навык ведёт обычный Obsidian-flavored markdown + wikilinks. Авторство Obsidian-специфичных форматов — Bases (.base) и Canvas (.canvas) — вне его ядра. Если нужно, чтобы агент писал валидные .base-вьюхи или .canvas-доски, подключи официальные kepano/obsidian-skills (скиллы obsidian-bases и json-canvas, открытая спека Agent Skills; от CEO Obsidian).

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

Определи корень vault один раз, дальше передавай инструментам абсолютные пути. Порядок разрешения:

1. Переменная окружения OBSIDIAN_VAULT_PATH, если задана.
2. Путь, который явно указал пользователь.
3. Автоопределение: Glob по **/.obsidian — эта папка лежит в корне любого vault.

Никогда не передавай инструментам строку $OBSIDIAN_VAULT_PATH буквально — сначала разверни её в реальный путь.

Структура папок (пример)

Навык не требует жёсткой структуры и подстраивается под ту, что есть в vault. Типовая PARA-подобная раскладка (это роли, а не обязательные имена):

Роль	Пример пути	Что хранит
Inbox	inbox/	Клиппинги, необработанное
Projects	projects/<Project>/	Задачи, ADR, проектные документы
Logs	logs/	Дневник работы
Maps	maps/	MOC, дашборды
Attachments	attachments/	Медиа

Если в vault другие имена (например, нумерованные 1-INBOX/, 2-PROJECTS/, 9-META/ATTACHMENTS/) — спроецируй эти роли на них.

Разделы

Раздел	Reference	Когда использовать
Базовые операции	ниже	Чтение, поиск, создание, правка заметок
Клиппинги	references/obsidian-clippings.md	Приём URL/статей/пересланного контента в vault
Задачи	references/obsidian-tasks.md	Проектные задачи со статусами
Vault Zen	references/vault-zen.md	Анализ структуры, предложения по организации
Синтез исследований	references/research-synthesis.md	Сведение нескольких источников в одну заметку
Записи решений	references/decision-records.md	Фиксация архитектурных/технических решений (ADR)
Дневник	references/daily-log.md	Ретроспектива: что сделано, решения, блокеры
Бриф проекта	references/project-brief.md	Снимок статуса проекта из данных vault
Режим ревью	references/review-mode.md	Периодическое ревью: протухшие задачи, inbox, мёртвые проекты
Граф тегов и ссылок	references/tag-link-graph.md	Здоровье тегов, орфаны, MOC

---

Базовые операции

Прочитать заметку

Read с абсолютным путём — даёт номера строк и пагинацию.

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

Glob с паттерном **/*.md под путём vault.

Поиск

• По имени файла: Glob (**/*query*.md)
• По содержимому: Grep (regex, glob: "*.md", path = vault)

Создать заметку

Write с абсолютным путём и полным Markdown-содержимым.

Дописать в заметку

• Прочитай заметку Read
• Edit для якорной вставки (после заголовка, перед известным блоком)
• Write, когда переписать целиком проще, чем городить хрупкий патч

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

Edit, когда текущее содержимое даёт стабильный контекст для замены.

Wikilinks

Obsidian связывает заметки через [[Имя заметки]]. При создании заметок используй их для связи с релевантным контентом.

---

Дата (общее правило для всех разделов)

Многие заметки именуются и помечаются датой. Перед записью любого файла бери сегодняшнюю реальную дату из контекста сессии (харнесс сообщает текущую дату). Не переиспользуй дату из предыдущей заметки и не угадывай год — это типовая ошибка. При необходимости получить дату в терминале: date +%F (bash) или Get-Date -Format yyyy-MM-dd (PowerShell).

---

Шаблоны

• templates/clipping.md — клиппинг с YAML-плейсхолдерами
• templates/task.md — задача со статусом/приоритетом

Скрипты

• scripts/html2md.py — конвертер HTML→Markdown (только stdlib, без внешних зависимостей; markdownify подхватывается автоматически, если установлен). Для качественной конвертации статей/гайдов. Запуск через Bash: python scripts/html2md.py page.html out.md --title "..." --tags "t1,t2". См. references/obsidian-clippings.md → «Quality HTML→Markdown conversion».

Быстрая дизамбигуация

• «Сохрани» / «Save this» → клиппинг → references/obsidian-clippings.md
• «Добавь задачу» / «Task» → проектная задача → references/obsidian-tasks.md
• «Аудит» / «Структура» / «Дзен» / «Разобрать папку» → организация vault → references/vault-zen.md
• «Сравни» / «Синтезируй» / «Что известно про X» → синтез → references/research-synthesis.md
• «Запиши решение» / «ADR» / «Почему выбрали» → решение → references/decision-records.md
• «Лог дня» / «Что сделали» / «Итоги» → дневник → references/daily-log.md
• «Контекст по проекту» / «Бриф» / «Статус проекта» → бриф → references/project-brief.md
• «Ревью» / «Что зависло» / «Почистить inbox» → ревью → references/review-mode.md
• «Карта знаний» / «Orphan» / «MOC» / «Связи» / «Теги в хаосе» → граф → references/tag-link-graph.md
• Обычная заметка → базовые операции выше