CommunityRecherche & Datenanalysegithub.com

mohamedzhioua/agent-done-or-not

Erwischt deinen KI-Agenten beim Lügen über „fertig“ – ein einziges Datei-Tor für Claude Code, Cursor und Codex. Es muss nachweisen, bevor es abschließen kann.

Was ist agent-done-or-not?

Dieses Skill verhindert, dass KI-Agenten vortäuschen, eine Aufgabe abgeschlossen zu haben, ohne tatsächlich einen gültigen Nachweis zu liefern. Es integriert sich nahtlos in Claude Code, Cursor und Codex und erzwingt einen dokumentierten Prüfschritt, bevor der Agent seinen Zug beenden darf. Das Prinzip ist einfach: Der Agent muss einen Befehl ausführen, der den Erfolg belegt – z. B. einen Testlauf, einen Build, eine Typüberprüfung oder einen `curl`-Aufruf – und dies über ein sogenanntes Proof-Gate protokollieren. Der Befehl wird zusammen mit Exit-Code und einem SHA-256-Hash der Ausgabe aufgezeichnet; nur bei Exit-Code 0 gilt der Nachweis als bestanden. Ohne frischen, positiven Beleg wird der Zug blockiert. Der Agent muss den Fehler beheben und erneut erfassen, bevor er weitermachen kann. Das Skill eignet sich besonders für Entwickler, die in CI/CD-Pipelines, bei automatisierten Reparaturen oder in agentengestützten Build-Umgebungen sicherstellen möchten, dass Erledigt-Meldungen faktenbasiert und nicht vertrauensbasiert sind.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor
npx skills add mohamedzhioua/agent-done-or-not

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

done-or-not

Wann verwenden

Verwende dieses Skill immer dann, wenn du dem Benutzer mitteilen möchtest, dass eine Aufgabe, ein Build, ein Test, eine Reparatur oder ein Verifikationsschritt abgeschlossen ist. Eine Fertig-Meldung erfordert einen Nachweis durch das Tor, nicht Vertrauen oder Erinnerung.

Wie verwenden

  1. Identifiziere den Befehl, der den Erfolg belegt. Wähle die kleinste Prüfung, die die Behauptung tatsächlich verifiziert: Tests, Build, Typecheck, Lint, ein curl gegen einen laufenden Endpunkt oder einen anderen Befehl mit aussagekräftigem Bestehen/Scheitern-Verhalten.

  2. Führe den verifizierenden Befehl durch das Proof-Gate aus:

    bash done-gate.sh capture --label check -- <dein verifizierender Befehl>
    

    Das Gate zeichnet den Befehl, seinen Exit-Code und einen SHA-256-Hash der Ausgabe auf. Es beendet sich mit dem Exit-Code des Befehls, sodass eine fehlschlagende Prüfung die Aufnahme scheitern lässt.

  3. Melde die Arbeit erst als abgeschlossen, wenn ein frischer BESTANDENER Beleg vorliegt.

  4. Wenn die Prüfung fehlschlägt, behebe das Problem und nimm erneut auf. Melde niemals Erfolg auf eine rote Prüfung.

Das Stop-Gate erzwingt diese Regel, wo die Umgebung es unterstützt: Es blockiert den Agenten daran, den Zug zu beenden, bis ein frischer bestandener Beleg vorliegt. Umgehe das Gate nicht; erstelle den Nachweis.

Verwandte Skills