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.mdzitiere 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 mitAkzeptanzziel (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 BeweisstufeBehauptungin 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 verwendesha256 der geänderten Dateien + Dateilisteanstelle 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
Behauptungund 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.
| Profil | Einzeiler-Test | Detail |
|---|---|---|
| DESIGN | Du 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 |
| FEATURE | Du hast das Laufzeitverhalten geändert und musst zeigen, dass es funktioniert und dass schlechte Eingaben abgelehnt werden. | referenzen/proof-profiles.md |
| DATAFLOW | Ein 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.
- Erstelle
.proof/<aufgabenname>/im Repository (kurzer Kebab-Case-Name). Ein Artefakt ist kein Beweis, bis es eine Datei hier ist. - Schreibe 3–7 Akzeptanz-Assertionen in
bericht.md, BEVOR Beweise gesammelt werden. Verwende die 8 Spaltenid | 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".erwartetist 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 darfn/aschreiben. Notiere die Registrierungszeit im Berichtskopf alsErwartet registriert (UTC): <zeit>– die Vorregistrierung ist selbst erklärt; kein Hash oder On-Disk-Ritual.erwartetundbestandens-kriteriumsind 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 dasbestandens-kriteriumgegenbeobachtetentschieden. Wennbeobachtetdas Kriterium erfüllt, aber vonerwartetabweicht, korrigiere die Implementierung, um sie anerwartetanzupassen, oder markiere die Assertion als FEHLER – schreibe niemalserwartetauf den beobachteten Wert um (Abschnitt 8).- Fülle
geänderter_pfadmit der Datei/Funktion/Route, die die Assertion ausübt; schreiben/anur 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 ingeänderter_pfadhaben; DESIGN darfn/averwenden. 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 StatusBESTANDENoderBESTANDEN-DURCH-BENUTZERist; wenn sie etwas anderes ist, ist die nachgelagerte ZeileNICHT AUSGEFÜHRT(Abschnitt 7) und einNICHT AUSGEFÜHRTführt dazu, dass die Hürde FEHLER ist. Derhängt_ab_von-Graph muss azyklisch sein – ein Zyklus ist FEHLER. EineBENUTZER-URTEIL-Zeile ist ein Blatt: Keine Zeile darf eineBENUTZER-URTEIL-ID inhängt_ab_vonaufführen.
- Treibe die echte Oberfläche mit tatsächlich auf diesem Rechner verfügbaren Befehlen an (z. B.
npm run devzum 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 -ffü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 Rohblockgeschwä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. - 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 als00-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. - 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. - DESIGN-Beobachtungswerte müssen aus mechanisch erfassten Quellen stammen (berechnete Style-JSON,
getBoundingClientRect, DOMtextContent, 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. - 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".
- Hürde beurteilen (Abschnitt 6): BESTANDEN nur, wenn jedes erforderliche Element auf der erforderlichen Stufe existiert, jede nicht-
BENUTZER-URTEIL-AssertionBESTANDEN/BESTANDEN-DURCH-BENUTZERist, mindestens eine Assertion ein maschinelles Urteil trägt und es keinenhängt_ab_von-Zyklus gibt; sonst FEHLER, NICHT VERFÜGBAR/BLOCKIERT oder BENUTZER-AUSSTEHEND (Abschnitt 7).HürdeundErgebnisverwenden 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-ZeileBESTANDEN/BESTANDEN-DURCH-BENUTZERist und es keinFEHLER/NICHT AUSGEFÜHRT/NICHT VERFÜGBAR/BLOCKIERTgibt. BENUTZER-URTEIList 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) – niemalsBENUTZER-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 niemalsBENUTZER-URTEILsein. Ein Bericht, dessen jede AssertionBENUTZER-URTEIList, 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, nichtBENUTZER-URTEIL.hängt_ab_vonist ein DAG: Ein Zyklus ist FEHLER. Eine Voraussetzung ist nur durchBESTANDENoderBESTANDEN-DURCH-BENUTZERerfüllt; keine Zeile darf von einerBENUTZER-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.
| Profil | Mindestbeweissatz — 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
| Status | Bedeutung | Wann verwenden | Zulässig für PASS-Bedingung? |
|---|---|---|---|
| BESTANDEN | Die Assertion ist maschinell bestanden. Erfüllt das bestandens-kriterium und beobachtet entspricht erwartet (Abschnitt 5 Schritt 2). | Maschine hat entschieden und bestanden. | Ja |
| FEHLER | Die Assertion ist maschinell fehlgeschlagen. | Maschine hat entschieden und fehlgeschlagen. | Nein; blockiert die Hürde. |
| NICHT AUSGEFÜHRT | Eine 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ÜGBAR | Das 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. |
| BLOCKIERT | Die 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-URTEIL | Die 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-BENUTZER | Die 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-FREIGEGEBEN | Die 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-VAKUUMWAHR | Die 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:
| Dateiname | Zweck |
|---|---|
bericht.md | Der endgültige Bericht aus der Vorlage. |
00-pre-change.log | Ausgabe der Grundlinie vor der Änderung (Zeigt, dass der Eingabewert vor der Änderung akzeptiert/anders wurde). |
01-assertion-<id>-raw.log | Rohe Ausgabe für Assertion <id> (z. B. 01-assertion-A1-raw.log). |
02-screenshot-<beschreibung>.png | Screenshot für DESIGN-Assertionen. |
99-metadaten.json | Metadaten (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 istBESTANDEN/BESTANDEN-DURCH-BENUTZER/FEHLER-FREIGEGEBEN, mindestens eine Assertion trägt ein maschinelles Urteil (BESTANDEN/FEHLER), keinhängt_ab_von-Zyklus.FEHLER: Einer der obigen Zustände trifft zu. DieHürdeund dasErgebnisdes Berichts müssen identisch sein.
Ausnahmen (Abschnitt 1):
NICHT VERFÜGBAR/BLOCKIERT: Wenn die Beweiserfassung unmöglich ist, KEINBESTANDEN-"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
| Problem | Aktion |
|---|---|
| Kein Browser für Screenshot | Verwende puppeteer headless oder playwright screenshot, oder erkläre NICHT VERFÜGBAR für die Assertion. |
npm run dev schlägt fehl | Korrigiere die Abhängigkeiten zuerst; wenn unmöglich, erkläre BLOCKIERT. |
| Kein Netzwerk für API-Tests | Verwende curl localhost (oder Docker-IP) oder erkläre NICHT VERFÜGBAR. |
git nicht verfügbar | Verwende 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 angewandt | Beide Profile in der Hürde evaluieren; jedes muss seinen Mindestbeweissatz erfüllen. |
| Benutzer fordert "Beweise" an, aber der Umfang ist unklar | Frage zur Klärung, bevor du fortfährst (Abschnitt 3). |
Referenzen
proof-profiles.md(im Ordnerreferenzen/dieses Repos)bericht-vorlage.md(im Ordnerreferenzen/dieses Repos)