Навыки агента Hermes

Система навыков — ключевая отличительная особенность Hermes Agent: это единственный агент со встроенным циклом обучения, способный создавать навыки, улучшать их через использование и сохранять знания между сессиями.

Что такое навык?

Навыки — это набор инструкций и инструментов, определяющих поведение агента. Они могут:

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

Для получения дополнительной информации обратитесь к руководству по навыкам:https://www.example.com/ai-agent/skills-agent.html。

Навыки против памяти

Практическое правило: если бы вы записали это в справочный документ, это навык; если бы вы поместили это на стикер, это память.

Структура каталога навыка

Все навыки хранятся в~/.hermes/skills/Каталог — это единственный источник данных.

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

~/.hermes/skills/
├── mlops/                     # 分类目录
│   ├── axolotl/
│   │   ├── SKILL.md           # 主指令文件（必须）
│   │   ├── references/        # 补充文档（按需加载）
│   │   ├── templates/         # 输出模板
│   │   ├── scripts/           # 辅助脚本
│   │   └── assets/            # 附属资源
│   └── vllm/
│       └── SKILL.md
├── devops/
│   └── deploy-k8s/            # Agent 自动创建的技能
│       ├── SKILL.md
│       └── references/
├── .hub/                      # Skills Hub 状态
│   ├── lock.json
│   ├── quarantine/            # 安全隔离区
│   └── audit.log
└── .bundled_manifest          # 记录内置技能版本

Единственные обязательные файлы для каждого каталога навыка —SKILL.mdОстальные подкаталоги необязательны.

Агент может изменять или удалять любой навык — встроенный, установленный из Hub или созданный самостоятельно.

Прогрессивное раскрытие: механизм загрузки, экономящий токены

Одним из самых продуманных решений в системе навыков являетсяпрогрессивное раскрытие— агент не запихивает всё содержимое навыков в контекст сразу, а загружает его тремя слоями по мере необходимости.

Level 0: skills_list()              → [{name, description, category}, ...]
                                       会话启动时加载，约 3,000 tokens
                                       ↓ 只有需要用某个技能时，才继续
Level 1: skill_view(name)           → 完整 SKILL.md 内容 + 元数据
                                       ↓ 只有需要参考文档时，才继续
Level 2: skill_view(name, path)     → 技能内的特定 references/ 文件

Практическое значение этого решения вполне очевидно:

• У вас установлено 50 навыков, но в этом сеансе использовался только 1 — только полное содержимое этого одного навыка расходует токены.
• Список навыков уровня 0 (~3,000 токенов) всегда загружается при запуске сеанса, позволяя агенту узнать, какие навыки доступны.
• Остальное загружается только тогда, когда агент определит, что это нужно — нет использования, нет затрат.

Прогрессивное раскрытие — это то, что отличает систему навыков отзапихивания всей документации в системный промпт. Это ключевое проектное решение. Оно гарантирует, что количество навыков может расти неограниченно, а расход токенов за сеанс остаётся практически постоянным.

Список встроенных навыков

Hermes поставляется с большим набором встроенных навыков, которые можно использовать напрямую.

Запустите hermes из командной строки:

hermes

Используйте следующую команду, чтобы просмотреть команды, связанные с навыками:

/skills

Следующая команда позволяет просмотреть все навыки в сессии:

/skills browse

Просмотр прямо в командной строке с помощью hermes:

hermes skills list

В настольной версии нажмите меню Skills & Tools слева, чтобы просмотреть:

Категории навыков

Встроенные навыки хранятся в подкаталогах, сгруппированных по функциям:

Дополнительные навыки (не устанавливаются по умолчанию)

Дополнительные навыки поставляются вместе с hermes-agent, хранятся вoptional-skills/но не активируются по умолчанию и требуют явной установки.

Эти навыки обычно требуют дополнительных зависимостей или предназначены для узкоспециализированных задач:

Использование навыков

У навыков есть два метода запуска: прямой вызов через слэш-команды и автоматический запуск с помощью естественного языка.

Слэш-команды для прямого вызова

Каждый установленный навык автоматически становится слэш-командой.

Используйте напрямую на любой платформе (CLI, Telegram, Discord и т. д.):

встроенныйplanНавык — хороший пример: запустите/plan [请求]После этого инструкция навыка велит Hermes сначала проверить контекст, затем сгенерировать план реализации в формате Markdown и сохранить его в.hermes/plans/, а не выполнять задачу напрямую.

