pua-loop

Überblick über den pua-loop skill

Wofür pua-loop gedacht ist

pua-loop ist ein Skill zur Ausführung von Schleifen für lange, mehrstufige Implementierungsaufgaben, bei denen der Agent ohne ständige Rückfragen weiter iterieren soll. Er kombiniert eine autonome Retry-Schleife mit den Verhaltensregeln des Repos pua:pua, sodass der Agent Arbeitsschritte fortlaufend prüft, validiert, korrigiert und erneut ausführt, bis er den Abschluss melden kann.

Wann der pua-loop skill am besten passt

Der pua-loop skill passt am besten für Nutzer, die an Coding- oder Workflow-Aufgaben arbeiten, die sich lokal verifizieren lassen: Bugfixes, Refactorings, Feature-Fertigstellung, Test-Reparaturen und wiederkehrende Bereinigungen. Besonders relevant ist pua-loop for Workflow Automation, wenn Unterbrechungen teurer sind als ein paar nicht perfekte Annahmen.

Das eigentliche Job-to-be-done

Was Nutzer in der Praxis meist wollen, ist nicht „ein cleverer Prompt“, sondern eine Möglichkeit, eine klar abgegrenzte Aufgabe zu übergeben, ohne den Agenten alle paar Minuten beaufsichtigen zu müssen. Genau für dieses Handover ist pua-loop gedacht. Das zentrale Versprechen ist autonome Iteration: aktuellen Zustand prüfen, Änderung vornehmen, Validierung ausführen, Fehler diagnostizieren und weitermachen.

Was pua-loop von anderen Ansätzen unterscheidet

Der wichtigste Unterschied ist, dass pua-loop Beharrlichkeit bewusst erzwingt. Der Skill verbietet im Loop-Modus ausdrücklich Rückfragen an den Nutzer und erwartet, dass der Agent Alternativen ausschöpft, bevor er aufgibt. Außerdem speichert er den Loop-Zustand in einer lokalen Datei, sodass das Verhalten Kontext-Komprimierung besser übersteht als ein normaler One-shot-Prompt.

Wichtiger Hinweis vor der Einführung

Das ist kein allgemeiner Skill für „besseres Coden“. pua-loop ist am stärksten, wenn die Aufgabe eine klare Erfolgsbedingung und verfügbare Prüfungen hat. Wenn die Aufgabe mehrdeutig ist, häufige Produktentscheidungen erfordert oder von externen Freigaben abhängt, ist gewöhnliches interaktives Prompting in der Regel die sicherere Wahl.

So nutzt du den pua-loop skill

Vor dem Einsatz erst den Installationskontext prüfen

Der gezeigte Repo-Ausschnitt enthält nur SKILL.md, der Skill setzt aber Unterstützung aus dem breiteren Repo tanweai/pua voraus, einschließlich eines Setup-Script-Pfads und des Kernverhaltens von pua:pua. Bevor du pua-loop ernsthaft einsetzt, solltest du das Repo-Root prüfen und sicherstellen, dass das referenzierte Loop-Script und der Core-Skill in deiner installierten Umgebung tatsächlich vorhanden sind.

So wird pua-loop ausgelöst

Der dokumentierte Trigger ist /pua:pua-loop "task description". In der Beschreibung werden auch natürlichsprachliche Trigger wie loop mode, 自动循环 und 一直跑 genannt, aber der Slash-Command ist die eindeutigste Methode, um pua-loop usage zuverlässig zu starten.

Was nach dem Start passiert

Beim Start führt der Skill einen Setup-Befehl aus, der .claude/pua-loop.local.md anlegt. Diese Datei speichert die Aufgabe samt Loop-Protokoll. Ein Stop-Hook nutzt diese Datei dann, um dem Agenten in jeder Iteration erneut Anweisungen zuzuführen. Praktisch heißt das: Der Agent kann dasselbe Aufgabenmuster über mehrere Durchläufe hinweg fortsetzen, ohne dass du den Workflow jedes Mal neu erklären musst.

Welche Eingaben pua-loop gut machen

Gib pua-loop von Anfang an vier Dinge mit:

1. Das gewünschte Ergebnis
2. Den Repo- oder Ordner-Scope
3. Den Validierungsbefehl
4. Harte Constraints

Eine schwache Eingabe:

• „Fix the app.“

Eine starke Eingabe:

• „Use pua-loop to fix the failing login flow in apps/web. Success means pnpm test --filter web passes and the OAuth callback no longer throws a 500. Do not change the database schema. Prefer the smallest safe fix.”

Diese stärkere Version reduziert unnötige Iterationen, weil der Agent weiß, wo er arbeiten soll, wie Erfolg geprüft wird und was er nicht anfassen darf.

