Smokefarmer/multi-agent-delivery-skill

Multi-Agenten-Auslieferung

Übersicht

Verwenden Sie diese Fähigkeit, wenn die Aufgabe groß genug ist, um von strukturierter Planung, paralleler Implementierung, expliziter Überprüfung und einem echten Verifikationsdurchlauf vor der Fertigmeldung zu profitieren.

Verwenden Sie diese Fähigkeit nicht für winzige Einzeldatei-Änderungen, bei denen der Delegationsaufwand größer ist als die Aufgabe selbst.

Arbeitsablauf

1. Vor der Änderung prüfen

• Lesen Sie die relevanten Codepfade, bevor Sie Änderungen vorschlagen.
• Identifizieren Sie den unmittelbaren Engpass auf dem kritischen Pfad.
• Unterscheiden Sie blockierende Arbeit von Nebenarbeiten, die parallel ausgeführt werden können.

2. Einen kurzen Ausführungsplan schreiben

• Erstellen Sie für nicht-triviale Aufgaben einen prägnanten Plan vor größeren Bearbeitungen.
• Halten Sie genau einen Schritt gleichzeitig in Bearbeitung.
• Aktualisieren Sie den Plan, wenn sich der Umfang ändert oder wenn Sie von der Analyse zur Implementierung zur Verifikation übergehen.

3. Arbeit in überschneidungsfreie Teile aufteilen

• Behalten Sie den Haupt-Thread für Integration, Konfliktlösung und abschließende Verifikation verantwortlich.
• Verwenden Sie Explorer für begrenzte Codebasis-Fragen oder Hotspot-Erkennung.
• Verwenden Sie Worker für konkrete Implementierungsteile mit expliziter Dateiverantwortung.
• Geben Sie jedem Worker einen überschneidungsfreien Schreibbereich und weisen Sie ihn an, keine nicht damit zusammenhängenden unbereinigten Arbeitsbaum-Änderungen rückgängig zu machen.
• Halten Sie dringende kritische Pfad-Arbeiten lokal, wenn die nächste Aktion sofort davon abhängt.

4. Mit klarer Zuständigkeit delegieren

Jeder Worker-Prompt sollte Folgendes enthalten:

• Die genauen Dateien oder Module, die er besitzt
• Das spezifisch erwartete Ergebnis
• Eine Warnung, dass auch andere Agents das Repository bearbeiten
• Anweisungen, keine Dateien außerhalb des Zuständigkeitsbereichs zu berühren
• Eine Aufforderung zur gezielten Verifikation und einer Zusammenfassung der geänderten Dateien

5. Nach der Implementierung überprüfen

• Führen Sie nach Code-Änderungen mindestens einen Überprüfungsdurchlauf für das integrierte Ergebnis durch.
• Fügen Sie eine sicherheitsorientierte Überprüfung für Authentifizierung, Eingabebehandlung, RPC, Zahlungen oder Transaktionen hinzu.
• Fügen Sie eine Rust/Anchor-Überprüfung für Smart-Contract-Änderungen hinzu.
• Beheben Sie schwerwiegende Überprüfungsbefunde, bevor Sie die Fertigstellung melden.

6. Verifizieren, bevor Sie es als erledigt melden

Führen Sie die stärkste praktische Verifikation für die berührten Ebenen durch:

• Typüberprüfung
• Linting
• Tests
• Vertrags-Build/Test, wenn zutreffend

Bei breiten Bereinigungsaktionen führen Sie zuerst eine gezielte Verifikation pro Teil durch, dann einen vollständigen Repository-weiten Durchlauf für die betroffenen Ebenen.

Melden Sie niemals "erledigt", während die erforderliche Verifikation noch fehlschlägt.

7. Ergebnisse klar berichten

Der Abschlussbericht sollte Folgendes enthalten:

• Was sich auf hoher Ebene geändert hat
• Welche Verifikation bestanden wurde, mit Zahlen, falls verfügbar
• Welche Schulden oder Restrisiken bestehen bleiben
• Was nicht ausgeführt wurde, falls etwas

Delegationsregeln

• Bevorzugen Sie parallele Agents nur dann, wenn sich ihre Schreibbereiche nicht überschneiden.
• Duplizieren Sie keine Arbeit zwischen dem Haupt-Thread und Workern.
• Verwenden Sie wait_agent sparsam; führen Sie während der Agentenausführung weiterhin nützliche lokale Arbeiten durch.
• Schließen Sie fertige Agents, wenn sie nicht mehr benötigt werden.

Vorgeschlagenes Muster

Für eine typische nicht-triviale Aufgabe:

1. Prüfen und einen kurzen Plan schreiben.
2. 1 Explorer starten, wenn eine Hotspot-Analyse erforderlich ist.
3. 1–3 Worker für überschneidungsfreie Teile starten.
4. Während sie laufen, lokale Integrationsarbeit fortsetzen.
5. Ergebnisse integrieren und Konflikte lokal lösen.
6. Überprüfungsdurchlauf(/-läufe) durchführen.
7. Vollständige Verifikation durchführen.
8. Ergebnisse und verbleibende Schulden melden.