4.5 KiB
4.5 KiB
Bonnes pratiques — Sous-agents
Sous-agents Claude Code — champs de frontmatter et types d'agents intégrés officiels.
| ← Retour à Claude Code Best Practice |  |
Champs de frontmatter (16)
| Champ | Type | Requis | Description |
|---|---|---|---|
name |
string | Oui | Identifiant unique en lettres minuscules et tirets |
description |
string | Oui | Quand l'invoquer. Utilise "PROACTIVELY" pour une auto-invocation par Claude |
tools |
string/list | Non | Liste d'autorisation d'outils séparés par des virgules (par ex. Read, Write, Edit, Bash). Hérite de tous les outils si omis. Supporte la syntaxe Agent(agent_type) pour restreindre les sous-agents instanciables ; l'ancien alias Task(agent_type) fonctionne toujours |
disallowedTools |
string/list | Non | Outils à refuser, retirés de la liste héritée ou spécifiée |
model |
string | Non | Modèle à utiliser : sonnet, opus, haiku, un ID de modèle complet (par ex. claude-opus-4-6), ou inherit (défaut : inherit) |
permissionMode |
string | Non | Mode de permissions : default, acceptEdits, auto, dontAsk, bypassPermissions, ou plan |
maxTurns |
integer | Non | Nombre maximum de tours agentiques avant que le sous-agent ne s'arrête |
skills |
list | Non | Noms de skills à précharger dans le contexte de l'agent au démarrage (contenu complet injecté, pas seulement rendu disponible) |
mcpServers |
list | Non | Serveurs MCP pour ce sous-agent — chaînes de noms de serveurs ou objets {name: config} inline |
hooks |
object | Non | Hooks de cycle de vie limités à ce sous-agent. Tous les événements de hook sont supportés ; PreToolUse, PostToolUse et Stop sont les plus courants |
memory |
string | Non | Portée de la mémoire persistante : user, project, ou local |
background |
boolean | Non | Mets true pour toujours s'exécuter comme tâche en arrière-plan (défaut : false) |
effort |
string | Non | Surcharge du niveau d'effort quand ce sous-agent est actif : low, medium, high, xhigh, max (Opus 4.6 uniquement). Défaut : hérité de la session |
isolation |
string | Non | Mets "worktree" pour s'exécuter dans un worktree git temporaire (auto-nettoyé si aucun changement) |
initialPrompt |
string | Non | Auto-soumis comme premier tour utilisateur quand cet agent s'exécute comme agent de la session principale (via --agent ou le réglage agent). Les commandes et skills sont traités. Préfixé à tout prompt fourni par l'utilisateur |
color |
string | Non | Couleur d'affichage du sous-agent dans la liste des tâches et le transcript : red, blue, green, yellow, purple, orange, pink, ou cyan |
(5)
| # | Agent | Modèle | Outils | Description |
|---|---|---|---|---|
| 1 | general-purpose |
inherit | Tous | Tâches complexes en plusieurs étapes — le type d'agent par défaut pour la recherche, la recherche de code et le travail autonome |
| 2 | Explore |
haiku | Lecture seule (pas de Write, Edit) | Recherche et exploration rapides du codebase — optimisé pour trouver des fichiers, chercher du code et répondre à des questions sur le codebase |
| 3 | Plan |
inherit | Lecture seule (pas de Write, Edit) | Recherche de pré-planification en mode plan — explore le codebase et conçoit des approches d'implémentation avant d'écrire du code |
| 4 | statusline-setup |
sonnet | Read, Edit | Configure le réglage de la barre d'état Claude Code de l'utilisateur |
| 5 | claude-code-guide |
haiku | Glob, Grep, Read, WebFetch, WebSearch | Répond aux questions sur les fonctionnalités de Claude Code, l'Agent SDK et l'API Claude |