CommunityCodierung & Entwicklunggithub.com

proof-it-works

Beweist, dass eine Änderung tatsächlich funktioniert, bevor sie als abgeschlossen gemeldet wird; treibt die echte Oberfläche an, erfasst reproduzierbare Beweise und schlägt fehl, wenn Beweise fehlen.

Was ist proof-it-works?

Das Skill **Proof It Works** fungiert als harte Qualitätsschwelle für KI-Agenten: Eine Aufgabe darf erst dann als 'erledigt' gelten, wenn reproduzierbare, maschinell prüfbare Beweise vorliegen. Es unterstützt die Profile FEATURE (Änderung des Laufzeitverhaltens und Fehlerbehandlung), DESIGN (Nachweis, dass Spezifikationen implementiert wurden) und DATAFLOW (Nachweis von Datenbewegungen durch mehrere Stufen). Der Agent erstellt dazu einen Beweisordner `.proof/`, formuliert Akzeptanz-Assertionen in einer achtspaltigen Tabelle und erfasst die Beweise durch echte Aufrufe der Anwendung (z. B. curl, Browser DevTools, Screenshots). Ein zentraler Bestandteil ist der 'Reverse Case': Es muss gezeigt werden, dass die Änderung vor der Implementierung fehlschlug und nach der Implementierung korrekt funktioniert. Die Ausgabe ist ein standardisierter Bericht nach einer Vorlage, der über Bestehen oder Fehlschlagen entscheidet. Das Skill setzt auf Plattformen wie Claude Code, Cursor oder Codex an und verhindert, dass KI-Agenten Änderungen als abgeschlossen melden, die nur im Code 'gut aussehen' oder theoretisch funktionieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/fan56/skills/tree/main/public/proof-it-works

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

Anweisungen für KI-Agenten:

Beweise, dass es funktioniert (Proof It Works)

Dieses Skill trifft eine Entscheidung: ob Arbeit als abgeschlossen bezeichnet werden darf. Es ist eine harte Hürde, kein Ratschlag.

1. Kerngesetz: Erledigt = Bewiesen

  • Eine Behauptung ist kein Beweis. Nur ein reproduzierbares Artefakt, das ein zweiter Agent prüfen kann, zählt.
  • Du darfst nicht "erledigt", "behoben", "bestanden" oder "ausgeliefert" sagen, während ein erforderliches Hürdenelement aus Abschnitt 6 fehlt.
  • "Sollte funktionieren", "sieht richtig aus", "theoretisch in Ordnung" und "kompiliert" sind keine Abschlusszustände.
  • Wenn ein Beweis unmöglich ist, erkläre NICHT VERFÜGBAR/BLOCKIERT (Abschnitt 7) – niemals BESTANDEN. Eine schriftliche Freigabe durch den Benutzer kann einen FEHLER als FEHLER-FREIGEGEBEN schließen (Abschnitt 7). Eine maschinell nicht testbare Dimension kann auf BENUTZER-AUSSTEHEND bleiben und bei Zustimmung des Benutzers (Abschnitt 7) als BESTANDEN-DURCH-BENUTZER schließen. Diese drei – FEHLER-FREIGEGEBEN, BENUTZER-AUSSTEHEND, BESTANDEN-DURCH-BENUTZER – sind die einzigen Ausgänge ohne maschinellen Beweis; keiner davon ist BESTANDEN.
  • Beweise müssen aus dem Arbeitsbaum und dem im Bericht genannten Änderungs-Commit stammen (Abschnitt 3, Änderungsreferenz); veraltete Artefakte sind ungültig.
  • Dieses Skill beschränkt sich auf Arbeiten mit einer Laufzeitoberfläche oder einem Design-Ergebnis. Für diese Arbeit ersetzt sein minimaler Beweissatz (ein positiver + einer negativ) jegliche leichteren Prüfungen, nicht, dass sie hinzugefügt werden. Arbeiten ohne Laufzeitoberfläche sind nicht erfasst und dieses Skill gibt vollständig nach. Es überschreibt keine Auslieferung, die der Benutzer bereits als minimal akzeptiert hat.

2. Beweisstufen

Drei Stufen in strenger Reihenfolge: Behauptung (verbal oder durch Argumentation, null Beweise) < Artefakt (ein echtes rohes Artefakt aus der Oberfläche dieser Aufgabe) < Artefakt + Gegenfall. Die Hürde akzeptiert nur die letzten beiden; welche ein Element benötigt, wird durch die Hürdenelemente des ausgewählten Profils festgelegt, nicht durch eine globale Regel. Eine Behauptung unterstützt niemals BESTANDEN, und kein Element darf höher eingestuft werden, als es tatsächlich ist.

