polyphony

Présentation de la skill polyphony

polyphony est une skill d’orchestration multi-agent conçue pour exécuter des travaux d’agents en parallèle dans des espaces de travail isolés par conteneur. Chaque session dispose de son propre conteneur Docker et de sa propre branche git, ce qui la rend utile lorsque vous voulez exécuter plusieurs tâches en même temps sans collisions de branches, sans bugs liés à un état partagé et sans nettoyage laborieux.

À quoi sert polyphony

Utilisez la skill polyphony lorsqu’une tâche est trop importante pour un seul prompt, tout en gagnant à être répartie de façon structurée : travail fonctionnel en parallèle, validation isolée, triage d’incidents ou lancement de plusieurs pistes d’agent sur la même base de code. Elle est pensée pour les utilisateurs qui veulent une exécution propre, un routage de tâches reproductible et une coordination multi-agent plus sûre.

Ce qui la distingue

Le principal atout de polyphony, c’est une conception du workflow centrée sur l’isolation. Au lieu de demander à un agent de « tout faire », la skill sépare la découverte des tâches, leur routage, le provisioning, l’exécution et la vérification, afin que chaque worker opère dans un espace de travail contrôlé. Cela rend l’approche polyphony for Multi-Agent Systems plus pratique lorsque vous avez besoin de tests indépendants et d’un comportement de fusion plus propre.

Cas d’usage idéaux et compromis

polyphony est particulièrement adaptée si votre environnement prend déjà en charge Docker ou OrbStack et si vous voulez une orchestration activée par défaut plutôt qu’un pattern de prompt ponctuel. Elle est moins utile si vous n’avez besoin que d’une seule réponse de chat, si vous ne pouvez pas lancer de conteneurs, ou si vous cherchez une configuration minimale sans workflow sensible au dépôt.

Comment utiliser la skill polyphony

Installer et charger polyphony

Installez la skill polyphony dans votre répertoire de skills, puis utilisez-la depuis le workflow hôte qui prend en charge le chargement des skills. Le dépôt indique qu’elle est censée se charger automatiquement lorsque l’isolation par conteneur est disponible, et qu’elle est la valeur par défaut pour /spawn-team. Si votre configuration diffère, vérifiez que l’accès à Docker, la création de branches et les montages d’espaces de travail sont disponibles avant de vous appuyer sur la skill.

Partir des bons fichiers

Pour utiliser polyphony, commencez par skills/polyphony/SKILL.md, puis lisez le contexte lié ou mentionné dans le même ordre que celui utilisé en interne par la skill : cycle de vie des tâches, architecture, prérequis, configuration et éventuelles références spécifiques au dépôt intégrées au fichier. Comme ce dépôt ne contient ni scripts d’assistance ni dossiers de référence supplémentaires, le comportement central se trouve dans le fichier de la skill lui-même ; il est donc important de le lire attentivement.

Transformer un objectif flou en prompt exploitable

Un bon prompt polyphony doit préciser : le dépôt cible, le nombre d’agents parallèles souhaité, le type de travail confié à chaque agent, l’attente concernant la branche ou la PR, ainsi que toute contrainte sur les tests, les identifiants ou le nettoyage. Par exemple, au lieu de dire « corrige ce projet », demandez : « découpe le problème en trois tâches d’agents isolées : reproduction, correctif et vérification, avec des espaces de travail Docker séparés et un statut de landing par branche. »

Ce qu’il faut préciser pour de meilleurs résultats

Donnez à la skill des signaux de routage concrets : priorité des tâches, dépendances, nécessité ou non d’un passage en lecture seule au départ, environnements sûrs à provisionner et critères de vérification. Cela aide l’orchestrateur à choisir de meilleurs RunSpecs et réduit les spins de conteneurs inutiles. Pour un guide polyphony, l’entrée la plus utile n’est pas plus de texte, mais des frontières de tâches plus nettes.

FAQ sur la skill polyphony

polyphony est-elle réservée aux environnements Docker ?

Oui, en pratique. La skill polyphony suppose que l’isolation par conteneur est disponible ; la prise en charge de Docker ou d’OrbStack est donc le principal critère d’adoption. Si vous ne pouvez pas provisionner de conteneurs, le workflow perd l’essentiel de sa valeur.

polyphony est-elle différente d’un prompt normal ?

Oui. Un prompt classique demande à un agent d’agir ; polyphony définit la manière dont plusieurs exécutions d’agents sont revendiquées, routées, provisionnées, vérifiées et finalisées. C’est précisément cette structure qui fait la force de la skill polyphony, surtout quand des branches indépendantes et une exécution propre comptent davantage que la vitesse seule.

Des débutants peuvent-ils utiliser polyphony ?

Oui, s’ils savent déjà lancer des conteneurs et lire un fichier de skill. La principale courbe d’apprentissage ne concerne pas la rédaction du prompt ; elle tient plutôt au fait que polyphony attend une décomposition des tâches et un environnement prêt. Les débutants obtiennent généralement de meilleurs résultats en commençant par une petite tâche et un seul objectif de vérification clair.

Quand ne faut-il pas utiliser polyphony ?

N’utilisez pas polyphony pour des questions rapides ponctuelles, des modifications légères ou des environnements sans Docker. C’est aussi un mauvais choix si la tâche est ambiguë et que vous n’avez pas encore défini ce que chaque agent doit prendre en charge, car la surcharge d’orchestration peut dépasser le bénéfice.

Comment améliorer la skill polyphony

Donner au routeur des frontières de tâches plus précises

Le gain de qualité le plus important avec polyphony vient d’une meilleure décomposition des tâches. Indiquez clairement quel travail est exploratoire, quel travail modifie le code et quel travail ne fait que vérifier. Si vous voulez du parallélisme, définissez la répartition explicitement au lieu de demander au système de l’inférer à partir d’un objectif vague.

Inclure les contraintes qui influencent le comportement de l’espace de travail

Mentionnez les règles de nommage des branches, les limites réseau, les attentes sur la durée des tests et le fait que des secrets ou des identités montées soient nécessaires. Comme polyphony utilise des conteneurs isolés et des branches indépendantes, ces contraintes influencent directement le provisioning et la possibilité de terminer l’exécution sans intervention manuelle.

Demander une vérification, pas seulement l’implémentation

Un mode d’échec fréquent consiste à s’arrêter à « le code a changé ». Une meilleure utilisation de polyphony demande des étapes de reproduction, des commandes de test et des critères de landing pour chaque piste d’agent. C’est particulièrement important lorsque plusieurs workers peuvent converger vers des solutions différentes et que vous avez besoin d’une décision de fusion fiable.

Itérer après la première exécution

Si la première sortie est trop large, resserrez la tâche et relancez avec un seul critère de réussite. Si le résultat est trop fragmenté, réduisez le nombre d’agents parallèles et renforcez les dépendances entre les étapes. Pour polyphony, l’amélioration vient généralement d’entrées d’orchestration plus précises, pas de prompts plus longs.