Compétences de l'agent Hermes

Le système de compétences est la fonctionnalité différenciante clé de l'agent Hermes—c'est le seul agent doté d'une boucle d'apprentissage intégrée, capable de créer des compétences, d'améliorer les compétences grâce à l'utilisation et de maintenir les connaissances au fil des sessions.

Qu'est-ce qu'une compétence ?

Les compétences sont un ensemble d'instructions et d'outils qui définissent le comportement de l'agent. Elles peuvent :

• Flux de travail automatisé— Encapsuler des modèles de tâches courantes
• Apprentissage inter-sessions— Enregistrer et réutiliser des solutions réussies
• Partager avec la communauté— Publier et installer des compétences créées par d'autres
• Auto-amélioration— S'améliorer continuellement grâce à l'utilisation

Pour plus d'informations, consultez le tutoriel sur les compétences :https://www.example.com/ai-agent/skills-agent.html。

Compétences vs Mémoire

Règle empirique : si vous l'écriviez dans un document de référence, c'est une compétence ; si vous le mettiez sur un post-it, c'est une mémoire.

Structure du répertoire des compétences

Toutes les compétences sont stockées dans~/.hermes/skills/Répertoire — c'est la seule source de données.

Lors de l'installation initiale, les compétences intégrées sont copiées du dépôt vers ce répertoire. Les compétences installées via le Hub et les compétences créées automatiquement par l'Agent sont également enregistrées ici.

~/.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          # 记录内置技能版本

Les seuls fichiers requis pour chaque répertoire de compétence sontSKILL.mdLe reste des sous-répertoires est facultatif.

L'agent peut modifier ou supprimer n'importe quelle compétence—qu'elle soit intégrée, installée depuis le Hub ou auto-créée.

Divulgation progressive : un mécanisme de chargement économe en tokens

L'une des conceptions les plus ingénieuses du système de compétences estla divulgation progressive—L'agent n'entasse pas tout le contenu des compétences dans le contexte d'un seul coup, mais le charge en trois couches à la demande.

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

L'importance pratique de cette conception est très directe :

• Vous avez 50 compétences installées, mais seulement 1 a été utilisée dans cette session—seul le contenu complet de celle-ci consomme des tokens.
• La liste de compétences de niveau 0 (~3,000 tokens) est toujours chargée au démarrage de la session, ce qui permet à l'agent de savoir quelles compétences sont disponibles.
• Le reste n'est chargé que lorsque l'agent détermine que c'est nécessaire—aucune utilisation, aucun coût.

La divulgation progressive est ce qui distingue le système de compétences del'intégration de toute la documentation dans le prompt systèmeC'est la conception clé. Elle garantit que le nombre de compétences peut croître indéfiniment tandis que le coût en tokens par session reste essentiellement constant.

Liste des compétences intégrées

Hermes est fourni avec un vaste ensemble de compétences intégrées qui peuvent être utilisées directement.

Lancez hermes depuis la ligne de commande :

hermes

Utilisez la commande suivante pour afficher les commandes liées aux compétences :

/skills

La commande suivante permet d’afficher toutes les compétences d’une session :

/skills browse

Affichez directement en ligne de commande avec hermes :

hermes skills list

Dans la version bureau, cliquez sur le menu Compétences et outils à gauche pour afficher :

Catégories de compétences

Les compétences intégrées sont stockées dans des sous-répertoires classés par fonction :

Compétences optionnelles (non installées par défaut)

Les compétences optionnelles sont publiées en même temps que hermes-agent, stockées dansoptional-skills/mais ne sont pas activées par défaut et nécessitent une installation explicite.

Ces compétences nécessitent généralement des dépendances supplémentaires ou servent à des usages de niche :

Utiliser des compétences

Les compétences ont deux méthodes de déclenchement : l'invocation directe via des commandes slash et le déclenchement automatique via le langage naturel.

Commandes slash pour une invocation directe

Chaque compétence installée devient automatiquement une commande slash.

Utilisez directement sur n'importe quelle plateforme (CLI, Telegram, Discord, etc.) :

intégréplanUne compétence est un bon exemple : exécutez/plan [请求]Ensuite, l'instruction de la compétence indique à Hermes de d'abord vérifier le contexte, puis de générer un plan d'implémentation au format Markdown et de l'enregistrer dans.hermes/plans/, plutôt que d'exécuter la tâche directement.

Déclenchement en langage naturel

Les compétences peuvent aussi être déclenchées via une conversation naturelle ; Hermes utiliseraskill_viewChargement automatique des outils :

