Dokumente überarbeiten
Das offizielle Instruktionsdatei-Verwaltungsplugin enthält einen „revise“-Befehl, der das Gelernte einer Sitzung erfasst, indem er es an die Root-Instruktionsdatei anhängt. Genau dieses Verhalten soll dieses Skill ersetzen. Eine Root-Datei, die nur wächst, wird irgendwann nicht mehr bis zum Ende gelesen, und ein nachträglich angehängtes Lernergebnis ist selten die Information, die eine zukünftige Sitzung genau in dem Moment benötigt, in dem sie sie braucht. Dieses Skill behält die nützliche Hälfte dieses Plugins – die Überprüfung einer Behauptung gegen die Codebasis vor dem Schreiben – und verwirft den Anhäng-Teil zugunsten einer Weiterleitung. Die eigenen maschinenlokalen Speicher des Harness erfassen bereits, was eine Sitzung gelernt hat, und überspringen, was die Instruktionsdateien bereits sagen. Daher leitet dieses Skill die teilbare, eingecheckte Hälfte weiter: eine Regel in die Regeldatei, deren Pfade die Oberfläche abdecken, die sie betrifft, einen Vorfall in das Repository-Archiv.
Standardpfad
- Benenne die Sache, die diese Sitzung hervorgebracht hat und die es wert ist, behalten zu werden: eine Korrektur, eine festgelegte Konvention, einen Fehler und dessen Behebung, ein gemessenes Ergebnis, eine Entscheidung zwischen zwei Ansätzen.
- Klassifiziere sie als Regel oder Vorfall.
- Eine Regel gilt jedes Mal, wenn eine vergleichbare Situation wiederkehrt. Formuliere sie einmal, und sie sollte auch nach dem nächsten Refactoring noch gültig sein.
- Ein Vorfall ist einmal passiert, an einem Datum, mit einem Namen oder einer gemessenen Zahl. Er ist ein Beleg dafür, warum eine Regel existiert, nicht die Regel selbst.
- Leite eine Regel an ihre passende Regeldatei weiter.
- Durchsuche vorhandene Regeldateien nach Bereich und Überschrift, nicht nur nach Dateinamen. Öffne diejenige, deren
paths:bereits die Oberfläche abdeckt, die das Gelernte betrifft. - Wenn eine davon zutrifft, füge eine neue Überschrift hinzu oder ordne den Punkt einer vorhandenen unter. Befolge die Regelform: eine imperative Überschrift, die selbst die Regel ist, ein Begründungssatz, eine
Anchor:-Zeile, die angibt, was sie durchsetzt, eineReceipts:-Zeile, die auf den Archiveintrag verweist, und die Datei endet mit## Nicht tun. - Überprüfe vor dem Schreiben. Stelle sicher, dass jedes Token in der
Anchor:-Zeile, jeder Pfad, jeder Skriptname im Repository aktuell aufgelöst werden kann. Das ist die aus dem obigen Plugin übernommene Prüfgewohnheit: Schreibe niemals eine Behauptung, die du nicht überprüft hast. - Wenn nichts zutrifft, sage dies und schlage eine neue Regeldatei oder einen breiteren Geltungsbereich für eine bestehende vor. Wirf den Punkt nicht in die nächstbeste Datei, nur weil sie naheliegt.
- Durchsuche vorhandene Regeldateien nach Bereich und Überschrift, nicht nur nach Dateinamen. Öffne diejenige, deren
- Leite einen Vorfall in das Archiv des Repositorys weiter.
- Das Archiv ist das, was das Repository als sein Dokument für datierte Nachweise bezeichnet: ein Handbuchkapitel, eine Datei mit dem Designverlauf, ein Postmortem-Protokoll. Schreibe das Datum, den Namen, die gemessene Zahl dort hinein, betitelt als einzeilige Lektion, sodass der Eintrag wie eine Behauptung und nicht wie ein Dateiname klingt.
- Verweise in der Regeldatei auf den Eintrag mit seiner angegebenen Überschrift. Wiederhole keine Einzelheiten des Vorfalls im Regeltext; ein Datum oder eine Zahl in einer Regel ist Geschichte, die die Kleidung einer Regel trägt.
- Wenn das Repository noch kein Archiv hat, sage dies und schlage vor, eines anzulegen. Ordne den Vorfall nicht mangels eines Heims in eine Regeldatei oder die Root-Datei ein.
- Berühre niemals die Root-Instruktionsdatei. Wenn weder eine Regeldatei noch das Archiv passt, ist das ein Zeichen dafür, dass die Tatsache nicht beständig genug ist, um behalten zu werden, und kein Grund, sie standardmäßig in die Root-Datei zu legen. Sage das deutlich und stoppe.
- Zeige die Bearbeitung, bevor du sie speicherst. Gib die Überschrift und den Absatz, die du vorschlägst, oder einen Diff zur vorhandenen Datei aus und warte auf Bestätigung, es sei denn, dir wurde ausdrücklich gesagt, die Änderung einfach vorzunehmen.
Wenn der Treffer eine verwaltete Hausregel ist
Wenn die Datei, die das Thema bereits abdeckt, eine zugekaufte Hausregel ist (trägt den Header für verwaltete Dateien, liegt unter .claude/rules/house/**), bearbeite sie nicht in diesem Repository. Eine lokale Bearbeitung einer verwalteten Datei wird beim nächsten /house-rules:sync-Lauf stillschweigend überschrieben, und dieser stille Verlust ist genau das, was „house“ verhindern soll.
Schlage die Änderung stattdessen upstream vor. Erstelle den gleichen Titel und Absatz und sage dann, dass sie als Änderung im Haus-Repository und nicht in diesem eröffnet werden soll. Wenn der Punkt wirklich nur für dieses Repository spezifisch ist und keine flottenweite Regel, zeichne ihn als Abweichung in house.json auf, anstatt die verwaltete Datei zu forken. Beide Wege halten die verwaltete Datei synchron; eine lokale Bearbeitung tut das nicht.
Notausstiege
- Das Gelernte widerspricht einer bestehenden Regel. Sage das deutlich, zitiere die vorhandene Überschrift und frage, welche gewinnt, bevor du etwas schreibst. Überschreibe nicht stillschweigend eine Regel mit einer anderen.
- Das Gelernte ist ein repospezifischer Einzelfall ohne Regelcharakter, ein Workaround für einen Anbieterfehler, eine Notiz, die nur einmal relevant ist. Leite es stattdessen als Vorfall in das Archiv, anstatt eine Regeldatei mit etwas zu überladen, das keine zukünftige Sitzung befolgen muss.
- Du bist unsicher, ob etwas eine Regel oder ein Vorfall ist. Tendiere zum Archiv. Eine fälschlich archivierte Regel ist eine Überschrift, die jemand später hochstufen kann; ein fälschlich als Regel behandelter Vorfall wird zu veraltetem Text, den nichts kennzeichnet.
- Das Repository hat weder Regeldateien noch ein Archiv. Sage das deutlich und stoppe, anstatt eines von beiden aus diesem Skill heraus zu erstellen. Das ist Aufgabe von
/house-rules:bootstrap, nicht von diesem Skill.
Nicht tun
- Hänge nicht an die Root-Instruktionsdatei an. Das ist genau das Verhalten, das der „revise“-Befehl des offiziellen Instruktionsdatei-Plugins ausführt und der Grund, warum dieses Skill stattdessen existiert.
- Schreibe keinen Regelsatz, dessen Anker du nicht gegen die Codebasis überprüft hast.
- Wiederhole keine Daten, Namen oder Zahlen eines Vorfalls im Regeltext; verweise auf das Archiv.
- Bearbeite keine zugekaufte Hausregeldatei lokal. Schlage sie upstream vor oder zeichne eine Abweichung auf.
- Speichere keine Bearbeitung, die die Person nicht gesehen hat, es sei denn, sie hat dir ausdrücklich gesagt, sie einfach vorzunehmen.
- Erfinde keine Regeldatei oder kein Archiv, wenn das Repository keines hat.