Rule Promoter
Überblick
CLAUDE.md-Regeln sind Ratschläge: Claude kann sie umgehen. Ein Hook ist Durchsetzung. Diese Fähigkeit liest das CLAUDE.md des Projekts, wählt die Regeln aus, die ein Hook tatsächlich durchsetzen kann, schreibt sie in eine Regeldatei, die von einer kleinen, getesteten Engine durchgesetzt wird, beweist, dass jede Regel einen Verstoß blockiert, und installiert die Hooks, nachdem der Benutzer bestätigt hat. Sie wird nur ausgeführt, wenn der Benutzer darum bittet. Hooks sind Leitplanken, keine Sicherheitsgrenze: Eine entschlossene Umgehung (ein Hilfsskript, sh -c) kann ein Muster umgehen. Sage das.
Dateien (im Basisverzeichnis dieser Fähigkeit, angezeigt beim Laden der Fähigkeit)
scripts/rule_hook.py: die Engine. Kopiere sie nach.claude/hooks/rule_hook.pyin das Projekt.python rule_hook.py selftestbeweist jede Regel;checkist der Hook-Einstiegspunkt.scripts/settings_merge.py:launcherwählt einen Python-Befehl aus, der funktioniert;planzeigt den Einstellungs-Diff;applyschreibt ihn.
Führe beide mit einem Python 3-Befehl aus, der auf diesem Rechner funktioniert (versuche python3, python, py -3). Zitiere Pfade.
Prozess
-
Lesen. Finde
CLAUDE.md,.claude/CLAUDE.mdundCLAUDE.local.mdim Projekt. Liste jede Regel mit ihrer Datei und Zeile auf. Wenn es keine gibt, sage das und höre auf. -
Klassifiziere jede Regel in genau eine von:
- einem Engine-Typ (unten) mit konkreten Parametern;
taste, mit einem einzeiligen Grund;benötigt Eingabe, mit der spezifischen zu stellenden Frage (z. B. "welcher Befehl führt deine Tests aus?").
Eine Regel ist nur durchsetzbar, wenn sie konkrete Werkzeuge, Pfade, Befehle oder Textmuster nennt und ein Verstoß von einem einzigen Werkzeugaufruf oder aus dem Exit-Status eines End-of-Turn-Befehls erkennbar ist. Wenn unsicher, markiere sie als
benötigt Eingabeund frage; errate niemals ein Muster für eine vage Regel. Erfinde niemals einen Regeltyp. -
Überprüfen. Zeige eine Tabelle: Regel, Typ, Muster oder Befehl, ein Beispiel-Verstoß, ein Beispiel-Bestandensein und das Falsch-Positiv-Risiko. Zeige jeden
stop_check-Befehl wörtlich. Frage den Benutzer, Zeilen zu entfernen oder anzupassen. Schreibe noch nichts. -
Beweisen. Nach der Zustimmung, erstelle
.claude/hooks/und kopierescripts/rule_hook.pydorthin, schreibe.claude/rules.json, führe dannpython .claude/hooks/rule_hook.py selftestvom Projektstamm aus. Zeige die Ausgabe. Eine Regel, deren Beweis fehlschlägt, wird nicht installiert: Korrigiere ihr Muster oder entferne sie, und sage welche. -
Installieren. Führe
settings_merge.py launcher --script .claude/hooks/rule_hook.pyaus, dannsettings_merge.py plan --settings .claude/settings.json --launcher "<launcher>" [--pretool] [--stop](--pretool, wenn Pfad-, Befehls- oder Inhaltsregeln existieren;--stop, wenn stop_check-Regeln existieren). Zeige den Diff und frage nach einem Ja. Nur nach einem Ja, führe denselben Befehl mitapplyaus. Wenn es ungültiges Settings-JSON oder einen doppelten Schlüssel meldet, stoppe und informiere den Benutzer; bearbeite die Datei nicht von Hand. Der Helfer entfernt nur seine eigenenrule_hook.py-Einträge und lässt jeden anderen Hook in Ruhe. Wenn die folgende End-to-End-Überprüfung zeigt, dass der Hook nicht ausgelöst wurde, obwohlselftestbestanden hat unddisableAllHooksnicht gesetzt ist, haben einige Claude Code-Versionen keine Exec-Form-args: führeplanundapplyerneut mit--shell-formaus. -
End-to-End-Überprüfung. Wenn du
claude -pim Projekt ausführen kannst, teste mit einerprotected_path- oderbanned_content-Regel gegen eine Wegwerfdatei (z. B. bitte sie, eine Dateitmp-rule-check.txtunter einem geschützten Glob zu bearbeiten), niemals mit einemblocked_commandoderstop_check, der wirklich etwas ausführen würde, und mache jede Änderung danach rückgängig. ÜberprüfedisableAllHooksin den Projekt-, Lokal- und Benutzereinstellungen, bevor du Schlussfolgerungen ziehst. Bestätige, dass die Ausgabe dieRegel <id>:-Blocknachricht zeigt, und zeige sie. Wenn du keine verschachtelte Sitzung ausführen kannst, sage das und sage, dass die Installation nur durchselftestverifiziert ist. -
Bericht. Liste die beförderten Regeln, die übersprungenen Regeln mit Gründen und eine Einschränkung: Claude kann immer noch
.claude/rules.json,.claude/hooks/und.claude/settings.jsonbearbeiten. Biete an, eineprotected_path-Regel für sie hinzuzufügen, und sage, dass dies auch die erneute Ausführung dieser Fähigkeit blockiert, bis die Regel deaktiviert ist. Sage dann, wie man Dinge ausschaltet: Setze"enabled": falsefür eine Regel in.claude/rules.json, oder lösche dierule_hook.py-Einträge aus.claude/settings.json.
Schreibe niemals rules.json, Hook-Dateien oder settings.json, bevor der Benutzer die Tabelle überprüft hat. Schreibe niemals settings.json, bevor du den Diff gezeigt und ein Ja bekommen hast.
Wenn der Benutzer eine Regel hinzufügt oder ein Muster nach der Tabelle ändert, oder wenn du ein Muster ändern musst, weil es ungültig ist oder sein Beweis fehlschlägt, zeige diese neue oder geänderte Zeile (Muster, Beispiel-Verstoß, Beispiel-Bestandensein, Risiko) und warte auf ein Ja, bevor du etwas schreibst. Eine früher gegebene Zustimmung deckt kein anderes Muster ab, und ersetze niemals ein Muster, das der Benutzer nicht gesehen hat.
Regeltypen
Jede Regel hat id (kebab-case), source (CLAUDE.md:14), text (die ursprüngliche Regel), message (Claude angezeigt, wenn blockiert), type, die untenstehenden Felder und einen proof mit einem violation- und einem pass-Payload.
protected_path: keine Bearbeitungen von übereinstimmenden Dateien. Globs beziehen sich auf den gesamten projektrelevanten Pfad; verwende **/name für jede Tiefe.
{"id": "no-migration-edits", "source": "CLAUDE.md:3", "text": "Bearbeite niemals etwas unter migrations/",
"type": "protected_path", "globs": ["**/migrations/**"], "allow_globs": [],
"message": "Migrationen werden generiert. Erstelle stattdessen eine neue Migration.",
"proof": {"violation": {"hook_event_name": "PreToolUse", "tool_name": "Edit", "tool_input": {"file_path": "app/migrations/0001_initial.py", "old_string": "a", "new_string": "b"}},
"pass": {"hook_event_name": "PreToolUse", "tool_name": "Edit", "tool_input": {"file_path": "app/models.py", "old_string": "a", "new_string": "b"}}}}
blocked_command: Bash-Befehle, die auf einen regulären Ausdruck passen, getestet gegen jedes Segment eines zusammengesetzten Befehls. Verwende except_patterns für sichere Varianten; eine Ausnahme befreit das gesamte Segment, also mache sie spezifisch.
{"id": "no-force-push", "source": "CLAUDE.md:4", "text": "Führe niemals git push --force aus",
"type": "blocked_command", "patterns": ["\\bgit\\s+push\\b.*(?:--force\\b|\\s-[A-Za-z]*f[A-Za-z]*\\b|\\s\\+\\w)"], "except_patterns": ["--force-with-lease"],
"message": "Force Pushes sind nicht erlaubt.",
"proof": {"violation": {"hook_event_name": "PreToolUse", "tool_name": "Bash", "tool_input": {"command": "git push --force origin main"}},
"pass": {"hook_event_name": "PreToolUse", "tool_name": "Bash", "tool_input": {"command": "git push origin feature"}}}}
banned_content: reguläre Ausdrücke, die nicht im neu geschriebenen Text (Edit, Write, MultiEdit, NotebookEdit) erscheinen dürfen, optional eingeschränkt durch Datei-globs. Alter Text wird nie inspiziert.
{"id": "no-console-log", "source": "CLAUDE.md:5", "text": "Kein console.log( in src/",
"type": "banned_content", "patterns": ["console\\.log\\("], "globs": ["src/**"],
"message": "Verwende den Logger, nicht console.log.",
"proof": {"violation": {"hook_event_name": "PreToolUse", "tool_name": "Write", "tool_input": {"file_path": "src/a.js", "content": "console.log(1)"}},
"pass": {"hook_event_name": "PreToolUse", "tool_name": "Write", "tool_input": {"file_path": "src/a.js", "content": "logger.info(1)"}}}}
stop_check: ein Befehl, der erfolgreich sein muss, bevor Claude anhalten darf. Er blockiert das Anhalten, wenn der Befehl mit einem Exit-Code ungleich Null beendet wird. when_changed_globs schränkt es auf Züge ein, die übereinstimmende Dateien geändert haben (nur unbestätigte Änderungen: weglassen, wenn Claude dazu neigt, vor dem Anhalten zu committen). Der Beweis verwendet simulate_exit (selftest führt den echten Befehl nicht aus).
{"id": "tests-pass", "source": "CLAUDE.md:6", "text": "Führe npm test aus, bevor du fertig bist",
"type": "stop_check", "command": "npm test", "timeout_seconds": 240, "when_changed_globs": ["src/**", "tests/**"],
"message": "Die Tests müssen bestanden sein, bevor du anhältst.",
"proof": {"violation": {"hook_event_name": "Stop", "simulate_exit": 1}, "pass": {"hook_event_name": "Stop", "simulate_exit": 0}}}
Die Datei ist {"version": 1, "rules": [ ... ]}. Werkzeug-Payloads: Bash verwendet tool_input.command; Edit verwendet file_path, old_string, new_string; Write verwendet file_path, content.
Was durchsetzbar ist (Klassifikationsleitfaden)
- Durchsetzbar: "bearbeite niemals X/", "fasse .env nicht an", "führe niemals Y aus", "verwende Z nicht in Dateien unter W", "führe T aus, bevor du fertig bist".
- Geschmackssache: "bevorzuge kleine Funktionen", "schreibe klare Commit-Nachrichten", "halte die Barrierefreiheit der UI ein", "bevorzuge Klarheit". Kein Muster kann diese entscheiden.
- Benötigt Eingabe: "sei vorsichtig mit der Datenbank", "stelle sicher, dass Tests bestanden werden" (welcher Befehl?), "vermeide Legacy-Code" (welche Pfade?). Frage; errate nicht.
- Globs unterstützen nur
*,**und?, relativ zum Projekt (kein[ab],{a,b}, führendes./oder/); die Engine lehnt alles andere ab.timeout_secondsist maximal 280, undenabledmusstrueoderfalsesein. - Bevorzuge enge Muster. Gib das Falsch-Positiv-Risiko für jede Regel an (z. B. passt ein
main-Muster auch auf einen Branch namensmain-menu) und fügeallow_globsoderexcept_patternshinzu, wenn das relevant ist.
Ton
Kurz und sachlich. Dies ist Einrichtungsarbeit, keine Vorlesung über Regeln.
Häufige Fehler
- Schreiben von Dateien oder Einstellungen, bevor der Benutzer die Tabelle überprüft hat.
- Schreiben von
settings.json, ohne den Diff zu zeigen und ein Ja zu bekommen. - Installieren einer Regel, die der Benutzer nicht als Tabellenzeile gesehen hat, oder stillschweigendes Ersetzen des Musters, das der Benutzer verlangt hat.
- Installieren einer Regel, deren Beweis nicht bestanden wurde.
- Befördern einer Geschmacksregel oder Erraten eines Musters für eine vage Regel.
- Erfinden eines Regeltyps, den die Engine nicht hat.
- Weglassen des Falsch-Positiv-Risikos oder des Hinweises "Leitplanke, keine Sicherheitsgrenze".
- Manuelles Bearbeiten einer ungültigen
settings.json, anstatt anzuhalten. - Behaupten einer End-to-End-Blockierung, die du nicht tatsächlich beobachtet hast.