Запуск с помощью естественного языка

Навыки также можно запускать через естественную беседу; Hermes будет использоватьskill_viewАвтоматическая загрузка инструментов:

Агент распознает необходимость вarxivнавыке, автоматически загрузит его и затем выполнит.

Поиск навыков по ключевому слову

Установка навыков из Hub

Помимо встроенных навыков, вы также можете устанавливать сторонние навыки из Hub сообщества agentskills.io.

Установка из командной строки

Что происходит после установки:

1. Каталог навыка копируется в~/.hermes/skills/
2. появляется вskills_listв выводе
3. Можно использовать как слэш-команду

Установленные навыки вновом диалогевступают в силу. Чтобы использовать их сразу в текущей сессии, используйте /reset, чтобы начать новую сессию, или добавьте параметр --now, чтобы немедленно обновить кэш промптов (это расходует дополнительные токены).

Проверка установки

Добавьте источник навыков из репозитория GitHub

Команда /learn: создание навыка из источника в один клик

/learnЭто краткий путь, позволяющий быстро превратить то, что вы уже знаете, — или кучу справочных материалов — в переиспользуемые навыки, без ручного написания SKILL.md.

Здесь нет жёстких рамок: укажите на что угодно, что можете описать, и агент использует имеющиеся инструменты, чтобы собрать материал, а затем создаёт навык, следуя стандартным соглашениям по созданию навыков.

Как работает /learn

Весь процесс разделён на три шага:

1. Агент использует существующие инструменты для сбора исходного материала (чтение файлов, парсинг веб-страниц, анализ текущего разговора)
2. Создаёт черновик SKILL.md в соответствии с официальными стандартами оформления Skill (включая описание ≤60 символов, стандартный порядок разделов, фреймворк инструментов Hermes, без вымышленных команд)
3. Черезskill_manageСохранение с помощью инструмента — если включеноwrite_approval, сначала запрашивается одобрение

/learn доступен в CLI, шлюзе сообщений, TUI и Dashboard с одинаковым поведением. Страница Skills в Dashboard также предоставляет графическую панельИзучить навык, содержащую три поля ввода: каталог, URL и произвольный текст.

Агент автоматически создаёт навыки

Это самая отличительная особенность системы навыков Hermes: Hermes учится на опыте, сохраняя повторно используемые процессы в виде навыков.

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

Навыки накапливаются со временем, благодаря чему агент становится всё более умелым в работе с вашими конкретными задачами и средой.

Момент срабатывания

После завершения сложной задачи (обычно включающей более 5 вызовов инструментов) Hermes может по собственной инициативе предложить:

我注意到我们刚才走完了一个完整的 Docker 多阶段构建流程。
要不要我把这个工作流程保存为技能，下次可以直接复用？

Вручную попросить агента создать навык

Вы также можете по собственной инициативе запросить это в любой момент:

Управление разрешениями на запись навыков

По умолчанию агент может свободно создавать и изменять навыки.

После включения режима одобрения агент при каждой попытке создать или изменить навык будет сначала запрашивать ваше подтверждение:

При включённом write_approval вы можете предварительно просмотреть содержимое навыка, которое агент собирается записать, прежде чем решить, одобрять ли. Это важная граница безопасности — файлы навыков не имеют подписанной информации о происхождении и не позволяют отличитьнаписанное самим агентомипомещённое в директорию вручную。

Подробное объяснение формата SKILL.md

Навыки — это файлы Markdown с метаданными YAML frontmatter.

Ниже приведена полная спецификация формата, включая все необязательные и обязательные поля:

Ограничения полей

Условная активация: интеллектуальный механизм показа/скрытия

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

Это очень полезно при развертываниях в нескольких средах — один и тот же список навыков автоматически адаптируется к разным средам.

Практические примеры: встроенныеduckduckgo-searchИспользованный навыкfallback_for_toolsets: [web]。

Когда у вас настроен API-ключ Firecrawl (набор веб-инструментов доступен), этот навык автоматически скрывается, и агент напрямую используетweb_search。

Когда API-ключ отсутствует (набор веб-инструментов недоступен), навык DuckDuckGo автоматически появляется как запасной вариант.

Пакет навыков: комбинированная загрузка

