pi-subagents: pi-subagents: Async-Subagent-Delegation für Pi

Wie pi-subagents Arbeit an Child-Pi-Sessions delegiert

pi-subagents ist eine TypeScript-Erweiterung für den Pi-Assistenten. Sie ermöglicht der übergeordneten Pi-Session, fokussierte Child-Sessions, sogenannte Subagents, zu starten, die jeweils eine eigene Aufgabe haben. Die README nennt Code-Review, Erkundung, Implementierung, parallele Audits, gespeicherte Workflows und Hintergrundjobs als vorgesehene Anwendungsfälle. Die Installation der Erweiterung startet keinen automatischen Reviewer; sie gibt Pi ein Delegationswerkzeug. Die Child-Session führt ihre eigene Aufgabe aus und liefert Ergebnisse, entweder im Gespräch per Streaming bei Vordergrundläufen oder weiterlaufend im Hintergrund.

Bei pi-subagents ist dieser Abschnitt mit dem konkreten Prüfpunkt agents verbunden. Für eine erste lokale Prüfung eignet sich pi install npm:pi-subagents; dabei sollte genau beobachtet werden, ob die im README beschriebene Ausgabe und der erwartete Dateipfad zusammenpassen. Das README belegt keine weitergehenden Leistungswerte, daher bleiben Durchsatz, Ressourcenbedarf und Verhalten unter eigener Last offene Fragen. Die Entscheidung sollte an diesem Projektmerkmal hängen und nicht an einer allgemeinen Versprechensliste.

Installation und die ersten Delegationsaufforderungen

Die Installation ist ein einzelner Befehl: `pi install npm:pi-subagents`. Danach können Sie Pi in natürlicher Sprache um Delegation bitten, ohne Agents zu erstellen, Konfiguration zu schreiben oder Slash-Befehle zu lernen. Beispiele aus der README sind 'Use reviewer to review this diff.' und 'Run parallel reviewers: one for correctness, one for tests, and one for unnecessary complexity.' Pi entscheidet, ob das `subagent`-Werkzeug aufgerufen wird, welcher Agent verwendet wird und wie zusammengesetzte Arbeit mit `workflowScript` ausgedrückt wird. Die Erweiterung enthält eingebaute Agents, die sofort verwendet werden können.

Die eingebauten Agents im Überblick

Das Paket bündelt acht Agents. `scout` führt schnelle lokale Codebasis-Erkundung durch. `researcher` sammelt Web- und Dokumentationsquellen. `planner` erstellt einen Implementierungsplan, ohne Code zu bearbeiten. `worker` bearbeitet Dateien und validiert Änderungen. `reviewer` prüft die Implementierung gegen die Aufgabe und Tests. `context-builder` schreibt Übergabematerial wie `context.md` und `meta-prompt.md`. `oracle` hinterfragt Annahmen und empfiehlt ohne Bearbeitung den nächsten Schritt. `delegate` ist ein leichtgewichtiger allgemeiner Child-Agent, der sich ähnlich wie die übergeordnete Session verhält. Eingebaute Agents übernehmen standardmäßig Ihr aktuelles Pi-Standardmodell, sofern Sie kein anderes festlegen.

Modell-Routing, Overrides und unscharfe Übereinstimmung

Sie können `subagents.defaultModel` setzen, um allen Subagents ohne explizites Modell einen eigenen Standard zu geben. Overrides pro Agent liegen in `agentOverrides`, die Modell, Denkmodus, Werkzeuge, Fähigkeiten, Prompt-Text ändern oder einen eingebauten Agent deaktivieren können. `subagents.defaultThinking` und `subagents.defaultExtensions` bieten gemeinsame Standardwerte für Agents, die diese Felder nicht setzen. Modell-IDs werden unscharf mit der Registry abgeglichen, sodass Varianten bei Anbietertrennzeichen, Groß-/Kleinschreibung und nachgestellten Datumsstempeln zum selben Modell auflösen; exakte `provider/id`-Übereinstimmungen haben weiterhin Vorrang. Projekteinstellungen werden aus dem nächsten übergeordneten Verzeichnis mit `.pi` oder `.agents` aufgelöst, es sei denn, `projectRootResolution` ist auf `git-root` gesetzt.

