Un sous-agent est un contexte séparé avec ses propres instructions, ses propres outils et souvent son propre modèle — utile justement parce que ce qu'il lit ne se retrouve pas dans la conversation principale. Deux champs décident si cette séparation en vaut la peine. La description provoque la délégation et entre en concurrence avec tous les autres agents définis : une description vague ne se déclenche jamais, ou se déclenche sans cesse. La liste d'outils est le moyen le moins coûteux de garder étroit un agent étroit : celui qui ne peut que lire et chercher ne partira pas modifier des fichiers. Ce créateur écrit le fichier et vérifie les deux, y compris la combinaison qui piège tout le monde — écrire sans pouvoir lire.
Fonctionnalités
Description vérifiée pour la clause qui provoque la délégation
Outils choisis dans la vraie liste plutôt que saisis de mémoire
Accepte les outils MCP à espace de noms à côté des outils intégrés
Avertit quand un agent peut écrire des fichiers mais pas les lire
Le choix du modèle expliqué en termes de quand chacun se justifie
Portée projet ou personnelle, avec le chemin correspondant
Un modèle hérité est omis plutôt qu’écrit
Se télécharge en fichier .md prêt à l’emploi
Comment utiliser Générateur de sous-agents
Nommez l’agent et dites quand lui confier du travail
Choisissez les outils dont il a besoin — et seulement ceux-là
Choisissez un modèle, ou laissez-le hériter de la session
Écrivez le prompt système et téléchargez le fichier
Exemple
Entrée
tools: [Read, Grep, Glob]
Sortie
description: Checks a database migration for problems that only show up in production. Use proactively whenever a migration file is added.
« À utiliser de façon proactive quand… » fait démarrer un agent sans qu’on le lui demande.
Erreurs courantes et dépannage
Rien n’est jamais délégué à l’agent. — La description doit dire quand, pas seulement quoi. Ajouter « À utiliser quand… » ou « À utiliser de façon proactive après… » suffit généralement.
Deux agents sont sans cesse confondus. — Leurs descriptions se recouvrent. Faites que chacune nomme une situation distincte, non un sujet distinct.
Un nom d’outil est signalé comme inconnu. — Les noms distinguent la casse et prennent une majuscule : Read, pas read. Les outils MCP utilisent la forme mcp__serveur__outil et sont acceptés tels quels.
L’agent modifie des choses inattendues. — Donnez-lui une liste d’outils plus étroite. Un agent sans Write ni Edit ne change rien, quoi que dise son prompt.
Foire aux questions
Quand un sous-agent vaut-il mieux que le travail en direct ?
Quand le travail consiste à lire beaucoup pour produire peu : fouiller une base de code, vérifier de nombreux fichiers, faire une recherche. Tout ce qu’il lit reste dans son propre contexte. C’est aussi le moyen de tourner avec un jeu d’outils plus étroit que la session principale.
Quel modèle pour un sous-agent ?
Hériter est un bon réglage par défaut. Un modèle plus rapide et moins cher se justifie pour des passes mécaniques où l’on vérifie plus qu’on ne décide ; un modèle plus capable quand il faut du jugement. Le compromis figure à côté de chaque choix.
Faut-il toujours restreindre les outils ?
Restreindre est peu coûteux et réversible, et c’est le moyen le plus fiable de garder un agent concentré — bien plus que le lui demander dans le prompt. Une liste vide hérite de tout, ce qui convient aux agents généralistes.
Portée projet ou personnelle ?
La portée projet versionne l’agent avec le dépôt, de sorte que toute l’équipe a le même. La portée personnelle vous suit d’un projet à l’autre. Le chemin se met à jour selon le choix.
En quoi est-ce différent d’une skill ?
Une skill ajoute des instructions au contexte courant. Un sous-agent s’exécute ailleurs, avec son contexte et ses outils, et rend compte. Utilisez une skill pour changer la façon dont une chose est faite ; un sous-agent pour sortir cette chose de votre conversation.
Outils associés
Générateur de skills — Écrivez un SKILL.md dont le frontmatter est vérifié à la frappe.
Générateur de commandes — Créez une commande personnalisée, avec arguments et liste d'outils.