Пакет навыков — это YAML-файл, который объединяет несколько навыков в одной слэш-команде.

Запустите/<bundle-name>При срабатывании все навыки, перечисленные в пакете, загружаются одновременно — подходит для сценариев, где задача всегда требует одного и того же набора навыков.

Создать пакет навыков

При использовании:

Агент загружает все три навыка одновременно и выполнитрефакторинг middleware аутентификации. Добавлено как пользовательские инструкции.

Формат файла пакета навыков

Пакеты навыков хранятся в~/.hermes/skill-bundles/<slug>.yaml：

Управление навыками на уровне платформы

Разные платформы могут включать разные подмножества навыков.

Например, навыки, связанные с разработкой, не обязательно должны отображаться в Telegram:

Это открывает интерактивный TUI, который позволяет включать или отключать навыки для каждой платформы (CLI, Telegram, Discord и т. д.).

Создание навыков вручную: начало работы за пять минут

Навыки — это просто Markdown-файлы с метаданными YAML frontmatter.

Создание навыка занимает меньше пяти минут, регистрация не требуется, просто поместите его в~/.hermes/skills/Можно использовать.

Шаг 1: Создайте каталог

Шаг 2: Напишите SKILL.md

Шаг 3 (необязательно): Добавьте справочные файлы

Шаг 4: Тестирование

Вопросы безопасности навыков

Блокировка записи до подтверждения

Файлы навыков не содержат подписанной информации о происхождении—невозможно отличитьнаписанные самим агентомиразмещённые вручную в каталоге。

Механизм подтверждения записи иpending/Управление каталогами — ключевая граница безопасности.

После включения подтверждения,write_approval: trueприводит к тому, что все операции записи навыков (включая автоматическое создание, инициированное агентом) откладываются до подтверждения; вы проверяете их, прежде чем решить, разрешить ли запись.

Проверка безопасности

Содержимое навыков проверяется на угрозы перед загрузкой, обнаруживая вредоносные шаблоны, такие как инъекция промптов, инструкции по установке бэкдоров и т. д.

Содержимое, соответствующее шаблонам угроз, заменяется на[BLOCKED: ...]заполнитель, не позволяющий ему достичь модели — сам файл не удаляется, блокируется только угрожающее содержимое.

Что учитывать при установке из Hub

Обновления и обслуживание навыков

Проверить и обновить

Сбросить встроенные навыки

Если вы изменили встроенный навык и хотите восстановить исходный:

Удаление навыков из Hub

При удалении можно удалить только навыки, установленные через Hub; встроенные навыки удалить нельзя (но можно прекратить получать обновления с помощью `hermes skills opt-out`).

Публикация навыков в Skills Hub

Если вы создали полезный навык, вы можете опубликовать его на agentskills.io, чтобы поделиться с сообществом:

Схема: навыки + запланированные задачи

Навыки могут объявлять расписание, превращаясь в шаблон автоматизации, которым можно поделиться:

После установки этого навыка запустите/suggestionsВы увидите, как Hermes автоматически предложит создать соответствующую запланированную задачу:

Внешний каталог навыков

Если вы поддерживаете навыки вне Hermes — например, навык, используемый несколькими ИИ-инструментами~/.agents/skills/Каталоги — позволяет Hermes одновременно сканировать эти каталоги.

Поддержка путей~развернуть и${VAR}Подстановка переменных окружения.

Важные правила：

• Локальный каталог (~/.hermes/skills/) имеет приоритет — если навыки имеют одинаковые имена, локальная версия переопределяет внешнюю версию
• Внешние каталоги не являются границами защиты от записи: если у процесса Hermes есть права на запись, Агент может изменять навыки во внешних каталогах.

Краткий справочник по основным командам

Создание пользовательских навыков

Навыки хранятся в~/.hermes/skills/в каталоге. Каждый навык — это один, который включаетskill.mdКаталог:

~/.hermes/skills/
└── my-custom-skill/
    └── skill.md

Формат навыка

---
name: my-custom-skill
description: 一个有用的技能描述
version: 1.0.0
author: your-username
tags: [utility, example]
---

# 技能指令

您是一个专业的[角色]，擅长[领域]...

## 核心能力

1. 能力 A
2. 能力 B
3. 能力 C

## 使用示例

### 示例 1
[描述]

### 示例 2
[描述]

Метаданные навыка

Справочник по командам навыков