Der optionale Watchdog und Berechtigungsgates

Der Subagent-Watchdog ist ein optionaler adversarischer Änderungsprüfer, getrennt vom `reviewer`-Agent. Er prüft Repository-Änderungen an der `agent_end`-Grenze nur, wenn sich der endgültige Repository-Zustand geändert hat, fasst mehrere Änderungen zu einer Prüfung zusammen und überspringt generierte Artefakte. Er kann frische Sprachserver-Diagnosen für geänderte TypeScript- und JavaScript-Dateien ausführen und unterstützt Scopey-artige Bereichsüberwachung mit `subagents.watchdog.cadence.everyNTools`. Native Child-Berechtigungen sind ebenfalls optional: `allow`-, `ask`- und `deny`-Regeln in `permissions.rules` steuern Nicht-bash-Werkzeugaufrufe, wobei `ask` den Aufruf für einen Watchdog-Modell-Schlichter pausiert. Bash wird immer durchgelassen, und externe CLI-Profile sind für native Berechtigungen undurchsichtig.

Asynchrone Läufe, Fleet-Ansichten und Lebenszyklus-Artefakte

Vordergrundläufe streamen Fortschritt im Gespräch und haben standardmäßig ein 30-minütiges Echtzeit-Timeout, wenn weder der Aufruf noch der Agent eines bereitstellt. Hintergrundläufe arbeiten weiter, nachdem die Kontrolle zurückgekehrt ist. Die TUI zeigt eine persistente FleetView unter dem Editor, und `/subagents-fleet` öffnet einen Live-Inspektor. Asynchrone Läufe schreiben maschinenlesbare Lebenszyklus-Artefakte: `status.json`, `events.jsonl`, `output-<index>.log` und eine abschließende Zusammenfassung im Ergebnisverzeichnis. Lebenszyklus-Artefakt v3 fügt Prozessabschlussnachweis hinzu, der nur `observed` ist, nachdem der Live-Elternprozess das `close`-Ereignis des getrennten Läufers sieht. Andere Pi-Erweiterungen können die In-Process-Event-Bus-RPC mit den Methoden `ping`, `status`, `spawn`, `steer`, `interrupt`, `stop` und `resume` verwenden.

Orchestrierung, Supervisor-Koordination und workflowScript

Die empfohlene Orchestrierungsschleife ist `clarify`, `planner`, `worker`, `fresh reviewers`, `worker`. Kindersicherheitsgrenzen werden zur Laufzeit durchgesetzt: Erzeugte Child-Agents erhalten die gebündelte Fähigkeit nicht, gefilterter Kontext entfernt nur-elterliche Subagent-Artefakte, und standardmäßig registrieren Child-Agents das `subagent`-Werkzeug nur, wenn ihre aufgelösten Werkzeuge es enthalten. Native Supervisor-Koordination erlaubt einem Child-Agent, `contact_supervisor` zu verwenden, um den Elternteil um eine Entscheidung zu bitten, und der Elternteil antwortet mit `subagent_supervisor({ action: "reply" })`. Multi-Agent-Orchestrierung wird durch `workflowScript` im `subagent`-Werkzeug ausgedrückt; die alten `/chain`, `/parallel` und `/run-chain`-Befehle sind nicht registriert. Die README endet mit Referenzmaterial zu exakter Befehlssyntax, Frontmatter für benutzerdefinierte Agents, skriptbasierten Workflows und Konfigurationsschlüsseln.

Redaktionelles Fazit

pi-subagents passt zu Teams und Einzelpersonen, deren Arbeitsablauf genau auf die dokumentierten Eingaben, Ausgaben und Plattformen zugeschnitten ist. Nicht geeignet ist es für Erwartungen, die das README nicht belegt. Prüfe zuerst pi install npm:pi-subagents, kontrolliere agents und entscheide anhand des tatsächlichen Ergebnisses, der Abhängigkeiten und der Wartung im eigenen Umfeld.

Offizielle Quellen

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