polyphony

Überblick über polyphony skill

polyphony ist ein Multi-Agent-Orchestrierungs-Skill für parallele Agentenarbeit in containerisolierten Arbeitsbereichen. Jede Session bekommt einen eigenen Docker-Container und einen eigenen git-Branch. Das ist besonders nützlich, wenn Sie parallele Ausführung ohne Branch-Kollisionen, geteilte State-Bugs oder aufwendige Aufräumarbeiten brauchen.

Wofür polyphony gedacht ist

Verwenden Sie den polyphony skill, wenn die Aufgabe größer ist als ein einzelner Prompt, aber trotzdem von klarer Delegation profitiert: parallele Feature-Arbeit, isolierte Validierung, Issue-Triage oder mehrere Agentenpfade gegen dieselbe Codebasis. Er ist für Nutzer gedacht, denen saubere Ausführung, reproduzierbares Task-Routing und sicherere Multi-Agent-Koordination wichtig sind.

Was polyphony auszeichnet

Das zentrale Unterscheidungsmerkmal von polyphony ist ein Workflow, der Isolation an erste Stelle setzt. Statt einen Agenten zu bitten, „alles zu machen“, trennt er Aufgabenerkennung, Routing, Provisionierung, Laufzeit und Verifikation, sodass jeder Worker in einem kontrollierten Workspace arbeitet. Dadurch ist der polyphony for Multi-Agent Systems Ansatz praktikabler, wenn Sie unabhängige Tests und ein saubereres Landing-Verhalten brauchen.

Passender Einsatzbereich und Abwägungen

polyphony passt am besten, wenn Ihre Umgebung bereits Docker oder OrbStack unterstützt und Sie Orchestrierung standardmäßig nutzen wollen, statt ein einmaliges Prompt-Muster zu bauen. Weniger sinnvoll ist er, wenn Sie nur eine einzelne Chat-Antwort brauchen, keine Container ausführen können oder eine Minimal-Konfiguration ohne repositorybewussten Workflow möchten.

So verwenden Sie polyphony skill

polyphony installieren und laden

Installieren Sie den polyphony skill in Ihrem Skills-Verzeichnis und verwenden Sie ihn dann aus dem Host-Workflow, der Skill-Laden unterstützt. Laut Repository ist vorgesehen, dass er automatisch geladen wird, wenn Container-Isolation verfügbar ist, und er ist der Standard für /spawn-team. Wenn Ihre Umgebung anders aufgebaut ist, prüfen Sie vorab, ob Docker-Zugriff, Branch-Erstellung und Workspace-Mounts verfügbar sind, bevor Sie sich auf den Skill verlassen.

Mit den richtigen Dateien beginnen

Für die Verwendung von polyphony beginnen Sie mit skills/polyphony/SKILL.md und lesen dann den verlinkten oder erwähnten Kontext in derselben Reihenfolge, in der der Skill intern arbeitet: Task-Lifecycle, Architektur, Voraussetzungen, Konfiguration und alle repositoryspezifischen Verweise, die in der Datei eingebettet sind. Da dieses Repo keine Helper-Skripte oder zusätzlichen Referenzordner hat, liegt das Kernverhalten direkt in der Skill-Datei selbst — deshalb lohnt es sich, sie genau zu lesen.

Eine grobe Zielsetzung in einen nutzbaren Prompt verwandeln

Ein starker polyphony-Prompt sollte enthalten: das Ziel-Repo, die gewünschte Anzahl paralleler Agenten, die Art der Arbeit, die jeder Agent übernehmen soll, die Branch- oder PR-Erwartung sowie alle Einschränkungen zu Tests, Credentials oder Aufräumen. Statt „fix this project“ zu schreiben, fragen Sie zum Beispiel: „Teile das Issue in drei isolierte Agentenaufgaben auf: reproduzieren, patchen und verifizieren, mit separaten Docker-Workspaces und Status zum Landing pro Branch.“

Was Sie für bessere Ergebnisse angeben sollten

