comprono/dont-x-smart-be-smart-skill

Was macht dont-x-smart-be-smart-skill?

Ein Codex-Skill, der die Projektabsicht bewahrt, Kontextkomprimierung übersteht, wiederholte Fehler stoppt und reale Ergebnisse überprüft.

Übersicht

Dieser Skill hilft, die Konsistenz und Zuverlässigkeit von KI-gestützten Entwicklungsprozessen zu erhalten. Er verhindert, dass der Agent den Kontext verliert, dieselben Fehler immer wieder macht oder Änderungen vornimmt, deren Auswirkungen nicht verifiziert wurden.

Funktionsweise

• Projektabsicht speichern: Eine Datei INTENT.md im Projektstamm hält die übergeordneten Ziele und Architekturentscheidungen fest. Der Agent liest diese Datei bei jedem Schritt, um sicherzustellen, dass er den Rahmen nicht verlässt.
• Fehler blockieren („dont x“): Nach einem Fehlschlag erzeugt der Skill eine DONT.md-Datei (oder einen Abschnitt in der Konfiguration), die die fehlgeschlagene Vorgehensweise beschreibt. Der Agent prüft diese Liste vor weiteren Aktionen, um Wiederholungen zu vermeiden.
• Kontextkomprimierung überstehen: Der Skill speichert den aktuellen Stand (Bearbeitungsanzahl, letzte erfolgreiche Änderung, offene Probleme) in einer .codestate.json-Datei. Bei Kontextneustart kann der Agent diesen Zustand rekonstruieren, ohne von vorne beginnen zu müssen.
• Verifikation realer Ergebnisse: Nach jeder Änderung führt der Skill einen vordefinierten Test- oder Build-Befehl aus (z.B. npm test oder go build). Nur wenn dieser erfolgreich ist, wird die Änderung als abgeschlossen markiert.

Unterstützte Plattformen

Dieser Skill ist primär für Codex entwickelt, kann aber ähnlich auf Claude Code, Cursor oder andere KI-Code-Assistenten übertragen werden.

Verwendung

1. Lege die Datei INTENT.md mit der Projektbeschreibung an.
2. Definiere in einer Konfigurationsdatei (z.B. .skillconfig) die auszuführenden Verifikationsschritte.
3. Starte den Agenten mit dem Skill und interagiere normal.
4. Der Agent liest bei jedem Schritt INTENT.md und DONT.md, aktualisiert .codestate.json und führt Verifikationen aus.

Beispielkonfiguration

{
  "verification_cmd": "npm run build && npm test",
  "intent_file": "INTENT.md",
  "dont_file": "DONT.md",
  "state_file": ".codestate.json"
}

Lizenz

MIT