Communitygithub.com

NarenDawar/narens-claude-skills

Verwenden, wenn der Benutzer möchte, dass Regeln aus CLAUDE.md mit Hooks durchgesetzt werden, wenn Claude scheinbar eine CLAUDE.md-Regel ignoriert, oder wenn darum gebeten wird, CLAUDE.md-Regeln in Hooks umzuwandeln (z. B. 'Wandle meine CLAUDE.md-Regeln in Hooks um' oder 'Sorge dafür, dass Claude keine Migrationen mehr bearbeitet').

Was ist narens-claude-skills?

Der Skill 'Rule Promoter' ist ein Werkzeug für KI-Agenten wie Claude Code, das Regeln aus einer CLAUDE.md-Datei in durchsetzbare Hooks umwandelt. Während CLAUDE.md-Regeln nur als Empfehlungen dienen, die Claude umgehen kann, sorgen Hooks für eine verbindliche Durchsetzung. Der Skill identifiziert zunächst alle Regeln in der CLAUDE.md-Datei des Projekts, klassifiziert sie in durchsetzbare Typen wie 'protected_path', 'blocked_command', 'banned_content' oder 'stop_check', und erstellt eine detaillierte Tabelle mit Mustern, Beispielen für Verstöße und Risiken für Fehlalarme. Nach Genehmigung durch den Benutzer generiert er eine Konfigurationsdatei (rules.json) und ein kleines Python-Testmodul (rule_hook.py), das jede Regel automatisch verifiziert. Ein zentraler Aspekt des Skills ist seine Vorsicht: Er rät niemals bei vagen Regeln, fragt bei Unklarheiten nach, zeigt vor jeder Änderung eine Diff-Ansicht und wartet auf explizite Zustimmung. Hooks werden als Leitplanken bezeichnet, nicht als Sicherheitsgrenze – ein entschlossener Benutzer kann sie umgehen. Der Skill unterstützt Claude Code und ähnliche KI-Agenten-Plattformen und erfordert Python 3. Der Workflow umfasst sieben Schritte: Lesen der Regeln, Klassifizieren, Vorlage zur Überprüfung mit Tabelle, Beweisen jeder Regel durch automatische Tests, Installieren der Hooks, eine optionale End-to-End-Überprüfung und einen abschließenden Bericht. Der Skill fügt niemals automatisch Änderungen hinzu, ohne dass der Benutzer diese zuvor gesehen und bestätigt hat, und er warnt, wenn er keine verschachtelte Sitzung ausführen kann, um die Hooks vollständig zu testen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NarenDawar/narens-claude-skills/tree/HEAD/plugins/rule-promoter/skills/rule-promoter

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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.py in das Projekt. python rule_hook.py selftest beweist jede Regel; check ist der Hook-Einstiegspunkt.
  • scripts/settings_merge.py: launcher wählt einen Python-Befehl aus, der funktioniert; plan zeigt den Einstellungs-Diff; apply schreibt ihn.

Führe beide mit einem Python 3-Befehl aus, der auf diesem Rechner funktioniert (versuche python3, python, py -3). Zitiere Pfade.

Prozess

  1. Lesen. Finde CLAUDE.md, .claude/CLAUDE.md und CLAUDE.local.md im Projekt. Liste jede Regel mit ihrer Datei und Zeile auf. Wenn es keine gibt, sage das und höre auf.

  2. 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 Eingabe und frage; errate niemals ein Muster für eine vage Regel. Erfinde niemals einen Regeltyp.

  3. Ü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.

  4. Beweisen. Nach der Zustimmung, erstelle .claude/hooks/ und kopiere scripts/rule_hook.py dorthin, schreibe .claude/rules.json, führe dann python .claude/hooks/rule_hook.py selftest vom Projektstamm aus. Zeige die Ausgabe. Eine Regel, deren Beweis fehlschlägt, wird nicht installiert: Korrigiere ihr Muster oder entferne sie, und sage welche.

  5. Installieren. Führe settings_merge.py launcher --script .claude/hooks/rule_hook.py aus, dann settings_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 mit apply aus. 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 eigenen rule_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, obwohl selftest bestanden hat und disableAllHooks nicht gesetzt ist, haben einige Claude Code-Versionen keine Exec-Form-args: führe plan und apply erneut mit --shell-form aus.

  6. End-to-End-Überprüfung. Wenn du claude -p im Projekt ausführen kannst, teste mit einer protected_path- oder banned_content-Regel gegen eine Wegwerfdatei (z. B. bitte sie, eine Datei tmp-rule-check.txt unter einem geschützten Glob zu bearbeiten), niemals mit einem blocked_command oder stop_check, der wirklich etwas ausführen würde, und mache jede Änderung danach rückgängig. Überprüfe disableAllHooks in den Projekt-, Lokal- und Benutzereinstellungen, bevor du Schlussfolgerungen ziehst. Bestätige, dass die Ausgabe die Regel <id>:-Blocknachricht zeigt, und zeige sie. Wenn du keine verschachtelte Sitzung ausführen kannst, sage das und sage, dass die Installation nur durch selftest verifiziert ist.

  7. 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.json bearbeiten. Biete an, eine protected_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": false für eine Regel in .claude/rules.json, oder lösche die rule_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_seconds ist maximal 280, und enabled muss true oder false sein.
  • Bevorzuge enge Muster. Gib das Falsch-Positiv-Risiko für jede Regel an (z. B. passt ein main-Muster auch auf einen Branch namens main-menu) und füge allow_globs oder except_patterns hinzu, 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.

Verwandte Skills