CommunityCodierung & Entwicklunggithub.com

wptoux/harness2

Ermöglicht die Wiederholung und Verfestigung bereits einmal akzeptierter Aufgaben – wiederkehrende Lieferobjekte, wöchentliche Berichte, Multi-Quellen-Recherchen oder Arbeitsabläufe, die derzeit von einer Person abhängen, die sich die Schritte merkt.

Was ist harness2?

Harness² ist ein KI-Agenten-Skill, der darauf ausgelegt ist, einmalige erfolgreiche Ausführungen in wiederholbare, robuste Prozesse zu überführen. Statt das aktuelle Ergebnis zu optimieren, zielt der Skill darauf ab, die nächste Ausführung durch die Erstellung eines „Harness“ – eines Systems aus editierbaren Komponenten wie System-Prompt, Tool-Anleitungen, Skills und Leitplanken – zu verfestigen. Der Skill folgt einer rigorosen Schleife aus „Vorschlagen → Testen → Zusammenstellen“: Zwei Kandidaten (einer für allgemeine Prozessdefekte, einer für domänenspezifische Fehler) werden parallel getestet, indem die gleiche Eingabe mit geändertem Harness wiederholt wird. Die Ergebnisse werden anhand des Verhaltensunterschieds zur Baseline und der Wiederholkonsistenz bewertet. Der Output besteht aus drei Artefakten: einem `harness/`-Verzeichnis mit editierbaren Dateien, einer `SOP.md` mit allen Schritten und Fallstricken sowie einer `REGRESSION.md` als Abnahmeliste. Der Skill eignet sich besonders für Claude Code, Cursor und Codex, wenn Aufgaben wöchentlich wiederkehren, der Prozess im Kopf einer Person lebt oder Fehler immer wieder gleich auftreten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add wptoux/harness2

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Harness² — Wiederholbare Aufgaben verfestigen

Adaptiert von Harness²: Recursive Agent Harnessing for an Open World, beschränkt auf den Fall, dass eine Ausführung bereits akzeptiert wurde und das Ziel die Wiederholung ist.

Überblick

Einmal erfolgreich zu sein ist nicht dasselbe wie wiederholbar zu sein. Der akzeptierte Durchlauf ist Ihr einziger vertrauenswürdiger Referenzpunkt: Er enthält ein echtes Ergebnis, eine reale Vorgehensweise und die Stellen, an denen der Benutzer persönlich Änderungen vorgenommen hat.

Das Optimierungsziel ist der Prozess des nächsten Durchlaufs, nicht das Ergebnis des aktuellen. Das Ergebnis ist also kein besserer Bericht – es ist ein Harness, eine SOP und eine Regressions-Checkliste.

Wann verwenden

  • Der Benutzer sagt „das machen wir ab jetzt jede Woche“ oder „lasst uns diesen Prozess festzurren“
  • Die gleiche Art von Aufgabe wurde mindestens einmal erledigt und das Ergebnis wurde akzeptiert
  • Der Prozess lebt im Kopf einer Person: wer welches Skript zuerst ausführt, welcher Schritt eine menschliche Prüfung benötigt, wo die Fallen liegen
  • Die gleiche Aufgabenklasse scheitert immer wieder auf die gleiche Weise: fehlende Quellenangaben, inkonsistente Definitionen, ständige Nacharbeit

Wann NICHT verwenden

  • Einmalige Aufgabe → einfach erledigen
  • Ein echter Bewerter, Komponententest oder berechenbares Abnahmekriterium existiert → verwenden Sie dies; es schlägt Verhaltensvergleiche bei weitem
  • Der Benutzer möchte nur ein Format oder eine Definition ändern und hat diese bereits genannt → bearbeiten Sie das Harness direkt, überspringen Sie den Vergleichszyklus
  • Der Prozess ist bereits stabil und Kosten oder Latenz sind knapp

Was ein Harness ist

Alles rund um das Modell, das bearbeitet werden kann. Vier Komponenten reichen für den Betrieb; acht ist der vollständige Satz:

KomponenteRolleMinimum
System-PromptRolle, Ausgabe-Kontrakt✅
Tool-AnleitungWann welche Datenquelle nutzen, wie Argumente füllen✅
SkillsWiederverwendbare Urteile und Verfahren✅
LeitplankenHarte Einschränkungen (niemals Zahlen erfinden, immer Quellen zitieren)✅
GedächtnisDomänennotizen, die über Instanzen hinweg getragen werden
SkripteDeterministische Arbeiten (Konvertierung, Deduplizierung, Aggregation)
Sub-AgentenVerifikation oder paralleles Abrufen, ausgelagert
PluginsMiddleware (z. B. Selbstprüfung alle N Schritte erzwingen)

Ein Harness muss als Dateien existieren, die versioniert und wiederverwendet werden können. „Das machen wir normalerweise so“ – in einem Chat hinterlassen – lässt sich nicht verfestigen.

Der Kreislauf: Vorschlagen → Testen → Zusammenstellen

0. Baseline einfrieren

Archivieren Sie den letzten Durchlauf vollständig: Harness-Momentaufnahme, vollständige Vorgehensweise (Tool-Aufrufsequenz + Zwischenergebnisse), endgültiges Ergebnis, das Bearbeitungs-Diff des Benutzers, Abnahmekriterien, Datenmomentaufnahme oder Zeitfenster.