Aus einem groben Ziel einen vollständigen pua-loop Prompt machen

Ein praxistaugliches Muster für einen pua-loop guide ist:

• Task: was gebaut oder repariert werden soll
• Scope: Grenzen für Dateien, Package oder Service
• Verification: Tests, Lint, Build, Smoke-Check
• Constraints: keine Schema-Änderungen, keine neuen Dependencies, API stabil halten
• Priority: schnellster sicherer Fix vs. tieferes Refactoring

Beispiel:

• /pua:pua-loop "Resolve TypeScript errors in packages/api only. Run pnpm --filter api build after each meaningful fix. Do not modify public endpoint contracts. Stop only when build passes and no new lint errors are introduced."

Welche Repository-Dateien du zuerst lesen solltest

Starte mit:

• skills/pua-loop/SKILL.md

Prüfe danach im übergeordneten Repo:

• die Core-Skill-Definition von pua:pua
• ein mögliches scripts/setup-pua-loop.sh
• Hook-Dokumentation oder Setup-Dateien für Claude-Plugins

Diese Reihenfolge ist wichtig, weil Entscheidungen rund um pua-loop install weniger von der Beschreibung abhängen als davon, ob deine lokale Umgebung das Setup-Script und die Stop-Hook-Schleife tatsächlich unterstützt.

Was die Schleife in jeder Iteration konkret macht

Das Kernregelwerk des Skills ist einfach:

• pua:pua Verhalten laden
• dem Nutzer keine Fragen stellen
• nicht vorzeitig mit „cannot solve“ abbrechen
• nach jeder Änderung validieren, Probleme finden, korrigieren und erneut validieren

Dadurch ist pua-loop eher ein autonomer Reparaturzyklus als eine normale Assistenten-Interaktion.

Wann du pua-loop statt eines normalen Prompts verwenden solltest

Nutze pua-loop, wenn:

• Erfolg automatisch geprüft werden kann
• mehrere Runden aus Fixen und Verifizieren zu erwarten sind
• du weniger Unterbrechungen willst
• das Repo ausführbare Commands bietet

Lass es besser, wenn:

• die Aufgabe bei jedem Schritt Produkturteil erfordert
• der Agent keinen Zugriff auf Tests oder Laufzeitprüfungen hat
• eine falsche Annahme teuer wäre

Praktischer Workflow für den ersten Einsatz

Ein sinnvoller erster Durchlauf:

1. Starte mit einem klar abgegrenzten Problem, nicht mit einem großen Rewrite.
2. Gib den exakten Validierungsbefehl an.
3. Halte den Scope eng auf ein Package oder Feature begrenzt.
4. Lass die Schleife laufen.
5. Prüfe die finalen Änderungen und erweitere den Einsatz erst danach.

So reduzierst du das größte Einführungsrisiko: selbstbewusste autonome Änderungen bei zu ungenau beschriebenen Aufgaben.

Abbruch und Sicherheitsgrenzen

Der Skill dokumentiert zwei Stop-Wege: /cancel-pua-loop oder das Löschen von .claude/pua-loop.local.md. Das solltest du als zwingendes Betriebswissen betrachten, bevor du autonome Iteration aktivierst. Wenn du diese Datei in deiner Umgebung nicht einfach prüfen oder entfernen kannst, ist der pua-loop skill für dein Setup möglicherweise keine gute Wahl.

FAQ zum pua-loop skill

Ist pua-loop für Einsteiger geeignet?

Ja, aber nur für klar eingegrenzte Aufgaben. Einsteiger profitieren oft von der Automatisierung, geben aber auch häufiger vage Anweisungen. Wenn du neu einsteigst, beginne mit einem fehlschlagenden Test oder einem Build-Fehler, nicht mit einer offenen Architekturfrage.

Ersetzt pua-loop normales Prompting?

Nein. pua-loop ist besser für Ausführungsschleifen geeignet, nicht für gemeinsame Exploration. Wenn du erst noch einen Ansatz auswählen, Optionen vergleichen oder Anforderungen klären musst, nutze zunächst einen normalen Prompt und wechsle erst zu pua-loop, wenn der Plan steht.

Was ist die größte Hürde für eine erfolgreiche pua-loop install?

Meist ist es ein Umgebungs-Mismatch. Der Skill verweist auf ein Setup-Script und eine von Stop-Hooks getriebene Schleife. Wenn dein lokales Claude-/Plugin-Setup diese Bausteine nicht bereitstellt, erzeugt das Markdown allein nicht das beabsichtigte autonome Verhalten.

Kann pua-loop auch ohne Tests funktionieren?

Ja, aber die Qualität sinkt. Ohne Tests, Build-Commands oder Smoke-Checks hat der Agent weniger Signale, um zu erkennen, ob eine Iteration die Aufgabe wirklich verbessert hat. In diesem Fall wird pua-loop usage stärker von Vermutungen getrieben und deutlich weniger verlässlich.

