Скиллы

Скилл — сохраненный набор инструкций для агента. Например, как оформлять заметку о релизе или проверять статью по стайлгайду. Агент сам применяет подходящие скиллы, а чтобы он точно использовал конкретный, подключите его к чату вручную.

Скиллы каталога хранятся в самом каталоге, в папке .gramax/agent/skills, и попадают в репозиторий вместе с остальными изменениями.

Создать скилл

  1. В панели агента нажмите + под полем ввода и выберите Скиллы → Управление скиллами.

  2. Нажмите + → Новый скилл.

  3. Заполните название и опишите, что агент должен делать.

Можно и просто попросить агента создать или изменить скилл в чате.

Как написать скилл

Скилл — это статья: заголовок — название скилла, текст — инструкция для агента.

Первый абзац — описание. В списке скиллов агент видит только его и по нему решает, брать ли скилл в работу. Напишите, что делает скилл, когда его использовать и когда нет. Описание — один абзац без пустых строк. Ниже — сама инструкция: шаги, правила, примеры.

Оформляет заметку о новой версии в разделе «Что нового». Используй, когда просят описать релиз. Не используй для правки обычных статей и для переводов. ## Шаги 1. Найди заметку о предыдущей версии и возьми ее за образец. 2. Сгруппируй изменения: новые возможности, улучшения, исправления. ## Правила - Пиши о том, что изменилось для пользователя, а не о том, как это сделано.

Запускать команды и скрипты агент не умеет. Скилл может опираться только на его инструменты.

Подключить к чату

  1. Нажмите + под полем ввода и выберите Скиллы.

  2. Выберите скилл — он появится меткой рядом с +. Нажмите на метку, чтобы открыть скилл, или на крестик, чтобы отключить.

В пространстве Gramax Enterprise Server список скиллов разделен на группы: Каталог — скиллы текущего каталога, Пространство — общие скиллы для всех каталогов. Поиск ищет сразу в обеих группах.

Чтобы изменить скилл, в том же списке выберите Редактировать скилл.

Как агент выбирает скилл

Агент видит только список скиллов — название и описание каждого. Когда задача подходит под описание, он открывает скилл и читает его целиком. Подключенный вручную скилл агент получает сразу и выполняет как обязательную инструкцию.

Встроенные скиллы

Кроме скиллов каталога у агента есть встроенные. Изменить или удалить их нельзя.

  • Диаграммы — создание и правка диаграмм Mermaid.

  • Скиллы — создание и правка скиллов каталога по просьбе в чате.

  • Планирование — сложные задачи: агент сначала изучает материал и составляет план, потом вносит правки.

  • Календарь — работа с календарем по CalDAV, например с Яндекс Календарем или iCloud. Нужна запись Calendar с типом Логин в разделе Ключи и пароли: логин — адрес почты, пароль — пароль приложения, URL — адрес CalDAV-сервера, например https://caldav.yandex.ru.

  • Почта — чтение и отправка писем по IMAP и SMTP. Только в десктопном приложении. Нужна запись Mail с типом Логин в разделе Ключи и пароли: логин — адрес почты, пароль — пароль приложения, URL — почтовый домен, например yandex.ru.

Свой системный промпт

Системный промпт — общие инструкции, по которым агент работает в каталоге: тон, терминология, порядок работы. Чтобы задать свои, создайте в каталоге файл .gramax/agent/system-prompt.md и напишите инструкции в нем.

Файл заменяет стандартные инструкции целиком, а не дополняет их. Список скиллов и названия ключей и паролей агент получает в любом случае. Если файл пустой, агент работает со стандартными инструкциями.