vault-connect

name

vault-connect

description

Коннектор из любого другого проекта в vault — записать факт, задачу или заметку в `tasks.md`, `Log/` и `Notes/` vault, не выходя из чужого рабочего каталога и не трогая его файлы. Используй, когда пользователь пишет /vault-connect, «запиши в vault», «залогируй в vault», «поставь задачу в vault», «закрой задачу в vault», находясь в постороннем проекте. Внутри самого vault не нужен — там работают `worklog`, `new-task` и `close-task` напрямую.

vault-connect

Ты в другом проекте, но факт, задача или заметка относятся к vault. Этот скилл — тонкий роутер: он не дублирует правила, а читает реальные скиллы vault и применяет их, записывая только в vault.

Шаг 0. Где vault

VAULT = <НЕ УСТАНОВЛЕН>

VAULT — абсолютный путь к корню vault, вшитый при установке. Если на его месте стоит <НЕ УСТАНОВЛЕН>, ты читаешь шаблон, приехавший вместе с плагином: ничего не записывай, иди в «Установка». Угаданный путь хуже отказа — запись уедет не в тот vault или в чужой проект.

Все целевые файлы — только под VAULT. Никогда не пиши в файлы текущего проекта и не используй относительные пути: твой CWD — чужой проект, tasks.md и Log/ там свои или отсутствуют вовсе.

Если CWD уже под VAULT — ты внутри самого vault, роутер не нужен: скажи это и вызови worklog, new-task или close-task напрямую.

Установка

Раздел для шаблонного состояния. Ставится один раз на машину — копией в user scope агента, а не правкой файла внутри плагина: файлы плагина перезаписываются при каждом обновлении, и вшитый туда путь исчезнет.

1. Спроси абсолютный путь к корню vault. Примеры ответа: ~/vaults/work, на Windows — D:\vaults\work. Разверни ~ в абсолютный путь.
2. Проверь, что каталог существует и в нём лежит tasks.md. Не сошлось — покажи, что нашёл, и спроси путь заново. С непроверенным путём не продолжай.
3. Спроси имя скилла. По умолчанию vault-connect. Если vault у пользователя не один — предложи <имя vault>-connect (work-connect, notes-connect): коннекторы различаются именем каталога, у каждого свой вшитый путь.
4. Спроси, куда положить копию: ~/.claude/skills/<имя>/ — Claude Code, ~/.agents/skills/<имя>/ — Codex. Можно в оба, тогда копий две. Первым предлагай каталог того агента, в котором работаешь сейчас.
5. Скопируй этот файл в выбранные каталоги под именем SKILL.md и в каждой копии:
   • замени <НЕ УСТАНОВЛЕН> на абсолютный путь к vault;
   • приведи name: во фронтматтере к имени каталога;
   • допиши в description: название vault и путь — среди нескольких коннекторов агент выбирает нужный по описанию;
   • удали этот раздел «Установка» — в установленной копии он мёртвый.
6. Скажи, какие файлы созданы, и предупреди: новый скилл агент может увидеть только в новой сессии.
7. Выполни исходный запрос пользователя прямо сейчас по шагам ниже, уже зная путь к vault. Не заставляй перезапускать сессию ради первой записи.

Шаги

1. Определи действие по запросу (таблица ниже). По умолчанию действие — worklog: если в сообщении нет явного сигнала на close-task / new-task / создание заметки, считай присланное движением по задаче и логируй его.

2. Перед записью в Log/ или Notes/ сначала прочитай VAULT/tasks.md. Лог и заметки должны цепляться к существующей задаче, а не висеть отдельно. Найди связанную задачу по теме или проекту, привяжи к ней запись (названием из tasks.md или вайклинком); если работа задачу закрывает — иди через close-task, а не просто worklog. Подходящей задачи нет — всё равно пиши, но осознанно: это новый факт без задачи, а не потерянная запись.

3. Возьми правила нужного скилла. Порядок:

   1. VAULT/skills/<name>/SKILL.md — vault развёрнут из клона базы;
   2. VAULT/.claude/skills/<name>/SKILL.md — раскладка со скиллами внутри .claude;
   3. файлов нет — значит скиллы приехали пользователю плагином: вызови одноимённый скилл (worklog, close-task, new-task) инструментом Skill и примени его правила с префиксом VAULT/, не дав ему записать ничего относительно текущего каталога;
   4. не нашлось ничего — остановись и спроси, где лежат скиллы vault.

   Формат по памяти не сочиняй: правила в vault меняются, а ты видишь их редко.

4. Выполни правила того скилла, префиксуя каждый путь VAULT/:

   • tasks.md → VAULT/tasks.md
   • Log/YYYY/MM/YYYY-MM-DD.md → VAULT/Log/YYYY/MM/YYYY-MM-DD.md
   • Notes/… → VAULT/Notes/…

   Путь дневного лога вложенный: год и месяц — отдельные папки, в имени файла полная дата, например VAULT/Log/2026/06/2026-06-04.md. Дату сразу после Log/ не ставь: без года и месяца рядом с настоящим логом появится файл-дубль за тот же день. Каталогов может не быть — создай их.

