Технический контекст
Я уткнулся в банальную, но противную проблему: у одного агента команда уже есть, у второго лежит старая версия, у третьего вообще другая папка. После пары таких сюрпризов я перестал чинить руками и собрал маленький sync-слой для AI integration между своими агентами.
Логика простая: один репозиторий стал source of truth для skills и commands. Дальше я либо линкуют папки через symlink, либо гоняю rsync, если окружение капризное и ссылки ведут себя нестабильно.
Структура у меня максимально скучная, и это плюс: отдельные каталоги skills/, commands/, конфиг с перечнем агентов и сам sync.sh. Когда всё лежит в одном месте, versioning через git получается почти бесплатно, а откат до рабочей версии занимает минуты, а не вечер.
Я быстро понял, что symlink-подход приятнее всего локально. Меняю один файл, и все агенты сразу видят одинаковый набор навыков. Но если среда изолированная, контейнерная или файловая система чудит, копирование через rsync с флагом delete надёжнее и предсказуемее.
Ещё один важный момент: я не тяну всё подряд в рантайм. Метаданные навыка загружаются сразу, а полные инструкции, шаблоны и скрипты подтягиваются только когда задача реально совпала. Контекст не пухнет, агент не тупит, токены не горят зря.
Что это меняет в работе
Главный выигрыш я почувствовал не в красоте структуры, а в исчезновении дрейфа. Если я обновил команду или скилл один раз, мне не нужно помнить, где ещё это поправить. Для AI implementation это критично: автоматизация ломается не из-за модели, а из-за мелкого рассинхрона вокруг неё.
Выигрывают команды, у которых несколько агентов, песочниц и сред. Проигрывают ручные процессы, где знания живут в случайных папках и чатах. Особенно больно тем, кто уже начал build AI automation, но до сих пор таскает промпты и команды вручную.
Я такие вещи вижу у клиентов постоянно: хороший агент есть, а окружение вокруг него собрано на честном слове. В Nahornyi AI Lab мы обычно начинаем именно с этой невидимой части, потому что AI automation для бизнеса работает нормально только тогда, когда навыки, команды и конфиги ведут себя одинаково везде. Если у вас сейчас время уходит на такой зоопарк, можно просто разобрать ваш стек и собрать спокойную, повторяемую схему без ручного героизма.