Wie unterscheidet sich pua-loop davon, einfach nur „keep trying“ zu sagen?

Ein normaler Prompt kann Beharrlichkeit einfordern, aber pua-loop ergänzt ein konkretes Betriebsmodell: persistenter Zustand über eine lokale Datei, wiederholte Validierung, expliziter No-Question-Modus und Abschlusssignalisierung. Genau diese Struktur ist der eigentliche Grund, ihn zu installieren.

Wann sollte ich pua-loop for Workflow Automation nicht verwenden?

Verwende pua-loop for Workflow Automation nicht, wenn der Workflow von menschlichen Freigaben, externen Credentials, unklaren Business-Regeln oder Aufgaben abhängt, bei denen „fertig“ subjektiv ist. Autonomes Loopen hilft nur dann, wenn Abschluss überprüfbar ist.

So verbesserst du den pua-loop skill

Gib pua-loop eine messbare Ziellinie

Der schnellste Weg zu besseren Ergebnissen mit pua-loop ist eine maschinell prüfbare Definition von „fertig“. „Make it work“ ist schwach. „Alle Auth-Tests bestehen, der Build läuft durch und /login/callback liefert 200“ ist stark. Der Skill ist auf Iteration ausgelegt und braucht deshalb ein Ziel, das er selbst verifizieren kann.

Enger Scope reduziert schlechte autonome Entscheidungen

Weil pua-loop Rückfragen vermeidet, erzeugen breite Aufgaben unnötiges Risiko. Statt „refactor payments“ solltest du eher sagen: „fix duplicate retry handling in services/payments/retry.ts without changing webhook payloads.“ Ein enger Scope verbessert sowohl Geschwindigkeit als auch Sicherheit.

Gib Constraints mit, die destruktive Fixes verhindern

Gute Constraints sind kein überflüssiger Zusatz, sondern verhindern, dass die Schleife das falsche Problem löst. Nützliche Beispiele:

• keine Dependencies hinzufügen
• Schema nicht ändern
• API-Responses rückwärtskompatibel halten
• minimalen Patch statt Rewrite bevorzugen

Das verbessert direkt die Qualität der pua-loop-Ergebnisse.

Nutze den stärksten verfügbaren Validierungsbefehl

Wenn es mehrere Checks gibt, wähle den relevantesten, nicht den lautesten. Für einen UI-Bug ist eine gezielte Testsuite besser als ein kompletter Monorepo-Durchlauf. Für ein Typ-Problem kann tsc auf dem betroffenen Package sinnvoller sein als breites Linting. Bessere Validierung führt zu besseren Entscheidungen im Loop.

Rechne mit Ausfällen durch fehlenden Kontext

Typische Fehlerbilder bei pua-loop sind vorhersehbar:

• vage Aufgabenbeschreibungen
• fehlender Repo-Pfad oder Modulumfang
• kein Validierungsbefehl
• versteckte nicht-technische Anforderungen
• autonome Änderungen im falschen Package

Die meisten dieser Probleme löst man, indem man den initialen Prompt verbessert, nicht indem man denselben Lauf unverändert wiederholt.

Nach dem ersten Durchlauf mit präziseren Anweisungen nachschärfen

Wenn der erste pua-loop-Durchlauf fast ans Ziel kommt, aber nicht ganz, sage nicht einfach nur „try again“. Liefere das fehlende Signal nach:

• was noch fehlschlägt
• welche Dateien fälschlich geändert wurden
• welcher Trade-off bevorzugt werden soll
• welches Validierungsergebnis am wichtigsten ist

So wird der zweite Lauf zu einer gezielten Korrektur statt zu weiterem blindem Loopen.

Vertrauen steigern, indem du die Core-Dependency prüfst

Da pua-loop Verhalten von pua:pua übernimmt, sollten fortgeschrittene Nutzer diesen Core-Skill vor der Einführung prüfen. Wenn dir dessen Druckstil oder Entscheidungsregeln nicht zusagen, willst du möglicherweise auch diesen Loop-Wrapper nicht einsetzen. Das ist einer der wichtigsten Repo-Read-Schritte für eine fundierte pua-loop install-Entscheidung.

Erst begrenzte Automatisierung, dann ausweiten

Für die meisten Teams ist der beste pua-loop guide eine schrittweise Einführung: zuerst bei Reparaturaufgaben mit klaren Checks, dann bei kleineren Feature-Abschlüssen und erst später bei größeren Automatisierungsabläufen. Mit dieser Reihenfolge kannst du prüfen, ob das Loop-Verhalten zu deinem Repo und deiner Risikotoleranz passt.