landing-check – ist die Arbeit gelandet und sind die Behauptungen wahr?
Drei Fragen, die sonst niemand im Werkzeugkasten stellt. /code-review liest den Diff auf Korrektheit. /audit durchsucht das gesamte Projekt, kalt. coding-conventions lässt den Autor seinen eigenen Code erneut ausführen. Alle drei können bestanden werden, während die Änderung in einer Datei landete, die nichts ausführt, der Bericht eine falsche Zahl angibt und die Hälfte der Kopien nie berührt wurde.
Die Fehlerklasse, für die dies existiert, in der Praxis beobachtet: Eine Sicherheitskorrektur wurde bereitgestellt, indem jede .git/hooks/pre-commit-Datei in einer Reihe von Repositories durchlaufen wurde. Aber mehrere dieser Repos setzten core.hooksPath, und git ignoriert dann .git/hooks vollständig – in einigen von ihnen landete die Korrektur also auf einer toten Datei, während der Live-Hook den alten Pfad behielt. Die Schleife bestätigte jeden Schreibvorgang, und der Bericht behauptete sechs Tage lang, die Korrektur sei universell. Der Diff war korrekt. Die Verifikation war echt. Beide betrafen die falsche Datei.
Jede Prüfung unten ist eine, die ein echter Durchlauf benötigte. Keine ist spekulativ – siehe Provenienz am Ende. Zehn Durchläufe später: Die Überprüfung hat null Codefehler und ungefähr vierzig falsche Behauptungen, falsch gelandete Korrekturen, tote Wächter und Korrekturen, die sich nicht ausgebreitet haben, gefunden. Das ist die Art von Dingen, die sie abfängt.
Aufruf
/landing-check, oder: „did that land“, „sweep the changes“, „verify what I just did“, „check my work before I commit“. Nur auf Anfrage – es kostet einen Agenten, also feuert es nie von selbst.
Nicht dieser Skill
- Codekorrektheit im Diff →
/code-review(eingebaut; hat Multi-Agent und--fix). Überprüfen Sie hier keine Logik erneut. - Gesamtprojekt-Sweep →
/audit(kalt, teuer). - Erneutes Ausführen dessen, was Sie gerade geschrieben haben →
coding-conventions(gleicher Kontext, eigene Augen des Autors, feuert vom PostToolUse-Hook). Wenn ein Befund zu einem von diesen gehört, benennen Sie ihn und geben Sie ihn weiter – erweitern Sie diesen Skill nicht darauf.
Wie man ihn ausführt
Einen FRESH-Agenten spawnen (Agent-Tool, allgemeiner Zweck). Maßvoller Kontext: Dies ist auf das beschränkt, was sich geändert hat, nicht auf das Projekt.
Was der Agent bekommt – nur Artefakte:
- die berührten Repo-Pfade und eine Zeile darüber, was das Projekt ist;
git status+git diff(undgit diff --statpro Repo) – oder, für Nicht-Repo-Bäume, die Liste der in dieser Sitzung geänderten Pfade;- den GESCHRIEBENEN Bericht über die Arbeit: Commit-Nachrichten, der Datensatzeintrag, der endgültige Berichtstext, jedes Dokument, das bearbeitet wurde, um die Änderung zu beschreiben;
- welche der berührten Bäume ÖFFENTLICH sind (irgendwohin gepusht), falls vorhanden;
- Schritte 1–3 und das Ausgabeformat unten sowie die Anweisung, alles, was es nicht erreicht, als NICHT ÜBERPRÜFT zu markieren.
Was es NICHT bekommen darf: Ihre Darstellung dessen, was Sie getan haben. Die Behauptungen sind das Objekt. Wenn Sie dem Agenten Ihre Zusammenfassung geben, geben Sie ihm dieselbe Betriebsblindheit, die den Fehler verursacht hat – Sie werden sowohl Angeklagter als auch Zeuge. Es leitet jede Behauptung aus den geschriebenen Artefakten und von der Festplatte neu ab. Dies ist die eine Regel, die den Skill seinen Preis wert macht; lassen Sie sie weg und dies ist Selbstbewertung in einem zweiten Fenster.
Der Agent liest den Zustand live neu ein. git status, ahead/behind, was gepusht ist: zum Überprüfungszeitpunkt abgeleitet, nicht aus der Aufnahme, die ihm übergeben wurde – andere Sitzungen committen, pushen und bearbeiten dazwischen (eine gleichzeitige Sitzung hat eine Korrektur innerhalb eines nicht zusammenhängenden Commits committed; sechs Repos wurden Minuten vor einer Überprüfung gepusht, der gesagt wurde „null Pushes“). ahead N beweist nichts ohne vorheriges fetch – fragen Sie den Remote (git ls-remote, dann rev-list --left-right --count @{u}...HEAD).
1. LANDUNG – hat die Bearbeitung die Datei erreicht, die ausgeführt wird?
Für jede geänderte Datei fragen Sie, ob eine andere Kopie existiert und ob etwas zwischen ihnen wählt. Das Kennzeichen ist: die bearbeitete Datei und die ausgeführte Datei haben denselben Namen und unterschiedliche Pfade.
- Shadowing:
git config core.hooksPath(gesetzt ⇒.git/hooks/*ist toter Code; auflösen mitgit rev-parse --git-path hooks/<name>, dem Auflöser, den git selbst verwendet),PATH-Reihenfolge für Skripte, Symlinks, vendorisierte Kopien unternode_modules, eine venv-Kopie vs. eine Repo-Kopie. - Multi-Tree-Systeme: Wenn eine Datei in mehr als einem Baum existiert (installiert / Labor / öffentlich, dev / dist, src / build), welche lädt die Laufzeit? War es die geänderte?
- Registrierung: Wenn die Änderung etwas hinzufügt oder bearbeitet, das verdrahtet werden muss (ein Hook, eine geplante Aufgabe, eine Route, ein Einstiegspunkt), lesen Sie die Registrierungsdatei und bestätigen Sie, dass der Pfad dort zu der von Ihnen geänderten Datei aufgelöst wird.
- Aktivierung – die richtige Datei ist notwendig, nicht hinreichend. Für alles, was eine Kontrolle ist – ein Wächter, eine Verweigerungsregel, ein Hook-Matcher, ein regulärer Ausdruck, ein Berechtigungsmuster, eine Canary-Assertion, eine Ignorierregel – setzen Sie den Positivfall, den es abzufangen gibt, und beobachten Sie, wie er feuert, dann einen Negativfall und beobachten Sie, wie er still bleibt. Eine Kontrolle, die nie beim Feuern beobachtet wurde, ist UNVERIFIZIERT. Kontrollen, die als Schutz lesen und nicht feuern konnten, alle gefunden in Läufen: Verweigerungsregeln, die Präfix-Matcher waren und niemals ein Token innerhalb eines Befehls blockieren konnten; ein Leck-Regex, dessen
\RzuX:Repokompilierte und keinen echten Pfad matchen konnte; ein Groß-/Kleinschreibung-sensitiver Namensfilter, der eine durchgehend großgeschriebene Schreibweise durchließ; eine Assertion/findings/.test(src), die für immer wahr war. - Urteil pro geänderter Datei: GELANDET / FALSCH GELANDET / NICHT VERIFIZIERBAR (warum sagen). Eine Datei, deren ausführende Kopie Sie nicht ermitteln konnten, ist NICHT VERIFIZIERBAR, nicht GELANDET. Eine zurückgelassene tote Kopie ist an sich kein Befund – sagen Sie, welche Kopie live ist und dass die Bearbeitung darin ist.
2. BEHAUPTUNGEN – stimmt der schriftliche Bericht mit der Festplatte überein?
Extrahieren Sie jede überprüfbare Behauptung aus den Artefakten und leiten Sie dann jede unabhängig neu ab – mit einem anderen Befehl als dem, der sie erzeugt hat, wo ein anderer existiert. Prioritätsreihenfolge, höchste Ausbeute zuerst:
- Universalien – „alle 7“, „jede Kopie“, „byte-identisch“, „keine bleiben übrig“, „0 Befunde“, „nichts durchgesickert in allen 17 Repos“. Ein Fehlschlag macht die gesamte Aussage falsch, und dies ist die Klasse, die den Fehler vom 08-05 verursacht hat. Zählen Sie die vollständige Menge auf und überprüfen Sie jedes Mitglied; akzeptieren Sie niemals eine Stichprobe als Beweis für eine Universalie. Eine Universalie, die Sie nur stichprobenartig überprüfen konnten, ist UNVERIFIZIERT.
- Zählungen – „17 Regeln“, „29 Skills“, „21/21“. Zählen Sie von der Quelle der Wahrheit, nicht von der Aussage. Achten Sie auf die Zeitform: Eine Zählung von Datensatzeinträgen, die innerhalb des gezählten Eintrags geschrieben wurden, ist um eins daneben, sobald sie landet; eine „die einzigen noch schmutzigen Dateien“-Behauptung, die innerhalb einer schmutzigen Datei aufgestellt wird, widerlegt sich selbst; ein Zitat eines Eintrags, der noch nicht existiert, zeigt auf nichts, bis er geschrieben ist.
- Zustände – „besteht“, „sauber“, „neu generiert“, „gepusht“. Führen Sie es aus oder lesen Sie das Artefakt, das es beweist. Zitierte Ausgabe ist eine Behauptung über das Programm: Wenn ein Artefakt eine Zeile einer Tool-Ausgabe als Beweis zitiert, durchsuchen Sie das Tool nach diesem genauen Text – eine Zeile, die nur im Fehlerfall gedruckt wird, kann kein Bestehen beweisen, und eine Zeile, die das Programm nie ausgibt, ist ein erfundenes Zitat.
- Zahlen – Ein Wert mit mehr signifikanten Stellen als der Ausgabe, auf die er zurückgeht, ist erfunden (13 Aktienkurse, veröffentlicht mit 4 Nachkommastellen aus einer Tabelle mit 2 Stellen: 12 falsch). Eine Statistik aus einem LIVE-Korpus (Transkripte, Logs, ein wachsender Datensatz) ist nicht reproduzierbar, ohne dass der Zustand des Korpus festgehalten wird (Dateianzahl + Zeitstempel); melden Sie sie als UNVERIFIZIERT-WIE-ANGEGEBEN und nennen Sie, was sich reproduziert.* Überprüfen Sie die Arithmetik innerhalb eines Satzes („27 plus 3 … 29 heute“). Für Vergleiche: gleiche Stichprobenmenge in allen Armen, Schätzer genannt, n angegeben – ein 2×2, dessen Arme nicht dieselben Chargen teilen, ist kein Vergleich. Ein fehlendes Feld ist nicht
false. Ein==auf einem Float, der durch float32 round-triped, hat nie gestimmt, und das committede JSON enthielt0.0für einen echten0.605. - Interner Widerspruch – ein Satz, der durch die Einschränkung seines eigenen Absatzes fünf Zeilen später widerlegt wird; eine Behauptung und ihre Widerlegung beide vorhanden, ohne datierten Strich; dieselbe Zahl dreimal zitiert und in allen dreien falsch.
Eine Behauptung, die Sie nicht überprüfen können, wird als UNVERIFIZIERT gemeldet, niemals als wahr. Eine Behauptung, die wahr ist, aber aus einem anderen als dem angegebenen Grund, ist ein Befund.
3. KOLLATERAL – was hätte sich bewegen sollen und tat es nicht?
Der Diff zeigt, was sich geändert hat. Dies fragt, was die Änderung erforderte und unerledigt ließ. Führen Sie das Gegenteil des Diffs aus: Durchsuchen Sie für jeden geänderten Wert oder jedes Konzept den Baum nach anderen Stellen, die noch den alten behaupten.
- Geschwisterkopien – jeder andere Baum/Branch/Paket, der dieselbe Datei hält. Eine Korrektur für ein falsches Landen ist selbst in einer von zwei Kopien falsch gelandet; eine pauschale Kopie einer privaten Datei über ihr öffentliches Gegenstück hat das wieder eingeführt, was ein früherer Commit absichtlich entfernt hatte – vergleichen Sie die öffentliche Kopie mit ihrem eigenen
git show HEAD:, nicht mit der privaten Quelle. - Korrekturweiterleitung – Wenn die Arbeit eine Behauptung korrigiert, finden Sie jede andere Kopie der ALTEN Behauptung: HANDOFF, PRD, Memory Bins, README, Code-Kommentare, das öffentliche Gegenstück, die eigene Beschreibung des Skills. „Korrigiert im Datensatz, ließ HANDOFF und den Bin mit den alten Zahlen stehen“ und „die dritte Kopie dieser Behauptung war noch nicht gestrichen“ sind der am häufigsten wiederholte Befund jedes Laufs.
- Dokumente, die den geänderten Wert zitieren – READMEs, Skill-Beschreibungen, HANDOFF, PRD, Kommentare,
MUSS N/N ausgeben-Pins. Eine im Code geänderte und in Prosa unveränderte Zählung ist ein Befund. - Publikationsleck – gelandet, wo es NICHT darf. Wenn ein berührter Baum öffentlich ist: Durchsuchen Sie seinen Diff (und die von ihm berührten Dateien gegen
HEAD) auf private Identifikatoren – Namen, E-Mails, absolute Pfade, private Projektnamen – groß-/kleinschreibungsunabhängig. Sagen Sie, ob diese Änderung die Zeichenfolge eingeführt oder geerbt hat; die beiden erfordern unterschiedliche Korrekturen, und der Autor hat die erste schon einmal als die zweite bezeichnet. - Generierte Zwillinge – gerendertes HTML eines Datensatzes, TOC-Zeilen, Memory Bins, Anker: neu generiert? Ein Anker, der aufgelöst wird, aber eine Überschrift zu früh landet, ist nicht „kaputt“, also beweist
kaputt: 0es nicht. - Neue Artefakttypen – Hat die Arbeit eine Art von Datei erstellt, die es vorher nicht gab (Cache-Verzeichnisse, Build-Ausgabe, Logs)? Gibt es eine Ignorierregel, und ist sie im richtigen Repo?
- Nebenprodukte – erstellte und zurückgelassene Dateien: nicht versionierte Dateien, temporäre Verzeichnisse,
__pycache__,.tmp, Sicherungskopien. Listen Sie sie mit vollständigen Pfaden auf; löschen Sie nichts. - Die Verpflichtung, die die Dokumente angeben – Wenn die eigenen Regeln des Projekts sagen, dass eine Änderung dieser Art etwas erfordert (einen Datensatzeintrag, einen neu generierten Zwilling, eine synchronisierte Momentaufnahme, einen Testlauf, eine Pin-Erhöhung), überprüfen Sie, ob dies geschehen ist.
Probe – der mechanische Teil, ausgeführt bevor der Agent urteilt
landing-probe.js (portabel Node, null Abhängigkeiten, schreibgeschützt) zählt auf, was Schritte 1–3 sonst von Hand neu ableiten würden, sodass der Agent eine Zählung liest, anstatt eine zu erraten. Geben Sie ihm jeden berührten Baum; geben Sie seine Ausgabe als Artefakt an den Agenten weiter.
node landing-probe.js probe <wurzel>... [--file <p>]... [--since <min>]
[--settings <json>] [--remote] [--all]
node landing-probe.js --canary
HOOK– pro Repo, pro Hook: die Datei, die git AUSFÜHREN wird (git rev-parse --git-path, berücksichtigtcore.hooksPath) und jede TOTE Kopie am anderen Ort; ein registrierter Pfad ohne Datei istFEHLT.CHANGED– gestaged / modifiziert / nicht versioniert pro Repo;--filebenennt Dateien außerhalb jedes Repos;--since Nfügt Dateien hinzu, die in den letzten N Minuten unter NICHT-Repo-Wurzeln modifiziert wurden (ein installierter Baum ist kein Repo).TWIN– für jede geänderte Datei, jede gleichnamige Datei unter einer Wurzel,GLEICHoderUNTERSCHIEDLICH(sha256, CRLF-normalisiert). Konventionelle Namen (SKILL.md,README.md– jeder Basisname mit mehr als 6 Kopien) werden nach übergeordnetem Verzeichnis/Namen gematcht, nicht nach Namen allein.--alllistet jede Zwillingsgruppe auf, nicht nur die geänderten.REG–--settings <json>: jede pfadförmige Zeichenfolge (nach~/$HOME/%USERPROFILE%-Erweiterung) und ob sie AUFLÖST.REMOTE– ahead/behind pro Repo, beschriftet mitCACHED ref, es sei denn,--remotehat zuerst geholt.ahead Nvon einem zwischengespeicherten Ref beweist nichts.
Beenden mit 1, wenn es etwas zu betrachten gibt (einen TOTEN Hook, einen UNTERSCHIEDLICHEN Zwilling einer geänderten Datei, eine FEHLENDE Registrierung); 0 für eine saubere Zählung. Es beurteilt nichts – UNTERSCHIEDLICH zwischen einem privaten und seiner generalisierten öffentlichen Kopie ist erwartet, und der Agent sagt dies. --canary baut Wegwerf-Repos (hooksPath gesetzt / nicht gesetzt / zeigt auf nichts, einen bare Remote und einen Clone, der einen Commit voraus ist, CRLF-Zwillinge, einen konventionellen Namenswald, eine Einstellungsdatei mit einem fehlenden Pfad) und MUSS CANARY PASS 23/23 ausgeben, bevor Sie einer Zählung vertrauen.
Ausgabe
Kurz. Dies ist ein Sanity-Check vor dem Commit, kein Audit-Bericht.
- Urteilszeile: SICHER ZU COMMITTEN / ZUERST KORRIGIEREN / NICHT VERIFIZIERBAR, ein Satz.
- Abdeckungszeile: welche Artefakte gelesen wurden, welche Bäume durchsucht wurden und was NICHT ÜBERPRÜFT wurde – ein kurzer Bericht darf niemals wie ein sauberer aussehen.
- Landungstabelle:
Datei | Kopien gefunden | welche wird ausgeführt | auf einen gepflanzten Positivfall gefeuert? | Urteil. Nur Zeilen, die FALSCH GELANDET oder NICHT VERIFIZIERBAR sind, benötigen Details. - Behauptungstabelle:
Behauptung (Zitat) | Quellartefakt | neu abgeleitetes Ergebnis | WAHR / FALSCH / UNVERIFIZIERT. - Kollateralliste: was hätte sich bewegen sollen und tat es nicht, jedes mit einem Pfad.
- Bestätigt: die tragenden Negative und die Zahlen, die sich exakt neu abgeleitet haben (keine Fehllandung, kein Leck, 25/25 reproduziert) – ein Sweep, der nur Fehler meldet, lehrt nichts darüber, was solide ist, und der Datensatz des Autors braucht sie.
- Übergaben: alles, was zu
/code-review,/auditodercoding-conventionsgehört, benannt und weitergegeben, anstatt hier halb erledigt zu werden.
Nach dem Bericht
- Überprüfen Sie jeden Befund von Hand, bevor Sie handeln. Die Behauptungen des Verifizierers sind Behauptungen: In einem Lauf waren die neu abgeleiteten Ganzzahlen daneben, weil der Korpus darunter gewachsen war; die Invarianten hielten. Akzeptieren Sie, was sich reproduziert.
- Die Korrektur unterliegt denselben drei Fragen. Korrekturen von ZUERST KORRIGIEREN-Befunden gehen an jede Kopie und jedes Dokument, das den alten Wert zitiert – der Lauf, der eine Fehllandung in einem von zwei Kopien korrigierte, lieferte die Korrektur an eine von zwei Kopien.
- Schreiben Sie den Datensatzeintrag aus den neu abgeleiteten Werten, nach dem letzten Verifikationslauf, nicht davor: Ein zuerst geschriebener Eintrag zeichnet den Zustand auf, den Sie erwartet haben, und der Append-Only-Datensatz macht dies dauerhaft.
Regeln
- Nur Befunde. Ändern Sie nichts. Dieser Skill ist schreibgeschützt. Keine Korrekturen, keine Dateierstellung, keine Edits. Befunde sind für den Autor, nicht für das Tool.
- Ein Befund, dessen Korrektur Sie sehen, wird gemeldet; eine Korrektur, die Sie sehen, wird nicht angewendet. Der Agent, der die Unterlassungssünde zum ersten Mal beobachtet, könnte auch die Ursache dafür sein.
- Was der Agent nicht erreicht hat, wird NICHT ÜBERPRÜFT. Am Ende des Berichts gibt der Agent an, welche Bäume er nicht durchlaufen und welche Artefakte er nicht gelesen hat. Der Schluss „keine Befunde“ mit nicht überprüften Bäumen ist kein Vertrauensbeweis.
- Die Ausgabe ist nur das, was der Agent sieht. Keine Artefakte von früher, keine Zusammenfassungen aus anderen Quelldateien, keine Schlussfolgerungen, für die der Agent die Beweise nicht zitiert.
Verfeinerung
Die Spezifikation ist aus zehn Produktionsläufen mit insgesamt 43 Befunden destilliert. Die Detektion des Kerns (Landung) und die höchste Ausbeute (Universalien, Zählungen) haben sich in diesen Läufen nicht verändert. Die Aktivierungsprüfung und der Canary wurden in den Läufen 6–10 hinzugefügt, als Kontrollen, die nicht feuern konnten, der vorherrschende Befund wurden. Die aktuelle Ausgabe (Kurzbericht, Nie-Nicht-Überprüft-Schlussfolgerung, bestätigte Spalte) ersetzte die Langform nach Lauf 9, als der Benutzer feststellte, dass der Bericht des Verifizierers mehr Wert auf das Legte, was er bestätigte, als auf das, was er fand.
landing-probe.js – Referenz
(Bereits im Abschnitt Probe dokumentiert, wiederholt, wenn gebraucht)
# Verwendung
node landing-probe.js probe <wurzel>... [--file <p>]... [--since <min>]
[--settings <json>] [--remote] [--all]
- Offizielle Node.js-Laufzeit (≥14), null Abhängigkeiten.
- Keine Ausgabe in eine Datei schreiben, niemals.
--settingsliest nur. --canaryerstellt/zersört temporäre Repos; führen Sie ihn zuerst aus.- Jeder Exit-Code ≠ 0 ist ein Hinweis auf etwas, das betrachtet werden muss, nicht ein Fehler.
Siehe auch landing-probe.js --help für die vollständige Referenz.