Level CLI peut générer une Compétence d'Agent qui apprend à un agent de codage compatible comment utiliser votre version installée de lvl. Vous choisissez l'agent de codage, le modèle et le fournisseur de jetons. Level fournit les commandes CLI et la SKILL.md référence.
ℹ️ REMARQUE : Level n'héberge pas le modèle de langage et ne fournit pas de jetons de modèle. Votre agent de codage s'exécute dans votre environnement et appelle lvl avec les autorisations de votre session Level active.
Avant de commencer
Vous avez besoin de :
Level CLI installé et connecté.
Un agent de codage capable de charger les Compétences d'Agent au format
SKILL.mdformat.L'autorisation d'installer une compétence au niveau utilisateur ou au niveau projet pour cet agent.
Exécutez lvl --help, puis exécutez lvl auth status pour confirmer que le CLI est disponible et connecté à l'organisation Level prévue.
Examinez la compétence générée
Utilisez ces commandes pour inspecter ce que l'agent de codage recevra :
lvl skill showaffiche la compétence générée sans l'installer.lvl skill describe device listaffiche une commande, ses indicateurs et la forme de sa sortie JSON.lvl skill describe automationaffiche toutes les commandes du groupe d'automatisation.lvl skill describeaffiche la référence de commande générée complète.
La compétence est générée à partir de l'arborescence de commandes de votre CLI installé, donc ses commandes et définitions de sortie correspondent à cette version de lvl.
Installez la compétence pour votre compte utilisateur
Exécutez lvl skill install.
La compétence canonique est écrite dans ~/.agents/skills/level/SKILL.md. Cet emplacement est utilisé par Codex, Cursor, Gemini CLI et d'autres agents qui lisent le répertoire ~/.agents/skills répertoire.
Si Claude Code est déjà configuré sur l'ordinateur, lvl installe ou lie également la compétence à ~/.claude/skills/level. Lorsque les liens symboliques ne sont pas disponibles, le programme d'installation copie la compétence à la place.
Installez la compétence dans un projet
Utilisez une installation au niveau du projet lorsque vous souhaitez que la compétence accompagne un dépôt ou un répertoire de travail.
Accédez au répertoire du projet avec
cd YOUR_PROJECT_DIRECTORY.Exécutez
lvl skill install --project.
La commande écrit la compétence canonique dans ./.agents/skills/level/SKILL.md. Elle installe ou lie également l'emplacement Claude Code à ./.claude/skills/level.
Consultez la documentation de votre agent de codage pour confirmer quel répertoire de Compétences d'Agent il lit.
⚠️ AVERTISSEMENT : Une compétence au niveau du projet peut être intégrée au contrôle de source. Examinez le fichier généré et la politique de votre dépôt avant de le valider. La compétence générée ne contient pas vos identifiants Level, mais elle décrit des commandes qui peuvent accéder à votre compte Level lorsqu'elles sont exécutées dans un environnement authentifié.
Demandez à votre agent de codage d'utiliser lvl
Démarrez une nouvelle session d'agent de codage dans le même contexte utilisateur ou projet après avoir installé la compétence. Donnez à l'agent une cible claire, un résultat attendu et une limite d'autorisation.
Les invites suivantes utilisent des blocs de citation pour s'adapter aux petits écrans. Remplacez les noms d'exemple par des ressources de votre compte Level.
Investiguer sans apporter de modifications
Utilisez lvl pour lister tous les appareils dans le groupe Serveurs. Retournez les identifiants des appareils, les noms, les systèmes d'exploitation, l'état en ligne, les alertes actives et les mises à jour disponibles. N'apportez aucune modification.
Cela montre comment un agent peut combiner des données d'appareils, d'alertes et de mises à jour en un seul résumé de flotte.
Rédiger un script de diagnostic
Utilisez lvl pour inspecter web-01 et déterminer son système d'exploitation. Rédigez un script d'utilisation du disque en lecture seule pour ce système d'exploitation. Montrez-moi le script complet, l'identifiant de l'appareil cible, le shell, le paramètre d'exécution, le délai d'expiration et la commande lvl exacte. Ne créez pas et n'exécutez pas le script.
Après avoir examiné le script, vous pouvez demander à l'agent de l'enregistrer avec lvl script create ou l'exécuter avec lvl script run.
Créer une nouvelle automatisation
Utilisez lvl skill describe automation pour examiner les commandes d'automatisation actuelles et le format de spécification. Rédigez une nouvelle automatisation nommée Disk Space Triage qui cible le groupe Serveurs, exécute un diagnostic de disque en lecture seule et enregistre la sortie. Écrivez la spécification YAML proposée sur le disque et expliquez chaque déclencheur, action, variable et cible. Ne créez pas l'automatisation.
Après avoir examiné la spécification, demandez à l'agent de la créer avec lvl automation create -f AUTOMATION_SPEC.
⚠️ AVERTISSEMENT : La création d'une automatisation à partir d'une spécification applique une chaîne de mutations. Elle n'est pas transactionnelle. Si une étape échoue, l'automatisation peut rester partiellement créée. Examinez la spécification complète avant la création et notez l'identifiant d'automatisation retourné par toute erreur.
Modifier une automatisation existante en toute sécurité
Exportez l'automatisation Patch Servers avec lvl automation spec. Proposez la plus petite modification YAML nécessaire pour ajouter une étape d'attente d'approbation avant l'installation des correctifs. Montrez-moi le diff, puis exécutez lvl automation apply avec --dry-run. N'appliquez pas la modification.
Ce flux de travail permet à l'agent d'inspecter la spécification complète de l'état actuel, de la modifier et d'avoir un aperçu de la façon dont elle se réconcilierait avec l'automatisation en direct.
⚠️ AVERTISSEMENT : L'application d'une spécification d'automatisation peut supprimer des déclencheurs ou des actions existants qui sont absents du fichier. L'application n'est pas transactionnelle. Examinez toujours le fichier complet et le résultat de l'essai à blanc avant de l'appliquer.
Créer une politique de surveillance
Utilisez lvl skill describe monitor policy et lvl skill describe monitor add pour inspecter les formats actuels de politique de surveillance et de charge utile de surveillance. Rédigez une politique Santé du Serveur pour le tag Serveurs avec des surveillances CPU, mémoire et espace disque libre. Incluez les seuils proposés, les durées, les niveaux de gravité, les destinataires des alertes et les tags cibles. Écrivez la spécification YAML sur le disque et expliquez chaque paramètre. Ne créez pas la politique.
Après examen, demandez à l'agent de créer la politique avec lvl monitor policy create -f POLICY_SPEC.
La création d'une politique de surveillance à partir d'une spécification est également une chaîne non transactionnelle. Un échec peut laisser une politique partiellement créée, alors examinez l'identifiant de politique retourné et corrigez-le avec lvl monitor policy apply -f POLICY_SPEC si nécessaire.
Modifier une politique de surveillance existante
Exportez la politique de surveillance Santé du Serveur. Ajoutez une surveillance de script en lecture seule qui vérifie le point de terminaison de santé de l'application. Montrez-moi le script proposé et le diff de la politique, puis exécutez lvl monitor policy apply avec --dry-run. N'appliquez pas la modification.
L'application d'une politique de surveillance réconcilie la politique en direct avec le fichier. Les surveillances absentes de la spécification peuvent être supprimées, donc l'agent doit examiner la politique exportée complète plutôt que de construire une mise à jour partielle.
Connecter la surveillance et la remédiation
Inspectez la politique de surveillance Santé du Serveur et l'automatisation Restart Web Service. Déterminez si le type de surveillance actuel prend en charge le flux de travail de remédiation prévu. Rédigez les plus petites modifications de politique et d'automatisation nécessaires pour alerter en premier et n'exécuter la remédiation existante qu'après approbation. Montrez les deux diffs et les plans d'essai à blanc. N'appliquez aucune modification.
Cette invite demande à l'agent d'inspecter les schémas de surveillance et d'automatisation actuels du CLI installé avant de proposer un flux de travail connecté.
Organiser des ressources réutilisables
Utilisez lvl pour inventorier les scripts, les automatisations, les politiques de surveillance, les tags, les groupes d'appareils et les fichiers de dépôt liés aux correctifs. Identifiez les noms en double et les références ambiguës. Proposez un plan de regroupement et de nommage cohérent. Ne renommez, ne déplacez et ne supprimez rien.
Un inventaire en lecture seule est une première étape utile avant de demander à un agent de réorganiser des ressources partagées.
Examinez les commandes avant l'exécution
Vérifiez ces détails avant d'autoriser l'exécution d'une commande proposée :
Confirmez le profil Level actif et l'organisation avec
lvl auth status.Confirmez chaque référence à un appareil, groupe, script, automatisation, politique de surveillance, tag ou fichier.
Préférez les identifiants lorsque les noms sont ambigus.
Examinez le script complet ou la spécification d'état complet.
Exigez
--dry-runpour les commandes d'application d'automatisation et de politique de surveillance.Confirmez si une commande attend la fin de l'opération ou ne demande qu'un travail asynchrone.
Demandez à l'agent de s'arrêter avant la création, l'application, la suppression, le redémarrage, l'arrêt, l'installation de mises à jour ou toute autre action privilégiée, sauf si vous avez l'intention de l'approuver.
⚠️ AVERTISSEMENT : La création de scripts et les exécutions de scripts ad hoc utilisent par défaut le paramètre SYSTEM paramètre d'exécution sauf si vous choisissez une autre valeur. Les scripts et les actions d'automatisation peuvent apporter des modifications privilégiées aux appareils gérés. Spécifiez --run-as current_user lorsque c'est la portée prévue, et examinez chaque script avant de l'exécuter.
Les commandes de suppression définitive nécessitent une confirmation. Dans une session non interactive, les commandes qui nécessitent une confirmation échouent sauf si --yes est fourni. Certaines actions, notamment le redémarrage et l'arrêt d'appareils, demandent l'action immédiatement et ne disposent pas d'une invite de confirmation.
Actualisez la compétence après la mise à niveau de lvl
La compétence et la référence de commande sont générées à partir de votre version CLI installée. Après la mise à niveau de lvl, exécutez lvl skill install à nouveau.
Pour une installation au niveau du projet, exécutez lvl skill install --project.
Cela maintient l'index de commandes, les indicateurs et les définitions de sortie JSON de votre agent de codage alignés avec le binaire installé.
Dépannage
L'agent de codage ne trouve pas la compétence
Exécutez
lvl skill installà nouveau et notez la destination indiquée.Confirmez que votre agent de codage lit ce répertoire de Compétences d'Agent.
Redémarrez la session de l'agent de codage après avoir installé ou mis à jour la compétence.
Utilisez
lvl skill showpour confirmer que le CLI peut générer la compétence.
Une commande dans la compétence ne correspond pas à lvl
Réinstallez la compétence avec le même lvl binaire que l'agent de codage appellera. Si plusieurs lvl sont dans votre PATH, exécutez lvl --help, puis utilisez lvl skill describe COMMAND pour inspecter la commande actuelle.
Le CLI installé et lvl skill describe sont la source de vérité pour les commandes et les indicateurs disponibles.
