Newer
Older
AI_Lab_SCRUME_Co / README.md

Dionis — агент для Василия

Профиль Hermes Agent: личный помощник руководителя. Персона, базовый конфиг, 58 скиллов. Автор: AI laboratory SCRUM company.

Получателю агента: пошаговая инструкция — INSTALL.md. Короткий путь — запустить setup.cmd двойным кликом (он ставит Git, Hermes и агента, оставляет вписать только ключ). Вручную — из файла vasily-<версия>.bundle, доступ к репозиторию не нужен.

Автору: это исходник дистрибутива. Пакет для передачи собирается скриптом dist/vasily-setup/build-package.ps1.

Что внутри

Путь Что это
distribution.yaml манифест: имя, версия, автор, требуемые переменные окружения
SOUL.md персона агента (правится под владельца)
config.yaml модель, провайдер (Polza.ai), инструменты, язык — без ключей
skills/ 58 штатных скиллов Hermes (документы, таблицы, PDF, поиск, почта, заметки, код)
INSTALL.md пошаговая инструкция для получателя
.env.template шаблон .env, устанавливается как .env.EXAMPLE

Ключ API живёт только в .env получателя: в config.yaml стоит key_env: HERMES_CUSTOM_POLZA_AI_API_KEY — имя переменной, а не значение. В репозитории ключей нет.

Что не входит

  • API-ключи, auth.json, пароли dashboard — только свои, локальные.
  • MCP-серверы (Revit, AutoCAD и прочее) — не подключены, ставятся отдельно под свои задачи.
  • SSH-бэкенд, cron-задачи, память и история автора.

Передать получателю (файлом)

cd <этот каталог>
git bundle create ../vasily-<версия>.bundle --all
git bundle verify ../vasily-<версия>.bundle     # ожидается «is okay» + «complete history»

Получатель разворачивает бандл по INSTALL.md (шаг 3).

Обновить агента у получателя

Поднять версию в distribution.yaml, закоммитить, создать новый бандл и передать файл. Получатель ставит его с флагом --force (шаг 7 в INSTALL.md): файлы агента перезаписываются, .env с ключом, память и история остаются.

Windows-ловушка при --force: git кладёт файлы внутри .git/objects/pack с атрибутом ReadOnly, и установщик падает с PermissionError: [WinError 5] при попытке удалить прежнюю копию. Лечится снятием атрибута (команда в INSTALL.md, шаг 7). Альтернатива без этого шага — установить поверх через hermes profile update vasily, если источник в манифесте указывает на актуальный каталог/URL: update тянет дистрибутив заново и тоже упирается в тот же ReadOnly, так что снятие атрибута — основной путь.

Проверка перед передачей

hermes profile install <этот каталог> --name vasily-test --yes
hermes profile info vasily-test        # версия, источник, требуемая переменная
hermes -p vasily-test chat -q "Назови себя и кому помогаешь."
hermes profile delete vasily-test -y   # на Windows сначала: hermes -p default gateway stop

Публикация в git-репозиторий (если нужен вариант A — обновление одной командой):

git tag v<версия> && git push origin master --tags

MCP (по желанию)

Добавляется уже в установленном профиле:

hermes -p vasily mcp add <имя> --command <команда>
hermes -p vasily mcp catalog          # посмотреть, что есть в каталоге