Stellen, die der Benutzer persönlich bearbeitet hat, sind hochzuverlässige Fehlerstellen – zuverlässiger als jede Vermutung.

1. Vorschlagen

Lesen Sie die Baseline und schlagen Sie zwei Kandidaten vor, jeder mit einem Satz, der den adressierten Defekt benennt:

  • invariant: Prozessdefekte – keine Querprüfungen, Zwischenergebnisse nie gespeichert, Fehler nicht wiederholt, Quellen unbeschriftet, Kontext aufgebläht
  • domain: fachliche Einschränkungen dieser Aufgabenklasse – konsistente Definitionen, Währungs- oder Einheitenumrechnung, abgestimmte Zeitfenster

Sie benötigen beide, um „allgemeine Krankheit“ von „Krankheit dieser Aufgabenklasse“ zu trennen. Mit einem einzigen Kandidaten können Sie das Ergebnis nicht zuordnen.

2. Testen

Wiederholung mit derselben Eingabe bei kontrollierten Variablen: gleiches Modell, gleicher Toolsatz, gleiche Datenmomentaufnahme. Nur das Harness ändert sich.

Vergleichen Sie zwei Dinge:

  1. Verhaltensunterschied zur Baseline: Toolsatz und -reihenfolge, Schrittanzahl, wiederholte Aufrufe, Fehler und Wiederholungen, ob manuelle Korrekturpunkte verschwunden sind, ob Zwischenergebnisse gespeichert wurden, ob Quellen vollständig attribuiert sind
  2. Wiederholkonsistenz: Führen Sie es erneut aus – ist die Struktur gleich? Die Kernmetrik der Verfestigung ist Stabilität, nicht die beste Einzelausführung

Der Vergleich zeigt „Verhalten hat sich geändert“. Er zeigt nicht „das Ergebnis ist richtig“. Verwechseln Sie niemals beides.

3. Zusammenstellen

Behalten Sie nur Änderungen, die (a) nach Wiederholung immer noch die Abnahmekriterien erfüllen und (b) Nacharbeit oder manuelle Korrekturen reduzieren. Die Beibehaltung des Originals ist erlaubt – eine Änderung ohne Beleg ist Rauschen.

Dokumentieren Sie jede Entscheidung in einer Zeile: Änderung | adressierter Defekt | beobachteter Beleg | übernommen / überarbeitet / verworfen.

4. Verfestigen

Drei Artefakte; fehlt eines, ist die Verfestigung nicht abgeschlossen:

  • harness/ – die editierbaren Dateien
  • SOP.md – Schritte, Prüfpunkte, wann ein Mensch gefragt werden muss, bekannte Fallen (bei über zehn Punkten liest sie niemand)
  • REGRESSION.md – die Abnahme-Checkliste, die nach dem nächsten Durchlauf durchgegangen wird

Wenn eine Änderung über mehrere Runden übernommen wird, erheben Sie sie zu einem eigenständigen Skript oder Skill.

Beweishierarchie

Benutzer-Edit-Diff > Vergleich mit akzeptiertem Ergebnis > Wiederholkonsistenz > Vorgehensweisen-Unterschied > Intuition

Keine Beweise: ein längerer oder detaillierterer Bericht, „der Benutzer hat sich diesmal nicht beschwert“, die Behauptung des Modells, es habe besser abgeschnitten.

Budget

Standard: k=1 plus eine Wiederholung. Verfestigung zahlt sich über Zeit aus – amortisieren Sie sie über mehrere Durchläufe: Testen Sie während jedes wiederkehrenden Durchlaufs einen Kandidaten, statt 3× den Aufwand für parallele Zweige zu betreiben.

Warnsignale – anhalten, wenn eines auftritt

  • Das vorherige Harness ungeprüft übernehmen, ohne das Bearbeitungs-Diff des Benutzers zu lesen
  • Mit einer anderen Eingabe, einem anderen Modell oder einer anderen Datenmomentaufnahme wiederholen und trotzdem behaupten „es ist besser“
  • Aus einer einzigen Wiederholung schließen, ohne Zufälligkeit auszuschließen
  • Fünf Komponenten gleichzeitig ändern, sodass eine Zuordnung unmöglich wird
  • Eine 20-Punkte-SOP, die beim nächsten Mal niemand befolgen wird
  • Einen einmaligen glücklichen Trick in einen invarianten Eintrag schreiben

Häufige Fehler

FehlerFolgeLösung
Optimieren vor dem ArchivierenBaseline verloren, Änderungen nicht zuordenbarzuerst Baseline einfrieren
„Liest sich besser“ als BelegSie verfestigen eine Vorliebe, keinen Prozessan eine konkrete Beobachtung binden
Nur Prompt-Änderungen, keine PrüfpunkteMenschen patchen beim nächsten Mal immer noch manuelljeden Defekt mit einem Prüfpunkt paaren
SOP als Reisebericht geschriebenNiemand liest sie, also wird nichts verfestigtnur Entscheidungspunkte und Fallen notieren

Verwandte Skills