Nicolas Cantu
785868b53b
**Motivations:** - Centraliser les fichiers Cursor (rules, skills, agents, commands, hooks) par user et par projet **Root causes:** - N/A **Correctifs:** - N/A **Evolutions:** - desk: rules, skills-cursor, agents, commands, hooks, argv/hooks/mcp.json - ncantu: README placeholder - 4NK_node, algo, builazoo, ia_local, lecoffre_ng, lecoffre_ng_pprod, lecoffre_ng_test: .cursor contents **Pages affectées:** - cursor/desk/, cursor/ncantu/, cursor/<project>/
35 lines
1.8 KiB
Markdown
35 lines
1.8 KiB
Markdown
# Subagents Cursor (niveau utilisateur)
|
|
|
|
Les subagents dans `~/.cursor/agents/` sont disponibles pour tous les projets de l'utilisateur.
|
|
|
|
## Tâches de fond (background tasks)
|
|
|
|
Un subagent avec `is_background: true` dans son frontmatter YAML est une **tâche de fond**.
|
|
|
|
### Fonctionnement
|
|
|
|
- **Foreground** : Bloque jusqu'à la fin. Retourne le résultat immédiatement. Pour les tâches séquentielles où le résultat est nécessaire.
|
|
- **Background** : Retourne immédiatement. Le subagent travaille en parallèle. Pour les tâches longues ou le travail en parallèle.
|
|
|
|
### Comportement des tâches de fond
|
|
|
|
1. **Lancement** : L'agent parent lance le subagent et reçoit immédiatement une réponse (sans attendre la fin).
|
|
2. **Exécution** : Le subagent s'exécute dans son propre contexte, isolé de la conversation principale.
|
|
3. **Sortie** : Les subagents en arrière-plan écrivent leur état dans `~/.cursor/subagents/`.
|
|
4. **Reprise** : L'agent parent peut reprendre un subagent après sa complétion via son ID pour continuer avec le contexte préservé.
|
|
|
|
### Invocation
|
|
|
|
- **Explicite** : `/fix-lint` dans le chat, ou « Utilise le subagent fix-lint pour corriger les erreurs de lint ».
|
|
- **Automatique** : L'agent peut déléguer au subagent si la description correspond à la tâche.
|
|
|
|
### Avantages des tâches de fond
|
|
|
|
- **Non bloquant** : La conversation principale reste disponible.
|
|
- **Parallélisme** : Plusieurs subagents peuvent tourner en même temps.
|
|
- **Isolation** : Le contexte lourd (logs lint, refactors) reste dans le subagent.
|
|
|
|
### Hooks associés
|
|
|
|
Les hooks dans `~/.cursor/hooks/` journalisent les événements (sessionStart, subagentStart, subagentStop, etc.) dans `~/.cursor/logs/hooks.log`. Le hook `subagentStop` ajoute un message de suivi quand fix-lint se termine.
|