L'Agent reconnaîtra le besoin d'unearxivcompétence, la chargera automatiquement, puis l'exécutera.

Rechercher des compétences par mot-clé

Installation de compétences depuis le Hub

Outre les compétences intégrées, vous pouvez également installer des compétences tierces depuis le Hub communautaire agentskills.io.

Installation en ligne de commande

Que se passe-t-il après l'installation :

1. Le répertoire de la compétence est copié dans~/.hermes/skills/
2. apparaît dansskills_listdans la sortie
3. Peut être utilisée comme commande slash

Les compétences installées prennent effet dansune nouvelle conversation. Pour l'utiliser immédiatement dans la session en cours, utilisez /reset pour démarrer une nouvelle session, ou ajoutez le paramètre --now pour actualiser immédiatement le cache du prompt (ce qui consomme quelques jetons supplémentaires).

Vérifier l'installation

Ajouter une source de compétence depuis un dépôt GitHub

commande /learn : générer une compétence à partir d'une source en un clic

/learnC'est un raccourci pour transformer rapidement ce que vous savez déjà — ou une pile de documents de référence — en compétences réutilisables, sans écrire SKILL.md à la main.

C'est ouvert : indiquez tout ce que vous pouvez décrire, et l'agent utilise ses outils existants pour rassembler le matériel, puis génère la compétence en suivant les conventions de rédaction standard.

Comment fonctionne /learn

L'ensemble du processus est divisé en trois étapes :

1. L'agent utilise les outils existants pour collecter le matériel source (lecture de fichiers, extraction de pages web, analyse de la conversation en cours)
2. Rédige SKILL.md en suivant les normes officielles de création de Skills (y compris une description ≤60 caractères, l'ordre standard des sections, le cadre d'outils Hermes, aucune commande inventée)
3. Viaskill_manageSauvegarde de l'outil — si activéewrite_approval, l'approbation est demandée en premier

/learn est disponible dans CLI, la passerelle de messages, TUI et Dashboard avec un comportement identique. La page Skills du Dashboard fournit également un panneau graphiqueApprendre une compétence, contenant trois champs de saisie : répertoire, URL et texte libre.

L'agent crée automatiquement des compétences

C'est la partie la plus distinctive du système de compétences d'Hermes : Hermes apprend de l'expérience en enregistrant des processus réutilisables sous forme de compétences.

Lorsqu'il résout un problème complexe, découvre un workflow ou est corrigé, il peut conserver ces connaissances sous forme de documents de compétences à charger dans les futures sessions.

Les compétences s'accumulent au fil du temps, ce qui rend l'agent de plus en plus apte à gérer vos tâches et votre environnement spécifiques.

Moment du déclenchement

