Compétences de l’agent (Expérimental)

Créez, gérez et partagez des compétences pour étendre les capacités de Qwen Code.

Ce guide vous montre comment créer, utiliser et gérer les compétences d’agent dans Qwen Code. Les compétences sont des capacités modulaires qui étendent l’efficacité du modèle grâce à des dossiers organisés contenant des instructions (et éventuellement des scripts/ressources).

Note

Les compétences sont actuellement expérimentales et doivent être activées avec --experimental-skills.

Prérequis

Qwen Code (version récente)
Exécuter avec l’indicateur expérimental activé :


qwen --experimental-skills

Connaissance de base de Qwen Code (Démarrage rapide)

Qu’est-ce que les compétences d’agent ?

Les compétences d’agent empaquettent l’expertise en capacités découvrables. Chaque compétence se compose d’un fichier SKILL.md contenant des instructions que le modèle peut charger lorsque c’est pertinent, ainsi que des fichiers de support optionnels comme des scripts et des modèles.

Comment les compétences sont invoquées

Les compétences sont invoquées par le modèle — le modèle décide de manière autonome quand les utiliser en fonction de votre requête et de la description de la compétence. Cela diffère des commandes slash, qui sont invoquées par l’utilisateur (vous tapez explicitement /commande).

Avantages

Étendre Qwen Code pour vos flux de travail
Partager l’expertise au sein de votre équipe via git
Réduire les demandes répétitives
Composer plusieurs compétences pour des tâches complexes

Créer une compétence

Les compétences sont stockées sous forme de répertoires contenant un fichier SKILL.md.

Compétences personnelles

Les compétences personnelles sont disponibles dans tous vos projets. Stockez-les dans ~/.qwen/skills/ :


mkdir -p ~/.qwen/skills/nom-de-ma-competence

Utilisez les compétences personnelles pour :

Vos flux de travail et préférences individuels
Les compétences expérimentales que vous développez
Les assistants de productivité personnelle

Compétences du projet

Les compétences du projet sont partagées avec votre équipe. Stockez-les dans .qwen/skills/ à l’intérieur de votre projet :


mkdir -p .qwen/skills/nom-de-ma-competence

Utilisez les compétences du projet pour :

Les flux de travail et conventions d’équipe
L’expertise spécifique au projet
Les utilitaires et scripts partagés

Les compétences du projet peuvent être ajoutées à git et deviennent automatiquement disponibles pour les membres de l’équipe.

Écrire `SKILL.md`

Créez un fichier SKILL.md avec des métadonnées YAML et du contenu Markdown :


---
name: nom-de-votre-competence
description: Brève description de ce que fait cette compétence et quand l'utiliser
---
 
# Nom de votre compétence
 
## Instructions
Fournissez des instructions claires et étape par étape pour Qwen Code.
 
## Exemples
Montrez des exemples concrets d'utilisation de cette compétence.

Exigences relatives aux champs

Qwen Code valide actuellement que :

name est une chaîne non vide
description est une chaîne non vide

Conventions recommandées (pas encore strictement appliquées) :

Utilisez des lettres minuscules, des chiffres et des traits d’union dans name
Rendez description spécifique : incluez à la fois ce que fait la Skill et quand l’utiliser (mots-clés que les utilisateurs mentionneront naturellement)

Ajouter des fichiers de support

Créez des fichiers supplémentaires à côté de SKILL.md :


my-skill/
├── SKILL.md (requis)
├── reference.md (documentation facultative)
├── examples.md (exemples facultatifs)
├── scripts/
│   └── helper.py (utilitaire facultatif)
└── templates/
    └── template.txt (modèle facultatif)

Référez-vous à ces fichiers depuis SKILL.md :


Pour une utilisation avancée, consultez [reference.md](reference.md).
 
Exécutez le script d'assistance :
 
```bash
python scripts/helper.py input.txt
```

Voir les compétences disponibles

Lorsque --experimental-skills est activé, Qwen Code découvre les compétences à partir de :