3. Bindung / 任务绑定

  • Am Anfang von bericht.md zitiere wörtlich den Satz aus der Anfrage des Benutzers, der das Akzeptanzziel definiert – eine Anweisung wie "ändere X zu Y und beweise es" zählt; sie muss nicht sagen, dass die Arbeit erledigt ist. Beschrifte es mit Akzeptanzziel (Benutzer wörtlich). Nur wenn die Anfrage überhaupt kein Akzeptanzziel definiert (sie sagt nie, wie "erledigt" aussehen muss), schreibe dies in einer Zeile, bitte den Benutzer, eines zu nennen, und stoppe – es gibt nichts zu beschränken. Die Beweisstufe Behauptung in Abschnitt 2 ist ein separates Konzept und behält ihren Namen.
  • Änderungsreferenz (Berichtskopf) = der Commit, der die zu testende Änderung enthält – nicht der Commit, der diesen Bericht hinzufügt, und nicht unbedingt HEAD. Ohne Git verwende sha256 der geänderten Dateien + Dateiliste anstelle eines Hashes. Nachdem der Bericht committed wurde, bewegt sich HEAD weiter; das ist normal, und der Prüfer beurteilt anhand von Änderungsreferenz, nicht von HEAD.
  • Arbeitsbaum (Berichtskopf) ist Freitext, kein Zwei-Werte-Enum, z. B. tracked clean; .proof/ untracked.
  • Erkläre die Dateien / Funktionen / Routen / Komponenten, die diese Änderung berührt hat, aus dem aktuellen Diff.
  • Jedes ausgewählte Profil muss mindestens ein Beweiselement haben, das auf diesem Diff landet (einen berührten Pfad ausführt oder prüft). Beweise, die nichts im Diff berühren = FEHLER, selbst wenn alle Artefakte existieren.
  • Eine DESIGN-Grundlinie muss eine externe Quelle haben (Abschnitt 6, proof-profiles.md); eine nicht nachvollziehbare Grundlinie ist eine Behauptung und scheitert an ihrem Hürdenelement.

4. Beweisprofil(e) auswählen

Wähle das Profil, dessen Einzeiler-Test am besten zum Satz des Akzeptanzziels des Benutzers passt; eine Aufgabe kann gleichzeitig DESIGN und FEATURE sein und muss dann beide erfüllen. Wenn kein Profil passt, schreibe dies in einer Zeile und stoppe – erzwinge kein Profil für eine Änderung ohne Laufzeitoberfläche.

ProfilEinzeiler-TestDetail
DESIGNDu hast eine Spezifikation, ein Layout, eine Interaktion, eine Architektur oder einen Vertrag erstellt, der als implementiert gezeigt werden muss, nicht nur als vorgeschlagen.referenzen/proof-profiles.md
FEATUREDu hast das Laufzeitverhalten geändert und musst zeigen, dass es funktioniert und dass schlechte Eingaben abgelehnt werden.referenzen/proof-profiles.md
DATAFLOWEin Wert durchläuft mehrere Stufen (Eingabe, Transformation, Persistenz, Ausgabe) und jeder Sprung muss gezeigt werden.referenzen/proof-profiles.md
  • "Wurde mein Design implementiert" -> DESIGN. "Funktioniert das" -> FEATURE. "Wohin sind die Daten gegangen / werden sie gespeichert" -> DATAFLOW.

5. Ausführungsablauf

