/batch

Orchestre de grandes modifications en parallèle sur toute la base de code : effectue des recherches, découpe le travail en unités et les fait réaliser par des sous-agents.

[Skill] Découpe le travail en 5 à 30 unités indépendantes et présente un plan ; après validation, un sous-agent en arrière-plan démarre pour chaque unité dans un git worktree isolé, qui implémente, teste et ouvre une pull request. Nécessite un dépôt Git.

✅ QUAND L’UTILISER ?

Grande modification qui peut se découper en de nombreuses unités indépendantes sur toute la base de code

/batch rename the legacy HTTP client to the new SDK across all 15 services

Migration où chaque unité doit obtenir sa propre PR et être testée en parallèle

/batch migrate every module from CommonJS to ESM

⛔ QUAND ÉVITER ?

Petite tâche isolée touchant un ou deux fichiers

la phase de planification, les worktrees isolés et les PR distinctes par unité représentent une surcharge pure pour une petite tâche

Mieux: un prompt normal ou un sous-agent unique plutôt que /batch

Aucun dépôt Git présent

/batch nécessite un dépôt Git pour les worktrees isolés par unité

Mieux: faire d'abord 'git init', ou effectuer la modification manuellement sans /batch

SOURCES

Claude Code Doku (offiziell) ↗ code.claude.com