Après avoir terminé une tâche complexe (impliquant généralement plus de 5 appels d'outils), Hermes peut proposer proactivement :

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

Demander manuellement à l'agent de créer une compétence

Vous pouvez également le demander de manière proactive à tout moment :

Contrôle des autorisations d'écriture des compétences

Par défaut, l'agent est libre de créer et de modifier des compétences.

Après avoir activé le mode d'approbation, l'agent demandera d'abord votre confirmation chaque fois qu'il voudra créer ou modifier une compétence :

Avec write_approval activé, vous pouvez prévisualiser le contenu de la compétence que l'agent a l'intention d'écrire avant de décider si vous l'approuvez. Il s'agit d'une frontière de sécurité importante — les fichiers de compétences n'ont pas d'informations de provenance signées et ne peuvent pas distinguerÉcrit par l'agent lui-mêmeetPlacé manuellement dans le répertoire。

Format de SKILL.md expliqué en détail

Les Skills sont des fichiers Markdown avec des métadonnées de frontmatter YAML.

Voici la spécification complète du format, incluant tous les champs optionnels et obligatoires :

Limites des champs

Activation conditionnelle : mécanisme intelligent d'affichage/de masquage

Les compétences peuvent être filtrées en fonction des outils disponibles dans la session en coursAffichage ou masquage automatique, aucune gestion manuelle nécessaire.

C'est très utile dans les déploiements multi-environnements—la même liste de compétences s'adapte automatiquement à différents environnements.

Exemples pratiques: intégréduckduckgo-searchCompétence utiliséefallback_for_toolsets: [web]。

Lorsque vous avez configuré une clé API Firecrawl (ensemble d’outils web disponible), cette compétence est automatiquement masquée et l’agent utilise directementweb_search。

Lorsque la clé API est manquante (ensemble d’outils web indisponible), la compétence DuckDuckGo apparaît automatiquement comme solution de repli.

Pack de compétences : chargement combiné

Un pack de compétences est un fichier YAML qui combine plusieurs compétences sous une seule commande slash.

Exécutez/<bundle-name>Lorsqu’il est déclenché, toutes les compétences listées dans le pack se chargent simultanément — adapté aux scénarios où une tâche nécessite toujours le même ensemble de compétences.

Créer un pack de compétences

Lors de l'utilisation :

L'agent charge les trois compétences simultanément et vaRefactoriser le middleware d'authentificationAjouté en tant qu'instructions utilisateur.

Format de fichier du pack de compétences

Les paquets de compétences sont stockés dans~/.hermes/skill-bundles/<slug>.yaml：

Gestion des compétences au niveau de la plateforme

Différentes plateformes peuvent activer différents sous-ensembles de compétences.

Par exemple, les compétences liées au développement n'ont pas besoin d'apparaître sur Telegram :

Ceci ouvre une TUI interactive qui vous permet d'activer ou de désactiver des compétences par plateforme (CLI, Telegram, Discord, etc.).

Création manuelle : démarrer en cinq minutes

Les compétences ne sont que des fichiers Markdown avec des métadonnées de frontmatter YAML.

Créer une compétence prend moins de cinq minutes, aucune inscription requise, il suffit de la placer dans~/.hermes/skills/Vous pouvez l'utiliser.

Étape 1 : Créer un répertoire

Étape 2 : Écrire SKILL.md

Étape 3 (facultative) : Ajouter des fichiers de référence

Étape 4 : Test

Considérations de sécurité pour les compétences

Verrouillage d'approbation d'écriture

Les fichiers de compétences n'ont aucune information de provenance signée—impossible de distinguerÉcrit par l'Agent lui-mêmeetPlacé manuellement dans le répertoire。

Mécanisme d'approbation d'écriture etpending/La gestion des répertoires est une frontière de sécurité clé.

Une fois l'approbation activée,write_approval: truecela entraîne la mise en attente d'approbation de toutes les opérations d'écriture de compétences (y compris la création automatique initiée par l'agent) ; vous examinez avant de décider si vous autorisez l'écriture.

Analyse de sécurité

Le contenu des compétences est analysé à la recherche de menaces avant le chargement, permettant de détecter des motifs malveillants tels que l'injection de prompt, les instructions d'installation de porte dérobée, etc.

Le contenu correspondant aux motifs de menace est remplacé par[BLOCKED: ...]espace réservé, l'empêchant d'atteindre le modèle—le fichier lui-même n'est pas supprimé, seul le contenu menaçant est bloqué.

Considérations lors de l'installation depuis le Hub

Mises à jour et maintenance des compétences

Vérifier et mettre à jour

Réinitialiser les compétences intégrées

Si vous avez modifié une compétence intégrée et souhaitez restaurer l'original :

Désinstallation des compétences du Hub

La désinstallation ne peut supprimer que les compétences installées via le Hub ; les compétences intégrées ne peuvent pas être désinstallées (mais vous pouvez arrêter de recevoir les mises à jour via `hermes skills opt-out`).

Publier des compétences sur le Skills Hub

Si vous avez créé une compétence précieuse, vous pouvez la publier sur agentskills.io pour la partager avec la communauté :

Blueprint : compétences + tâches planifiées

Les compétences peuvent déclarer une planification, ce qui les transforme en un modèle d'automatisation partageable :

Après avoir installé cette compétence, exécutez/suggestionsVous pouvez voir Hermes proposer automatiquement la création de la tâche planifiée correspondante :

Répertoire de compétences externe

Si vous maintenez des compétences en dehors de Hermes — par exemple, une partagée par plusieurs outils d'IA~/.agents/skills/Répertoires — permet à Hermes d'analyser ces répertoires simultanément.

Prise en charge des chemins~développer et${VAR}Substitution de variables d'environnement.

Règles importantes：

• Répertoire local (~/.hermes/skills/) est prioritaire—lorsque des skills partagent le même nom, la version locale remplace la version externe
• Les répertoires externes ne sont pas des limites de protection en écriture : si le processus Hermes dispose des permissions d'écriture, l'Agent peut modifier les skills dans les répertoires externes.

Référence rapide des commandes courantes

Créer des compétences personnalisées

Les compétences sont stockées dans~/.hermes/skills/dans le répertoire. Chaque compétence est une qui inclutskill.mdRépertoire de :

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

Format de compétence

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

# 技能指令

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

## 核心能力

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

## 使用示例

### 示例 1
[描述]

### 示例 2
[描述]

Métadonnées de compétence

Référence des commandes de compétence