Communitygithub.com

haidrrrry/loop-engineering-skills

Das fehlende Gehirn für KI-Codierungsagenten — Verifikationsgatter, die vor dem Code geschrieben werden, Reflexion-ähnliches Gedächtnis, das aus jedem Fehler lernt, und Selbstkorrekturschleifen mit echten Ankern. Ein Befehl zur Installation für Claude Code; Kopieren-und-Einfügen-Prompts für jede KI.

Was ist loop-engineering-skills?

Dieses Skill implementiert ein Reflexion-ähnliches verbales Gedächtnis für KI-Agenten, das es ihnen ermöglicht, aus jedem Versuch (ob bestanden oder fehlgeschlagen) zu lernen, indem es reflektiert, speichert und vor dem nächsten Handeln erneut liest. Die Forschung von Shinn et al. (2023) zeigt, dass dieser Mechanismus — Reflektieren, Speichern, Erneutes Lesen — blinde Wiederholungen mit großen Margen übertrifft (über 12 Testdurchläufe hinweg +22% bei Entscheidungsaufgaben, +11% bei Code) und Gedächtnis ohne Reflexion um 8 Punkte übertrifft. Der Gewinn resultiert aus *geschriebenen Gründen*, nicht aus härterem Wiederholen. Das Skill eignet sich besonders für Agenten wie Claude Code, Cursor, Codex und andere KI-Codierungsassistenten, da es mit einem einzigen Befehl installiert oder als Kopieren-und-Einfügen-Prompt verwendet werden kann. Es stellt sicher, dass Agenten aus vergangenen Fehlern lernen, häufige Fehler vermeiden und sich durch strukturierte Reflexion kontinuierlich verbessern, ohne Speicher übermäßig anwachsen zu lassen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add haidrrrry/loop-engineering-skills

In Ihrer bevorzugten KI fragen

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

Dokumentation

Schleifengedächtnis

Reflexion-ähnliches verbales Gedächtnis: Der Agent reflektiert schriftlich über jeden Versuch, speichert die Reflexion und liest vor dem Handeln aktuelle Reflexionen. Forschung (Shinn et al., 2023) zeigt, dass dieser Mechanismus — Reflektieren, Speichern, Erneutes Lesen — blinde Wiederholungen mit großen Margen übertrifft (+22% bei Entscheidungsaufgaben über 12 Testdurchläufe, +11% bei Code) und Gedächtnis ohne Reflexion um 8 Punkte übertrifft. Der Gewinn resultiert aus geschriebenen Gründen, nicht aus härterem Wiederholen.

Das Protokoll

Vor dem Handeln (jede Aufgabe)

  1. Lies .loop/LESSONS.md.
  2. Wende den Abschnitt Standing rules (dauerhafte Regeln) bedingungslos an.
  3. Lies die 3 neuesten Einträge. Wenn einer für die aktuelle Aufgabe relevant ist, gib in einer Zeile an, wie er deine Vorgehensweise ändert. Wenn keiner relevant ist, fahre fort — erzwinge nichts.

Nach dem Handeln (jeder Versuch, bestanden oder fehlgeschlagen)

Füge genau einen Eintrag im Format der Datei hinzu:

## [Datum] — [Aufgabe, max. 5 Wörter] — BESTANDEN|FEHLGESCHLAGEN
- Was passiert ist: [eine Zeile]
- Grundursache / warum es funktioniert hat: [eine Zeile]
- Nächstes Mal: [eine spezifische, überprüfbare Anweisung]

Qualitätsmaßstab für „Nächstes Mal“:

  • ❌ „Sei vorsichtiger mit der Datenbank“ — nicht überprüfbar
  • ✅ „Führe npx prisma migrate deploy vor jedem Seed-Skript aus“ — überprüfbar
  • ❌ „Denke daran, dass die API knifflig ist“ — vage
  • ✅ „Der /users-Endpunkt paginiert bei 50; übergib immer ?page= beim Zählen“

Fehlerreflexion, speziell

Wenn ein Versuch fehlgeschlagen ist, muss die Reflexion beantworten: Was habe ich fälschlicherweise angenommen, das falsch war? Fehlgeschlagene Versuche entstehen meist aus einer falschen Annahme, nicht aus einem Tippfehler. Benenne die Annahme. Das ist die Lektion.

Wartung (wenn die Datei ~30 Einträge überschreitet)

  1. Lies alle Einträge vom ältesten zum neuesten.
  2. Jede Lektion, die 2+ Mal vorkommt, wird in die Standing rules (dauerhafte Regeln) aufgenommen, umgeschrieben als eine einzige imperative Zeile.
  3. Lösche die ältesten 20 Einträge nach der Übernahme.
  4. Lösche niemals dauerhafte Regeln ohne Zustimmung des Benutzers.

Was NICHT gespeichert werden soll

  • Geheimnisse, Schlüssel, Token, persönliche Daten — niemals, selbst wenn sie den Fehler verursacht haben.
  • Erzählungen („Ich habe dann X versucht, woraufhin Y …“) — speichere nur Schlussfolgerungen.
  • Doppelte Lektionen — wenn sie bereits vorhanden sind, füge sie nicht erneut hinzu; erwäge stattdessen ihre Übernahme in die dauerhaften Regeln.
  • Schuldzuweisungen oder Selbstkritik — Lektionen sind Anweisungen, keine Gefühle.

Zu vermeidende Fehlermodi

  • Gedächtnistheater: Einträge schreiben, aber nie lesen. Der Leseschritt ist der Wert; der Schreitschritt allein ist ein Tagebuch.
  • Überanpassung an einen einzelnen Vorfall: Ein einmaliger Umgebungshänger ist keine Lektion. Wenn es nicht wiederkehren kann, zeichne es nicht auf.
  • Unbegrenztes Wachstum: Eine Datei mit 200 Einträgen, die niemand liest, ist totes Gedächtnis. Komprimiere sie.

Verwandte Skills