Déléguer des tâches Pi à des sessions enfant spécialisées

pi-subagents : Comment pi-subagents délègue le travail aux sessions enfant Pi

pi-subagents est une extension TypeScript pour l'assistant Pi. Elle permet à la session Pi parente de lancer des sessions enfant ciblées, appelées sous-agents, chacune avec sa propre tâche. Le README liste la revue de code, l'exploration, l'implémentation, les audits parallèles, les workflows enregistrés et les tâches d'arrière-plan comme utilisations prévues. L'installation de l'extension ne démarre pas un réviseur automatique ; elle donne à Pi un outil de délégation. La session enfant exécute sa propre tâche et renvoie les résultats, soit en streaming dans la conversation pour les exécutions au premier plan, soit en continuant en arrière-plan.

Pour vérifier pi-subagents, créez d’abord un espace de test contenant uniquement les entrées documentées. Relevez la version, la commande pi install npm:pi-subagents et chaque clé subagent, workflowScript, maxSubagentSpawnsPerRun, puis conservez la sortie complète. Un lancement réussi ne suffit pas : comparez le fichier produit, le journal et l’état attendu dans le README. Si une étape dépend d’un service, d’un GPU, d’un dépôt Nix ou d’un compte de jeu, notez séparément cette dépendance et son effet sur le résultat. Le matériau disponible ne fournit pas de matrice exhaustive de performance ou de compatibilité ; ces points restent à établir dans votre environnement.

Dans ce projet, l’observation utile porte sur subagent, workflowScript, maxSubagentSpawnsPerRun. Ne transformez pas une absence de précision dans le README en promesse implicite : consignez plutôt le comportement constaté, le système utilisé et le chemin exact du résultat. Cette méthode permet de distinguer la fonction annoncée de ce que votre installation démontre réellement.

pi-subagents : Installation et premières demandes de délégation

L'installation est une seule commande : `pi install npm:pi-subagents`. Ensuite, vous pouvez demander à Pi une délégation en langage naturel sans créer d'agents, écrire de configuration ou apprendre des commandes slash. Les exemples du README incluent « Use reviewer to review this diff. » et « Run parallel reviewers: one for correctness, one for tests, and one for unnecessary complexity. ». Pi décide d'appeler l'outil `subagent`, quel agent utiliser et comment exprimer le travail composé avec `workflowScript`. L'extension inclut des agents intégrés utilisables immédiatement.

pi-subagents : La liste des agents intégrés

Le paquet regroupe huit agents. `scout` effectue une reconnaissance rapide de la base de code locale. `researcher` collecte des sources web et documentaires. `planner` produit un plan d'implémentation sans modifier le code. `worker` édite des fichiers et valide les modifications. `reviewer` vérifie l'implémentation par rapport à la tâche et aux tests. `context-builder` écrit du matériel de transmission comme `context.md` et `meta-prompt.md`. `oracle` remet en question les hypothèses et recommande la prochaine action sans modifier. `delegate` est un sous-agent général léger qui se comporte comme la session parente. Les agents intégrés héritent de votre modèle par défaut Pi actuel, sauf si vous définissez une valeur différente.

pi-subagents : Routage des modèles, remplacements et correspondance floue

Vous pouvez définir `subagents.defaultModel` pour donner à tous les sous-agents sans modèle explicite leur propre défaut. Les remplacements par agent se trouvent dans `agentOverrides`, qui peuvent changer le modèle, la réflexion, les outils, les compétences, le texte du prompt ou désactiver un agent intégré. `subagents.defaultThinking` et `subagents.defaultExtensions` fournissent des valeurs par défaut partagées pour les agents qui ne définissent pas ces champs. Les ID de modèle sont mis en correspondance floue avec le registre, donc les variations de séparateur de fournisseur, les différences de casse et les horodatages finaux résolvent au même modèle ; les correspondances exactes `provider/id` restent prioritaires. Les paramètres de projet sont résolus à partir du répertoire parent le plus proche contenant `.pi` ou `.agents`, sauf si `projectRootResolution` est défini sur `git-root`.

pi-subagents : Le watchdog optionnel et les portes de permission

Le watchdog de sous-agent est un réviseur de changements adversarial optionnel, distinct de l'agent `reviewer`. Il examine les modifications du dépôt à la frontière `agent_end` uniquement si l'état final du dépôt a changé, fusionne plusieurs modifications en une seule revue et ignore les artefacts générés. Il peut exécuter des diagnostics frais de serveur de langage sur les fichiers TypeScript et JavaScript modifiés, et prend en charge la surveillance de portée style Scopey avec `subagents.watchdog.cadence.everyNTools`. Les permissions natives enfant sont également optionnelles : les règles `allow`, `ask` et `deny` dans `permissions.rules` contrôlent les appels d'outils non-bash, `ask` suspendant l'appel pour un arbitre de modèle watchdog. Bash passe toujours, et les profils CLI externes sont opaques aux permissions natives.

pi-subagents : Exécutions asynchrones, vues de flotte et artefacts de cycle de vie

Les exécutions au premier plan diffusent la progression dans la conversation et ont un délai d'attente par défaut de 30 minutes lorsqu'aucun appel ni agent n'en fournit un. Les exécutions en arrière-plan continuent de fonctionner après le retour du contrôle. La TUI affiche une vue de flotte persistante sous l'éditeur, et `/subagents-fleet` ouvre un inspecteur en direct. Les exécutions asynchrones écrivent des artefacts de cycle de vie lisibles par machine : `status.json`, `events.jsonl`, `output-<index>.log` et un résumé final dans le répertoire des résultats. L'artefact de cycle de vie v3 ajoute une preuve de terminaison de processus, qui n'est `observed` qu'après que le parent en direct voit l'événement `close` du runner détaché. D'autres extensions Pi peuvent utiliser le RPC de bus d'événements intra-processus avec les méthodes `ping`, `status`, `spawn`, `steer`, `interrupt`, `stop` et `resume`.

pi-subagents : Orchestration, coordination superviseur et workflowScript

La boucle d'orchestration recommandée est `clarify`, `planner`, `worker`, `fresh reviewers`, `worker`. Les limites de sécurité enfant sont appliquées à l'exécution : les enfants générés ne reçoivent pas la compétence groupée, le filtrage de contexte forké supprime les artefacts de sous-agent réservés au parent, et par défaut les enfants n'enregistrent pas l'outil `subagent` sauf si leurs outils résolus l'incluent. La coordination superviseur native permet à un enfant d'utiliser `contact_supervisor` pour demander une décision au parent, et le parent répond avec `subagent_supervisor({ action: "reply" })`. L'orchestration multi-agents est exprimée via `workflowScript` dans l'outil `subagent` ; les anciennes commandes `/chain`, `/parallel` et `/run-chain` ne sont pas enregistrées. Le README se termine par du matériel de référence sur la syntaxe exacte des commandes, le frontmatter des agents personnalisés, les workflows scriptés et les clés de configuration.

Conclusion éditoriale

pi-subagents convient aux lecteurs dont le besoin correspond aux entrées documentées et qui peuvent contrôler subagent, workflowScript, maxSubagentSpawnsPerRun. Il ne convient pas à ceux qui exigent une garantie absente du README. Commencez par pi install npm:pi-subagents, observez le résultat propre à ce projet, puis décidez sur cette preuve.

Sources officielles

1. Official README
2. Project repository
3. Release notes