DEV Community на русском
Подписаться
Как написать свой первый навык агента
Предоставленный текст объясняет концепцию "навыков" для ИИ-агентов, занимающихся программированием, которые по сути являются структурированными наборами инструкций. Эти навыки разработаны для решения проблемы забывания инструкций ИИ-агентами в последующих сессиях. Навык определяется как папка, содержащая один файл с именем SKILL.md. Этот файл имеет две четкие части: YAML-заголовок и тело в формате markdown.YAML-заголовок включает "имя" и "описание". Описание имеет решающее значение, поскольку оно действует как триггер для агента, информируя его, когда определенный навык актуален для запроса пользователя. Тело в формате markdown содержит фактические инструкции для навыка, включая рабочий процесс, правила и пример. Это тело должно быть простым markdown и избегать кода или конфигурации, выходящей за рамки заголовка.Затем текст иллюстрирует эту концепцию на примере "разбора" навыка генерации сообщений коммитов. Заголовок этого навыка четко определяет его назначение и триггер. Рабочий процесс описывает пятиэтапный процесс генерации сообщений коммитов, включая условие остановки. Предоставляются правила для обеспечения суждений, таких как разделение цели темы и тела, а также избегание мета-комментариев.Пример демонстрирует ожидаемый вывод, а антипаттерны выделяют распространенные сценарии неудач, которых следует избегать. Текст подчеркивает, что каждая часть навыка служит определенной цели: описание для запуска, шаги для порядка выполнения, правила для суждений, пример для формата и антипаттерны для отказов. Чтобы создать новый навык, следует сначала написать описание, затем пронумерованные шаги рабочего процесса с условиями остановки, затем правила суждений, конкретный пример и, наконец, явные антипаттерны.Ключевой принцип заключается в том, чтобы навыки были краткими и сфокусированными, а правила включались только в том случае, если они активно используются. Навыки развертываются путем размещения их папок в каталоге навыков агента, после чего агент автоматически распознает и использует их на основе их описаний. Текст также предоставляет ссылку на репозиторий с готовыми навыками с лицензией MIT для сообщений коммитов, обзора кода, протоколов совещаний, технической корректуры и структурированных исследований. Базовая структура навыков стабильна, что позволяет пользователям настраивать правила для своих конкретных рабочих процессов.