Geben Sie dem Skill konkrete Routing-Signale: Aufgabenpriorität, Abhängigkeiten, ob zuerst nur lesender Zugriff nötig ist, welche Umgebungen sicher provisioniert werden können und was als Verifikation zählt. So kann der Orchestrator bessere RunSpecs wählen und verschwendete Container-Starts vermeiden. Für einen polyphony-Leitfaden ist der nützlichste Input nicht mehr Prosa, sondern klarere Aufgabengrenzen.

polyphony skill FAQ

Ist polyphony nur für Docker-Setups gedacht?

Ja, praktisch gesehen schon. Der polyphony skill setzt voraus, dass Container-Isolation verfügbar ist; Docker- oder OrbStack-Unterstützung ist daher die wichtigste Hürde für die Nutzung. Wenn Sie keine Container bereitstellen können, verliert der Workflow den größten Teil seines Nutzens.

Unterscheidet sich polyphony von einem normalen Prompt?

Ja. Ein normaler Prompt fordert einen Agenten zu einer Handlung auf; polyphony legt fest, wie mehrere Agentenläufe beansprucht, geroutet, provisioniert, verifiziert und gelandet werden. Genau diese Struktur ist der Sinn des polyphony skill, vor allem dann, wenn unabhängige Branches und saubere Ausführung wichtiger sind als reine Geschwindigkeit.

Können Anfänger polyphony nutzen?

Ja, wenn sie bereits Container starten und eine Skill-Datei lesen können. Die größte Lernkurve liegt nicht im Prompt-Schreiben, sondern darin zu verstehen, dass polyphony Aufgabenzerlegung und bereitstehende Umgebungen voraussetzt. Anfänger erzielen meist bessere Ergebnisse, wenn sie mit einer kleinen Aufgabe und einem klaren Verifikationsziel beginnen.

Wann sollte ich polyphony nicht verwenden?

Verwenden Sie polyphony nicht für schnelle Einzelfragen, leichte Editierungen oder Umgebungen ohne Docker. Er passt auch schlecht, wenn die Aufgabe noch zu unklar ist und Sie noch nicht definiert haben, wofür jeder Agent zuständig sein soll, weil der Orchestrierungs-Overhead dann den Nutzen übersteigen kann.

So verbessern Sie polyphony skill

Dem Router bessere Aufgabengrenzen geben

Der größte Qualitätsgewinn in polyphony entsteht durch klarere Task-Zerlegung. Sagen Sie deutlich, welche Arbeit explorativ ist, welche Code verändert und welche nur verifiziert. Wenn Sie Parallelität wollen, definieren Sie die Aufteilung ausdrücklich, statt das System sie aus einem vagen Ziel ableiten zu lassen.

Einschränkungen nennen, die das Workspace-Verhalten beeinflussen

Erwähnen Sie Regeln für Branch-Namen, Netzwerkgrenzen, erwartete Testlaufzeiten und ob Secrets oder gemountete Identitäten nötig sind. Da polyphony isolierte Container und unabhängige Branches nutzt, wirken sich diese Einschränkungen direkt auf die Provisionierung aus und darauf, ob der Lauf ohne manuelles Eingreifen abgeschlossen werden kann.

Verifikation verlangen, nicht nur Implementierung

Ein häufiger Fehler ist, bei „der Code hat sich geändert“ stehenzubleiben. Ein besserer polyphony-Einsatz fordert Reproduktionsschritte, Testbefehle und Landing-Kriterien für jeden Agentenpfad. Das ist besonders wichtig, wenn mehrere Worker zu unterschiedlichen Lösungen kommen können und Sie eine verlässliche Merge-Entscheidung brauchen.

Nach dem ersten Lauf nachschärfen

Wenn die erste Ausgabe zu breit ist, schränken Sie die Aufgabe ein und starten Sie mit nur einem Erfolgskriterium neu. Wenn das Ergebnis zu zerfasert ist, reduzieren Sie die Zahl der parallelen Agenten und bauen Sie stärkere Abhängigkeiten zwischen den Stufen ein. Bei polyphony kommt Verbesserung meist durch präzisere Orchestrierungs-Eingaben — nicht durch längere Prompts.