hookify-règles

Écrire des règles Hookify

Présentation

Les règles Hookify sont des fichiers Markdown avec un préambule YAML qui définissent des motifs à surveiller et des messages à afficher lorsque ces motifs correspondent. Les règles sont stockées dans des fichiers .claude/hookify.{nom-de-la-règle}.local.md.

Format du fichier de règle

Structure de base

---
name: identifiant-de-la-règle
enabled: true
event: bash|file|stop|prompt|all
pattern: motif-regex-ici
---

Message à afficher à Claude lorsque cette règle se déclenche.
Peut inclure du formatage Markdown, des avertissements, des suggestions, etc.

Champs du préambule

Champ	Requis	Valeurs	Description
name	Oui	chaîne kebab-case	Identifiant unique (verbe en premier : warn-, block-, require-*)
enabled	Oui	true/false	Activer/désactiver sans supprimer
event	Oui	bash/file/stop/prompt/all	Quel événement hook déclenche cette règle
action	Non	warn/block	warn (défaut) affiche un message ; block empêche l’opération
pattern	Oui*	chaîne regex	Motif à rechercher (*ou utiliser conditions pour les règles complexes)

Format avancé (conditions multiples)

---
name: warn-env-api-keys
enabled: true
event: file
conditions:
  - field: file_path
    operator: regex_match
    pattern: \.env$
  - field: new_text
    operator: contains
    pattern: API_KEY
---

Vous ajoutez une clé API dans un fichier .env. Assurez-vous que ce fichier est dans .gitignore !

Champs condition selon l’événement :

• bash : command
• file : file_path, new_text, old_text, content
• prompt : user_prompt

Opérateurs : regex_match, contains, equals, not_contains, starts_with, ends_with

Toutes les conditions doivent correspondre pour que la règle se déclenche.

Guide des types d’événements

Événements bash

Correspond aux motifs de commandes Bash :

• Commandes dangereuses : rm\s+-rf, dd\s+if=, mkfs
• Élévation de privilèges : sudo\s+, su\s+
• Problèmes de permissions : chmod\s+777

Événements file

Correspond aux opérations d’édition/écriture/modifications multiples :

• Code de débogage : console\.log\(, debugger
• Risques de sécurité : eval\(, innerHTML\s*=
• Fichiers sensibles : \.env$, credentials, \.pem$

Événements stop

Vérifications de fin et rappels. Le motif .* correspond toujours.

Événements prompt

Correspond au contenu de l’invite utilisateur pour l’application des workflows.

Conseils pour l’écriture des motifs

Bases des expressions régulières

• Échapper les caractères spéciaux : . en \., ( en \(
• \s espace, \d chiffre, \w caractère de mot
• + un ou plusieurs, * zéro ou plusieurs, ? optionnel
• | opérateur OU

Pièges courants

• Trop large : log correspond à "login", "dialog" — utilisez console\.log\(
• Trop spécifique : rm -rf /tmp — utilisez rm\s+-rf
• Échappement YAML : utilisez des motifs non quotés ; les chaînes entre guillemets nécessitent \\s

Test

python3 -c "import re; print(re.search(r'votre_motif', 'texte test'))"

Organisation des fichiers

• Emplacement : répertoire .claude/ à la racine du projet
• Nommage : .claude/hookify.{nom-descriptif}.local.md
• Gitignore : Ajoutez .claude/*.local.md au fichier .gitignore

Commandes

• /hookify [description] - Crée de nouvelles règles (analyse automatique de la conversation si aucun argument)
• /hookify-list - Affiche toutes les règles sous forme de tableau
• /hookify-configure - Active/désactive les règles de manière interactive
• /hookify-help - Documentation complète

Référence rapide

Règle minimale :

---
name: ma-règle
enabled: true
event: bash
pattern: commande_dangereuse
---
Message d’avertissement ici