In dieser Reihenfolge ausführen. Nicht überspringen oder umordnen.

  1. Erstelle .proof/<aufgabenname>/ im Repository (kurzer Kebab-Case-Name). Ein Artefakt ist kein Beweis, bis es eine Datei hier ist.
  2. Schreibe 3–7 Akzeptanz-Assertionen in bericht.md, BEVOR Beweise gesammelt werden. Verwende die 8 Spalten id | assertion | erwartet | bestandens-kriterium (prüfbar) | geänderter_pfad (datei:funktion/route) | erforderliche_stufe | beweis_datei | hängt_ab_von. Verbiete "sieht korrekt aus", "scheint in Ordnung", "funktioniert wie erwartet"; verwende prüfbare Bedingungen wie "HTTP 200 mit body.field X = Y", "Rechteckbreite = 120px", "ungültiger Token gibt 401 zurück".
    • erwartet ist das vorhergesagte Ergebnis, das VOR jeglichen Beweisen ausgefüllt wird (z. B. 401 + BAD_CREDENTIALS, rect width 240px); FEATURE/DATAFLOW müssen es in jeder Zeile ausfüllen, DESIGN darf n/a schreiben. Notiere die Registrierungszeit im Berichtskopf als Erwartet registriert (UTC): <zeit> – die Vorregistrierung ist selbst erklärt; kein Hash oder On-Disk-Ritual.
    • erwartet und bestandens-kriterium sind zwei Ausdrücke einer Bedingung (Vorhersage vs. entscheidbare Prüfung). Sie dürfen nicht widersprüchlich sein; eine widersprüchliche Zeile muss VOR der Sammlung korrigiert werden. Der Status wird einzig durch das bestandens-kriterium gegen beobachtet entschieden. Wenn beobachtet das Kriterium erfüllt, aber von erwartet abweicht, korrigiere die Implementierung, um sie an erwartet anzupassen, oder markiere die Assertion als FEHLER – schreibe niemals erwartet auf den beobachteten Wert um (Abschnitt 8).
    • Fülle geänderter_pfad mit der Datei/Funktion/Route, die die Assertion ausübt; schreibe n/a nur für DESIGN-Zeilen, die keinen Codepfad ausführen. Mindestens eine Assertion muss einen Codepfad ausführen, der in diesem Diff geändert wurde, und ihn benennen; eine Assertion auf einem unberührten Pfad bindet nicht. FEATURE/DATAFLOW müssen mindestens eine nicht-n/a-Zelle in geänderter_pfad haben; DESIGN darf n/a verwenden.
    • hängt_ab_von = kommagetrennte Liste der Voraussetzungs-IDs (leer, wenn keine), in topologischer Reihenfolge gesammelt. Eine Voraussetzung gilt nur dann als erfüllt, wenn ihr Status BESTANDEN oder BESTANDEN-DURCH-BENUTZER ist; wenn sie etwas anderes ist, ist die nachgelagerte Zeile NICHT AUSGEFÜHRT (Abschnitt 7) und ein NICHT AUSGEFÜHRT führt dazu, dass die Hürde FEHLER ist. Der hängt_ab_von-Graph muss azyklisch sein – ein Zyklus ist FEHLER. Eine BENUTZER-URTEIL-Zeile ist ein Blatt: Keine Zeile darf eine BENUTZER-URTEIL-ID in hängt_ab_von aufführen.
  3. Treibe die echte Oberfläche mit tatsächlich auf diesem Rechner verfügbaren Befehlen an (z. B. npm run dev zum Starten, curl -i -X POST http://localhost:3000/login -d '{"user":"a","pass":"wrong"}' für die API, einen echten Browser + DevTools für die Benutzeroberfläche, tail -f für Logs). Speichere rohe stdout/stderr/Antwort/Screenshot in nummerierten Dateien (Abschnitt 11). roh = die vollständige Ausgabe wie erfasst, nicht zusammengefasst, auszugsweise oder neu geordnet; Desensitivierung ist eine einmalige Transformation zum Zeitpunkt der Erfassung, daher verstößt sie nicht gegen "roh". Ersetze Tokens / Passwörter / Schlüssel in der gespeicherten Datei mit *** und notiere im Beweisindex und neben jedem eingefügten Rohblock geschwärzt: <feldname> (N Vorkommen) sowie den sha256 der Datei, damit ein Prüfer bestätigen kann, dass keine Nachbearbeitung stattgefunden hat. Schwärze niemals Statuscodes, Fehlercodes oder Werte, von denen eine Assertion abhängt. Jeder <startbefehl> / <screenshot-tool>-Platzhalter im Bericht = FEHLER; ersetze ihn mit dem genauen Befehl, den du ausgeführt hast.
  4. Gegenfall ZUERST. Definiere "ein geändertes Verhalten" als jeden hinzugefügten oder geänderten Zweig im Diff (ein if/else, Guard, Validierung oder neue Route); liste jeden im Bericht auf und gib jedem eine Zeile in der Assertionstabelle. Ein Grenzfall ist entscheidbar: Dieselbe Eingabe wird in der Implementierung vor der Änderung akzeptiert (oder verhält sich anders) und nach der Änderung abgelehnt (oder verhält sich korrekt). Erfasse die Grundlinie vor der Änderung durch Rekonstruktion des Originals – git stash, einen Arbeitsbaum/Checkout des Commits vor der Änderung oder eine gespeicherte Kopie der Originaldatei – gib die Methode im Bericht an, führe denselben Befehl darauf aus und speichere das Ergebnis als 00-pre-change.log (Abschnitt 11). Diese "zeige, dass es vor der Änderung fehlschlagen würde"-Stufe ist die Grundlinie des Gegenfalls, niemals eine endgültige FEHLER-Assertionszeile (Abschnitt 9). Dann führe für jedes geänderte Verhalten einen Gegenfall aus (falsche Eingabe, fehlende Berechtigung, Grenzwert, entfernte Vorbedingung) und notiere, dass er auf die erwartete Weise fehlschlägt. Ein schlechter Fall, der auch vor der Änderung fehlschlug, zählt nicht. Wenn der Fall nach der Änderung akzeptiert wird, liegt der Test nicht auf dem echten Pfad; korrigiere und sammle erneut.
  5. Datenfluss: Schreibe VOR der Sammlung eine Zeile der erwarteten Transformation in bericht.md (Eingabeform -> Ausgabeform) und verweise darauf an jedem Sprung. Erfasse dann ein echtes Beispiel pro Sprung – Eingabe -> Zwischenstufe -> Persistenz -> Ausgabe – mit derselben korrelierenden ID. Für die Persistenz füge die echte Leseabfrage und ihre rohe Rückgabe ein; das erneute Ausdrucken des geschriebenen Wertes ist kein Snapshot. Erfasse auch die Grundlinie vor der Änderung für den Gegenfall gemäß Schritt 4 (00-pre-change.log): Sie muss zeigen, dass der abgelehnte Wert vor der Änderung die Ausgabe erreichte.
  6. DESIGN-Beobachtungswerte müssen aus mechanisch erfassten Quellen stammen (berechnete Style-JSON, getBoundingClientRect, DOM textContent, CDP-Ausgabe), die als Dateien gespeichert werden; lies keine Zahlen aus einem Screenshot mit dem Auge ab. Die Grundlinie muss eine numerische Toleranz angeben (pro Seite <=2px, pro Kanal <=8); Überschreitung = FEHLER. Ein Screenshot dient nur der menschlichen Überprüfung, niemals als numerische Quelle.
  7. Schreibe den Bericht aus der Vorlage referenzen/bericht-vorlage.md; kopiere sie, erfinde kein Format. Behalte nur die für das ausgewählte Profil relevanten Abschnitte und lösche nicht zutreffende Abschnitte vollständig – das Löschen verstößt nicht gegen "kopiere sie, erfinde kein Format".
  8. Hürde beurteilen (Abschnitt 6): BESTANDEN nur, wenn jedes erforderliche Element auf der erforderlichen Stufe existiert, jede nicht-BENUTZER-URTEIL-Assertion BESTANDEN/BESTANDEN-DURCH-BENUTZER ist, mindestens eine Assertion ein maschinelles Urteil trägt und es keinen hängt_ab_von-Zyklus gibt; sonst FEHLER, NICHT VERFÜGBAR/BLOCKIERT oder BENUTZER-AUSSTEHEND (Abschnitt 7). Hürde und Ergebnis verwenden denselben Enum und müssen identisch sein.

6. Harte Hürde (Fehlen eines Elements = FEHLER)

"Erledigt" erfordert, dass jedes Kästchen angehakt ist. Eine fehlende Datei, ein fehlender Gegenfall, ein Mock auf dem echten Pfad oder Beweise außerhalb des Diffs sind unabhängig von der Erzählung FEHLER.

  • Vollständigkeit (keine unbekannten Elemente): Der Bericht gibt die Gesamtzahl der Assertionen N an und listet für jede der N Assertionen einen Status auf. Die einzigen zulässigen Status sind BESTANDEN | FEHLER | NICHT AUSGEFÜHRT | NICHT VERFÜGBAR | BLOCKIERT | BENUTZER-URTEIL | BESTANDEN-DURCH-BENUTZER. Ein leerer Status, ein Status außerhalb dieser Menge oder eine aufgeführte Anzahl, die von N abweicht, ist FEHLER. BESTANDEN erfordert, dass jede nicht-BENUTZER-URTEIL-Zeile BESTANDEN/BESTANDEN-DURCH-BENUTZER ist und es kein FEHLER/NICHT AUSGEFÜHRT/NICHT VERFÜGBAR/BLOCKIERT gibt.
  • BENUTZER-URTEIL ist nur für eine Dimension ohne entscheidbares maschinelles Kriterium zulässig. Wenn eine Maschine die Zeile beurteilen kann oder sie beurteilt hat und die Bedingung nicht gilt, ist ihr Status das maschinelle Urteil (BESTANDEN/FEHLER) – niemals BENUTZER-URTEIL. Alles, was eine Maschine messen kann, muss eine eigene Zeile mit einem maschinellen Urteil sein. Die an diesen Diff gebundene Assertion (Abschnitt 3) darf niemals BENUTZER-URTEIL sein. Ein Bericht, dessen jede Assertion BENUTZER-URTEIL ist, hat eine vakuumwahre BESTANDEN-Bedingung und ist FEHLER: Mindestens eine Zeile muss ein maschinelles Urteil tragen. Maschinell getestet und das Kriterium nicht erfüllt = FEHLER, nicht BENUTZER-URTEIL.
  • hängt_ab_von ist ein DAG: Ein Zyklus ist FEHLER. Eine Voraussetzung ist nur durch BESTANDEN oder BESTANDEN-DURCH-BENUTZER erfüllt; keine Zeile darf von einer BENUTZER-URTEIL-Zeile abhängen, daher sind solche Zeilen Blätter.
  • Global: Bindung besteht (Abschnitt 3), mindestens eine Assertion bindet an den Diff (Abschnitt 5 Schritt 2); eine BENUTZER-URTEIL-Zeile zählt niemals als BESTANDEN und blockiert niemals das BESTANDEN eines anderen Elements.
ProfilMindestbeweissatz — alle erforderlich
DESIGN(a) Grundlinienartefakt mit externer Quelle: vorher existierende Designdatei + erstellender Commit, oder die wörtliche Nachricht des Benutzers, die es enthält/genehmigt, oder eine Spezifikationstabelle, die als Grundliniendatei abgelegt wurde, bevor eine Implementierungsdatei existierte, mit dem festgelegten Meta-Block (quellentyp, quelle_zitat_oder_pfad, erfasst_um_utc, sha256, grundlinie_methode) zum Zeitpunkt der Ablage; das Rückentwickeln von Werten aus der Implementierung in die Grundlinie ist verboten; (b) echter Rendering-Screenshot beim Änderungs-Commit; (c) Vergleich von Größe, Farbe, Abstand, Text, Zustand für jedes im Rahmen liegende Element (Rahmen = jedes im Design-Ergebnis genannte Element; list ausgeschlossene Elemente und warum auf), jede Zeile mit Grundlinienwert und einem mechanisch erfassten beobachteten Wert, mit numerischer Toleranz (<=2px pro Seite, <=8 pro Kanal) in der Grundlinie angegeben; (d) ein Gegenelement mit einem Wert AUF der Toleranzgrenze (z. B. 243px für eine 240px-Spezifikation bei +/-2), gezeigt als abwesend/nicht übereinstimmend durch rohe Ausgabe; (e) Spezifikationslücken explizit erklärt: Interpretation (Grundlinienlesung vor der Implementierung geschrieben, fügt nur Position/Zuordnung hinzu, widerspricht niemals einem Benutzerwert), Ausgeschlossen (kein Grundlinienwert vorhanden, wörtlich geschrieben), NICHT VERFÜGBAR (Wert vorhanden, aber hier nicht messbar) — Ausgeschlossen und NICHT VERFÜGBAR in separaten Berichtsabschnitten, keine stillen Auslassungen; (f) >=1 Beweiselement auf dem Diff.
FEATURE(a) ein echtes gesteuertes I/O-Transkript, das einen geänderten Codepfad beim Änderungs-Commit ausführt; (b) ein Gegenfall pro geändertem Verhalten, seine ungültige Eingabe auf der entscheidbaren Grenze (vor der Änderung akzeptiert/anders, nach der Änderung abgelehnt/korrekt), gestützt durch eine Grundlinie vor der Änderung 00-pre-change.log und rohe Ausgabe, die die korrekte Ablehnung zeigt — Fälle, die auch vor der Änderung fehlschlugen, zählen nicht; (c) genauer Befehl/Aktion und Änderungsreferenz notiert; (d) jede Assertion einer Datei mit einem ausgefüllten geänderter_pfad zugeordnet, und >=1 Assertion führt den geänderten Pfad aus und nennt die geänderte Datei/Funktion/Route; (e) kein Mock/Stub als Ersatz für die Kette; (f) >=1 Beweiselement auf dem Diff.
DATAFLOW(0) Erwartete Transformationszeile (Eingabeform -> Ausgabeform) vor der Sammlung geschrieben und an jedem Sprung referenziert; (a) ein Snapshot pro Sprung (Eingabe, Zwischenstufe, Persistenz, Ausgabe) mit derselben Korrelations-ID; (b) Persistenz-Snapshot fügt die echte Leseabfrage + rohe Rückgabe aus dem Speicher ein, kein erneuter Ausdruck des geschriebenen Werts; (c) Grundlinie vor der Änderung für den Gegenfall gemäß Schritt 4 (00-pre-change.log), die zeigt, dass der abgelehnte Wert vor der Änderung die Ausgabe erreichte; (d) jeder Sprung bezieht sich auf die erwartete Transformationszeile; (e) mindestens ein Beweiselement auf dem Diff (Abschnitt 5 Schritt 2: nicht alle n/a).

7. Status-Lexikon & Ausgänge

StatusBedeutungWann verwendenZulässig für PASS-Bedingung?
BESTANDENDie Assertion ist maschinell bestanden. Erfüllt das bestandens-kriterium und beobachtet entspricht erwartet (Abschnitt 5 Schritt 2).Maschine hat entschieden und bestanden.Ja
FEHLERDie Assertion ist maschinell fehlgeschlagen.Maschine hat entschieden und fehlgeschlagen.Nein; blockiert die Hürde.
NICHT AUSGEFÜHRTEine Voraussetzung ist nicht erfüllt; die Zeile wurde nicht ausgeführt.Voraussetzung (hängt_ab_von) ist FEHLER/NICHT AUSGEFÜHRT/NICHT VERFÜGBAR/BLOCKIERT/BENUTZER-URTEIL.Nein; ein NICHT AUSGEFÜHRT = FEHLER der Hürde.
NICHT VERFÜGBARDas Beweiselement kann nicht erfasst werden (z. B. kein Browser für einen Screenshot, Netzwerk nicht erreichbar, kein realer Datenspeicher).Wenn die Maschine das Beweiselement unmöglich machen kann. Einzelne Assertion; nicht die ganze Hürde.Nur erlaubt für einzelne Assertionen; jede NICHT VERFÜGBAR-Assertion blockiert die PASS-Bedingung der Hürde.
BLOCKIERTDie Assertion ist durch eine externe Abhängigkeit blockiert (z. B. fehlende Berechtigung, Dienst ausgefallen, keine Lizenz).Wenn eine externe Abhängigkeit die Erfassung verhindert; unterscheidet sich von NICHT VERFÜGBAR (NICHT VERFÜGBAR = Werkzeug fehlt; BLOCKIERT = Werkzeug vorhanden, aber nicht nutzbar).Nein; blockiert die PASS-Bedingung der Hürde.
BENUTZER-URTEILDie Assertion hat KEIN entscheidbares maschinelles Kriterium und erfordert menschliches Urteil.Nur für Dimensionen ohne maschinelles Kriterium. Niemals für den an den Diff gebundenen Beweiseintrag.Ja, für einzelne Zeilen, aber die Hürde erfordert >=1 Zeile mit maschinellem Urteil (Abschnitt 6); ein Bericht mit nur BENUTZER-URTEIL = FEHLER.
BESTANDEN-DURCH-BENUTZERDie Assertion wurde vom Benutzer als bestanden überprüft, nachdem eine BENUTZER-URTEIL-Zeile vorgelegt wurde.Nur nachdem der Benutzer sie explizit genehmigt hat.Ja
FEHLER-FREIGEGEBENDie Assertion ist FEHLER, wurde aber durch eine schriftliche Benutzerfreigabe freigegeben.Wenn die Assertion fehlschlägt, der Benutzer sie aber explizit freigegeben hat (Abschnitt 1).Ja, nur als Ersatz für eine FEHLER-Zeile, wenn sie durch Benutzerfreigabe ersetzt wird.
BESTANDEN-VAKUUMWAHRDie Assertion hat ein leeres bestandens-kriterium oder eine leere beobachtet-Zelle, und das System hat sie nicht ausgeführt (z. B. verwaiste Aufgabe).Nur zulässig, wenn die Hürde für diese Aufgabe nicht ausgelöst wurde (z. B. keine Beweiserfassung durchgeführt).Nein; signalisiert eine nicht ausgeführte Hürde.

8. Die erwartet/beobachtet-Lücke erzwingen

Assertion muss bestanden werden, wie erwartet aufgezeichnet wurde. Eine Zeile, bei der beobachtet das bestandens-kriterium erfüllt, aber nicht dem erwartet entspricht, ist entweder ein Rückschritt im Verhalten (schlecht) oder ein Versehen (schlecht). In keinem Fall darfst du erwartet so bearbeiten, dass es mit beobachtet übereinstimmt. Korrigiere stattdessen die Implementierung, um sie an erwartet anzupassen. Wenn du erwartet nicht korrigieren kannst, markiere die Assertion als FEHLER.

9. Gegenfall Grundlinie und Null-Status

Die Grundlinie vor der Änderung (00-pre-change.log) ist eine Ausführungsaufzeichnung, keine Assertionszeile. Sie erscheint in keinem Status, und sie trägt keinen Assertions- oder Hürdenstatus. Wenn die Grundlinie nicht erfasst werden kann (z. B. keine vorherige Version des Codes, keine Möglichkeit zum Wiederherstellen), ersetze sie nicht mit einem Platzhalter; melde stattdessen den Gegenfall als NICHT VERFÜGBAR. Jede Assertion, deren einziger Beweis die Grundlinie vor der Änderung ist, hat einen leeren Beweis und ist FEHLER, selbst wenn die Grundlinie korrekte Ablehnung zeigt. Die Gegenfall-Assertion muss ihre eigene rohe Ausgabe der Ablehnung NACH der Änderung enthalten.

10. Dateibenennungskonvention

Das Beweisverzeichnis .proof/<aufgabenname>/ muss diese benannten Dateien enthalten:

DateinameZweck
bericht.mdDer endgültige Bericht aus der Vorlage.
00-pre-change.logAusgabe der Grundlinie vor der Änderung (Zeigt, dass der Eingabewert vor der Änderung akzeptiert/anders wurde).
01-assertion-<id>-raw.logRohe Ausgabe für Assertion <id> (z. B. 01-assertion-A1-raw.log).
02-screenshot-<beschreibung>.pngScreenshot für DESIGN-Assertionen.
99-metadaten.jsonMetadaten (nicht erforderlich, aber nützlich für Referenz).

11. Rohe Beweiserfassung

  • Roh: Die Ausgabe MUSS der vollständige, unbearbeitete Text (oder die Bilddatei) sein, wie er vom Befehl oder Tool erzeugt wurde. Keine Zusammenfassung, kein Auszug, keine Neuordnung. (Erlaubte Transformation: Einmalige Desensitivierung von Tokens/Passwörtern/Schlüsseln zum Zeitpunkt der Erfassung, wie in Abschnitt 5 Schritt 3 beschrieben.)
  • Umfang: Save stdout, stderr (wenn getrennt), HTTP-Status und Body aus API-Aufrufen, Konsolenausgabe aus Browsertests.
  • Bildschirmfotos: DESKTOP: Vollbild (kein Teil-Fenster), mit sichtbarer Adressleiste. MOBIL: Responsive-Modus mit Device-Chrome. Speichere als PNG. Benenne mit beschreibendem Namen (z. B. 02-screenshot-login-form.png).

12. Hürden-Evaluierung (Abschnitt 6 endgültig)

Nachdem der Bericht geschrieben ist, wende Abschnitt 6 auf den Bericht an. Jede fehlende Spalte in der Assertionstabelle -> FEHLER. Jedes fehlende Beweiselement -> FEHLER. Jede BENUTZER-URTEIL-Assertion, die maschinell prüfbar ist -> FEHLER. Ein Zyklus in hängt_ab_von -> FEHLER. Mindestens eine Assertion muss an den Diff gebunden sein (nicht-n/a geänderter_pfad), sonst -> FEHLER. Jede Assertion mit erwartet aber leerem beobachtet -> FEHLER (außer NICHT VERFÜGBAR/BLOCKIERT/BENUTZER-URTEIL).

Endgültiges Urteil: BESTANDEN oder FEHLER

  • BESTANDEN: Jedes erforderliche Element in Abschnitt 6 vorhanden, jede nicht-BENUTZER-URTEIL-Assertion ist BESTANDEN/BESTANDEN-DURCH-BENUTZER/FEHLER-FREIGEGEBEN, mindestens eine Assertion trägt ein maschinelles Urteil (BESTANDEN/FEHLER), kein hängt_ab_von-Zyklus.
  • FEHLER: Einer der obigen Zustände trifft zu. Die Hürde und das Ergebnis des Berichts müssen identisch sein.

Ausnahmen (Abschnitt 1):

  • NICHT VERFÜGBAR/BLOCKIERT: Wenn die Beweiserfassung unmöglich ist, KEIN BESTANDEN-"Schlupf".
  • FEHLER-FREIGEGEBEN: Wenn der Benutzer eine schriftliche Freigabe für einen FEHLER-Zustand gibt.
  • BENUTZER-AUSSTEHEND/BESTANDEN-DURCH-BENUTZER: Nur für eine maschinell nicht testbare Dimension, die der Benutzer akzeptiert hat.

13. Berichtsvorlage (referenzen/bericht-vorlage.md)

Kopiere diese Vorlage. Lösche nicht zutreffende Abschnitte vollständig.

# Beweisbericht: <Aufgabenname>

## Berichtskopf

- **Akzeptanzziel (Benutzer wörtlich)**: <Zitiere den Satz, der definiert, was "erledigt" bedeutet>
- **Änderungsreferenz**: <Commit-Hash oder sha256+Dateiliste>
- **Arbeitsbaum**: <Zustand des Arbeitsbaums, z.B. "tracked clean; .proof/ untracked">
- **Ausgewähltes Profil**: <DESIGN | FEATURE | DATAFLOW>
- **Erwartet registriert (UTC)**: <Zeitstempel der Vorregistrierung>

## Geänderte Oberfläche

- **Berührte Dateien**: <Dateiliste aus dem Diff>
- **Berührte Funktionen/Routen/Komponenten**: <Liste aus dem Diff>

## Akzeptanz-Assertionen

| id | assertion | erwartet | bestandens-kriterium (prüfbar) | geänderter_pfad (datei:funktion/route) | erforderliche_stufe | beweis_datei | hängt_ab_von | beobachtet | status |
|----|-----------|----------|--------------------------------|----------------------------------------|---------------------|--------------|--------------|------------|--------|
| D1 | Assertion 1 | <Erwarteter Wert> | <Prüfbare Bedingung> | <datei:funktion> | ARTEFAKT | 01-assertion-D1-raw.log | - | <Erfasster Wert> | BESTANDEN |
| D2 | Assertion 2 | <Erwarteter Wert> | <Prüfbare Bedingung> | <datei:funktion> | ARTEFAKT+ | 01-assertion-D2-raw.log | D1 | <Erfasster Wert> | BESTANDEN |

*Anmerkung: Spalte "beobachtet" wird nach der Erfassung in die Tabelle eingefügt; "status" wird nach der Bewertung eingefügt.*

### Assertionsdetails (optional)

**Assertion D1**: <Erklärung dessen, was getestet wird und warum>
- Beweise: `01-assertion-D1-raw.log` (rohe Ausgabe des Befehls oder Tools)
- Beobachtet: <Zusammenfassung des beobachteten Werts, wenn nötig>

## Beweiserfassung

### Schritt 1: Grundlinie vor der Änderung

**Befehl**: `<genauer Befehl>`
**Methode**: `<git stash | Worktree-Checkout | gespeicherte Kopie>`
**Ergebnis**: `00-pre-change.log` zeigt, dass der Eingabewert vor der Änderung akzeptiert/sich anders verhielt.

### Schritt 2: Gegenfälle (schlechte Eingaben)

**Assertion(s)**: <Liste der betroffenen IDs>
**Befehl**: `<genauer Befehl für jeden Fall>`
**Ergebnis**: `01-assertion-*-raw.log` zeigt korrekte Ablehnung.

### Schritt 3: Positive Fälle (gute Eingaben)

**Assertion(s)**: <Liste der betroffenen IDs>
**Befehl**: `<genauer Befehl>`
**Ergebnis**: `01-assertion-*-raw.log` zeigt erwartete erfolgreiche Ausführung.

## Hürden-Ergebnis

- **Hürde**: <BESTANDEN | FEHLER | FEHLER-FREIGEGEBEN | NICHT VERFÜGBAR/BLOCKIERT>
- **Ergebnis**: <BESTANDEN | FEHLER | FEHLER-FREIGEGEBEN | NICHT VERFÜGBAR/BLOCKIERT>
- **Maschinelles Urteil vorhanden**: <Ja/Nein>

### Zusammenfassung

- Assertionen insgesamt: <N>
- BESTANDEN: <Anzahl>
- FEHLER: <Anzahl>
- NICHT AUSGEFÜHRT: <Anzahl>
- NICHT VERFÜGBAR/BLOCKIERT: <Anzahl>
- BENUTZER-URTEIL: <Anzahl>
- BESTANDEN-DURCH-BENUTZER: <Anzahl>
- FEHLER-FREIGEGEBEN: <Anzahl>

### Spezifikationslücken (nur DESIGN)

**Interpretation**: <Grundlinienwerte, die durch Interpretation hinzugefügt wurden, nicht aus externer Quelle>
**Ausgeschlossen**: <Elemente ohne Grundlinienwert, wörtlich>
**NICHT VERFÜGBAR**: <Werte, die vorhanden, aber nicht messbar sind>

## Abschließender Kommentar

<Optionaler Kommentar zur Einschränkung oder zum Kontext>

14. Fehlerbehebung

ProblemAktion
Kein Browser für ScreenshotVerwende puppeteer headless oder playwright screenshot, oder erkläre NICHT VERFÜGBAR für die Assertion.
npm run dev schlägt fehlKorrigiere die Abhängigkeiten zuerst; wenn unmöglich, erkläre BLOCKIERT.
Kein Netzwerk für API-TestsVerwende curl localhost (oder Docker-IP) oder erkläre NICHT VERFÜGBAR.
git nicht verfügbarVerwende sha256 der geänderten Dateien + Dateiliste anstelle von Commit-Hash.
00-pre-change.log nicht erfassbar (keine vorherige Version)Erkläre den Gegenfall als NICHT VERFÜGBAR; keine Grundlinie erforderlich, aber der Gegenfall muss dennoch korrekte Ablehnung nach der Änderung zeigen.
Mehrere Profile auf eine Aufgabe angewandtBeide Profile in der Hürde evaluieren; jedes muss seinen Mindestbeweissatz erfüllen.
Benutzer fordert "Beweise" an, aber der Umfang ist unklarFrage zur Klärung, bevor du fortfährst (Abschnitt 3).

Referenzen

  • proof-profiles.md (im Ordner referenzen/ dieses Repos)
  • bericht-vorlage.md (im Ordner referenzen/ dieses Repos)

Verwandte Skills