5. Дату и время узнавай вызовом date (например date '+%F %H:%M'), а не из окружения агента: оно может отставать. Точное время нужно для правила «00:00–06:00 → пиши в предыдущий день»: ночная работа относится к прошедшему рабочему дню, и в 00:14 2026-06-20 запись идёт в . Маркеры и — строго как в скиллах vault. Заголовок с датой в начале дневного лога не дублируй: имя файла и есть заголовок, файл начинается с .

Роутинг: какое действие → какой скилл

Запрос пользователя	Бери правила из	Пишет в
«запиши / залогируй прогресс, факт, вывод, риск, следующий шаг»	worklog	VAULT/Log/YYYY/MM/YYYY-MM-DD.md
«закрой задачу / задача сделана / отметь выполненной»	close-task	VAULT/tasks.md + VAULT/Log/YYYY/MM/YYYY-MM-DD.md
«добавь / поставь новую задачу»	new-task	VAULT/tasks.md
«создай заметку / куда положить ноту / рисёрч»	obsidian-vault	VAULT/Notes/… или куда велит таксономия
нет явного сигнала (просто факт про этот vault)	worklog (по умолчанию)	VAULT/Log/YYYY/MM/YYYY-MM-DD.md

По умолчанию — worklog. Нет явного действия из таблицы — не спрашивай, трактуй присланное как движение по задаче. Спрашивай, только если запрос честно неоднозначен (текст похож и на новую задачу, и на закрытие). Несколько действий за раз выполняй последовательно: «доделал X, закрой задачу и залогируй» — это один close-task, он сам пишет и в tasks.md, и в лог.

obsidian-vault большой — читай его только когда реально кладёшь заметку и нужна таксономия папок. Для worklog / close-task / new-task хватит их собственных SKILL.md.

Чего не делать

• Не пиши в текущий (чужой) проект. Цель только vault.
• Не используй относительные пути — всегда VAULT/….
• Не коммить и не деплой ни vault, ни чужой репозиторий, если не попросили явно. Скиллы worklog, close-task, new-task сами не коммитят — держи паритет.
• Не выдумывай формат. Не прочитал правила из vault — ты не знаешь актуальных.
• Не ставь дату задним числом, если пользователь её не назвал.

Common Mistakes

Ошибка	Последствие	Фикс
Начал писать, не заметив <НЕ УСТАНОВЛЕН> в Шаг 0	Запись уехала в чужой проект или в никуда	Плейсхолдер = шаблон: сначала «Установка»
Угадал путь к vault вместо того, чтобы спросить	Запись уехала не в тот vault	Путь спрашивается и проверяется по наличию tasks.md
Вписал путь в файл внутри плагина	Обновление плагина затёрло путь	Копия в user scope: ~/.claude/skills/… или ~/.agents/skills/…
Записал в Log/ без префикса VAULT/	Файл создан в чужом проекте	Только абсолютный путь под VAULT
Пропустил год и месяц в пути дневного лога	Рядом с настоящим логом возник дубль за тот же день	Путь всегда VAULT/Log/YYYY/MM/YYYY-MM-DD.md
Записал в лог или заметку, не заглянув в tasks.md	Запись висит отдельно от задачи; закрытая работой задача осталась открытой	Сначала прочитай VAULT/tasks.md, привяжи запись или закрой задачу через close-task
Взял дату из окружения, не вызвав date	Ночная работа записана не в тот день	date '+%F %H:%M', потом правило дня
Записал ночную работу (00:00–06:00) в текущий день	Лог уехал на день вперёд от рабочего дня	В 00:00–06:00 пиши в предыдущий день
Продублировал заголовок с датой в начале лога	Лишний заголовок, имя файла и так дата	Файл начинается с ## <Название задачи>
Сочинил формат лога по памяти	Сломаны ➕ и ✅, кривой заголовок	Сначала возьми правила скилла из vault
Закрыл задачу, но не записал итог в лог	tasks.md и журнал разошлись	Следуй close-task целиком: он пишет в оба
Закоммитил vault «за компанию»	Нежданный коммит в приватном репозитории	Не коммить без явной просьбы

Проверка перед ответом

1. В Шаг 0 стоит настоящий абсолютный путь, а не <НЕ УСТАНОВЛЕН>.
2. Все изменённые файлы — под VAULT, ни одного в текущем проекте.
3. Перед записью в Log/ или Notes/ прочитан VAULT/tasks.md, связанная задача найдена и привязана — или осознанно зафиксировано, что задачи нет.
4. Правила нужного действия взяты из vault, а не по памяти.
5. Формат (чекбоксы, ➕, ✅, заголовки, отступы в подпунктах) совпадает с правилами того скилла.
6. Дата получена вызовом date, не задним числом; при 00:00–06:00 запись ушла в предыдущий день.
7. Ничего не закоммичено и не задеплоено без просьбы.

Связанные скиллы (в vault)

• worklog — факт в дневной лог.
• close-task — закрытие задачи в tasks.md плюс итог в лог.
• new-task — новая задача в tasks.md.
• obsidian-vault — таксономия папок, куда класть заметки, правила вайклинков.