Compétences personnelles : ~/.qwen/skills/
Compétences de projet : .qwen/skills/

Pour voir les compétences disponibles, demandez directement à Qwen Code :


Quelles compétences sont disponibles ?

Ou inspectez le système de fichiers :


 
# Lister les compétences personnelles
ls ~/.qwen/skills/
 
# Lister les compétences de projet (si dans un répertoire de projet)
ls .qwen/skills/
 
# Voir le contenu d'une compétence spécifique
cat ~/.qwen/skills/ma-competence/SKILL.md

Tester une compétence

Après avoir créé une compétence, testez-la en posant des questions qui correspondent à votre description.

Exemple : si votre description mentionne “fichiers PDF” :


Pouvez-vous m'aider à extraire le texte de ce PDF ?

Le modèle décide de manière autonome d’utiliser votre compétence si elle correspond à la requête — vous n’avez pas besoin de l’invoquer explicitement.

Déboguer une compétence

Si Qwen Code n’utilise pas votre compétence, vérifiez ces problèmes courants :

Rendez la description spécifique

Trop vague :


description: Aide avec les documents

Spécifique :


description: Extrait le texte et les tableaux à partir des fichiers PDF, remplit les formulaires, fusionne les documents. À utiliser lors du travail avec des PDF, des formulaires ou de l'extraction de documents.

Vérifiez le chemin du fichier

Compétences personnelles : ~/.qwen/skills/<nom-de-la-compétence>/SKILL.md
Compétences de projet : .qwen/skills/<nom-de-la-compétence>/SKILL.md


 
# Personnel
ls ~/.qwen/skills/ma-competence/SKILL.md
 
# Projet
ls .qwen/skills/ma-competence/SKILL.md

Vérifiez la syntaxe YAML

Un YAML invalide empêche le chargement correct des métadonnées de la compétence.


cat SKILL.md | head -n 15

Assurez-vous que :

--- est présent en début de ligne 1
--- de fermeture se trouve avant le contenu Markdown
La syntaxe YAML est valide (pas de tabulations, indentation correcte)

Afficher les erreurs

Exécutez Qwen Code en mode débogage pour voir les erreurs de chargement des compétences :


qwen --experimental-skills --debug

Partager des compétences avec votre équipe

Vous pouvez partager des compétences via les dépôts de projet :

Ajoutez la compétence sous .qwen/skills/
Validez et poussez
Les membres de l’équipe récupèrent les modifications et exécutent avec --experimental-skills


git add .qwen/skills/
git commit -m "Ajout d'une compétence d'équipe pour le traitement PDF"
git push

Mettre à jour une compétence

Modifiez directement SKILL.md :


 
# Compétence personnelle
code ~/.qwen/skills/ma-competence/SKILL.md
 
# Compétence de projet
code .qwen/skills/ma-competence/SKILL.md

Les modifications prennent effet au prochain démarrage de Qwen Code. Si Qwen Code est déjà en cours d’exécution, redémarrez-le pour charger les mises à jour.

Supprimer une compétence

Supprimez le répertoire de la compétence :


 
# Personnel
rm -rf ~/.qwen/skills/ma-competence
 
# Projet
rm -rf .qwen/skills/ma-competence
git commit -m "Suppression d'une compétence inutilisée"

Meilleures pratiques

Gardez les compétences ciblées

Une compétence devrait traiter une seule capacité :

Ciblé : “remplissage de formulaires PDF”, “analyse Excel”, “messages de commit Git”
Trop large : “traitement de documents” (divisez en compétences plus petites)

Rédigez des descriptions claires

Aidez le modèle à découvrir quand utiliser les compétences en incluant des déclencheurs spécifiques :


description: Analyser les feuilles de calcul Excel, créer des tableaux croisés dynamiques et générer des graphiques. À utiliser lors de travaux avec des fichiers Excel, des feuilles de calcul ou des données .xlsx.

Testez avec votre équipe

La compétence s’active-t-elle comme prévu ?
Les instructions sont-elles claires ?
Manque-t-il des exemples ou des cas particuliers ?