Пользовательские навыки

Пользовательский навык закрепляет методику команды: правила построения моделей, допустимые параметры, порядок расчетов, проверки и формат отчета. Он хранится в вашей среде Engee и доступен агенту через Engee MIND.

Создание с помощью агента

Опишите процедуру и попросите использовать engee_skill_create. Например:

Создай пользовательский навык engee_step_response_check для проверки переходной характеристики. На входе — модель, имя выходного сигнала, длительность расчета и допуски. Навык должен запускать модель, получать данные через To Workspace, проверять конечность значений и сравнивать установившееся значение с заданным эталоном. Сохраняй CSV и отчет в каталоге проекта. Не меняй параметры объекта автоматически.

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

Структура пакета

engee_step_response_check/
├── manifest.yaml
├── SKILL.md
└── reference/
    └── acceptance.md

manifest.yaml содержит метаданные и условия выбора навыка. SKILL.md содержит исполнимую последовательность действий. Объемные справки и шаблоны помещаются в reference/; каждый файл перечисляется в манифесте.

Пример манифеста

Пример рассчитан на фактически созданный файл reference/acceptance.md. Если справки нет, используйте reference-files: [].

schema_version: 1
name: engee_step_response_check
version: 0.1.0
title: "Проверка переходной характеристики"
description: >
  Расчет заданной модели и сравнение установившегося значения
  выходного сигнала с эталоном и допусками пользователя.
language: ru
audience: [assistant]
priority: 0.5
when-to-use:
  - "Нужно проверить переходную характеристику по заданному эталону"
when-not:
  - "Требуется автоматически настроить регулятор"
requires-tools:
  - engee_status
  - eval_code
  - engee_diagnose
requires-products:
  - Engee
reference-files:
  - reference/acceptance.md

Содержание SKILL.md

Опишите назначение и ограничения; обязательные входные данные с единицами; выбор проекта и файлов; последовательность действий; реакцию на ошибки; критерии завершения и состав выдачи.

Пишите конкретно:

получи данные текущего прогона

проверь отсутствие NaN/Inf

сравни с допуском пользователя

Не записывайте в навык PAT, пароли и пути к чужим проектам. Не обещайте функции, которые не подтверждены API или проверенным примером. Явно отмечайте параметры, которые задает пользователь.

Установка и проверка в своей среде

Подготовьте пакет локально или поручите агенту создать его сразу в сессии Engee.
Разместите его в /user/.engee-skills/engee_step_response_check/ либо /user/skills/engee_step_response_check/. При передаче локальных файлов используйте file_upload для каждого файла пакета.
Попросите вызвать skill_list и найти навык. При запуске среды engee_start также выполняет сканирование пользовательских навыков.
Загрузите навык по точному пути из результата сканирования, например /user/.engee-skills/engee_step_response_check/SKILL.md, через skill_load.
Проверьте содержимое, источник pod и доступность справочных файлов.
Выполните пробный запуск на отдельной тестовой модели с известным результатом. Проверьте обычный случай и случай, когда критерий не выполнен.
Исправьте процедуру, увеличьте версию и повторите загрузку навыка.

Если навык не обнаружен, проверьте регистр имени, наличие обоих основных файлов и совпадение name с именем каталога. Не перезапускайте вычислительную среду только ради повторного поиска, когда достаточно skill_list.

Обновление и совместное использование

Навык в личной сессии не становится автоматически общедоступным. Общий набор публикуется разработчиками Engee MIND. Публикация не нужна для личного использования.