hookify
Avertir ou bloquer un comportement indésirable de l'agent avec de simples règles Markdown (.navin/hookify.<name>.local.md), créées à partir d'une instruction ou de la conversation et vérifiées nativement à chaque action.
Référence
| Champ | Valeur |
|---|---|
| Nom | hookify |
| Version | 1.0.0 |
| Catégorie | Productivité |
| Licence | Aucune valeur |
| Source | catalog/navin/builtin_plugins/hookify/plugin.json |
| README | catalog/navin/builtin_plugins/hookify/README.md |
| Digest | sha256:35024c860a60855bf52a07167b479dd480051b76356763508016e6677969317c |
| plugin.json | agents, category, commands, description, name, skills, steps, version |
Commandes
| Nom | Arguments | Description |
|---|---|---|
/hookify | [behaviour to prevent] | Créer des règles hookify qui avertissent ou bloquent un comportement indésirable de l'agent, à partir de vos instructions ou de la conversation |
/hookify-list | - | Lister les règles hookify de ce projet et de votre dossier personnel, avec leur état |
/hookify-configure | - | Activer ou désactiver des règles hookify existantes via une carte de choix |
/hookify-help | - | Expliquer le fonctionnement des règles hookify et comment les créer, les lister et les configurer |
Agents
| Nom | Outils | Modèle | Description |
|---|---|---|---|
conversation-analyzer | read_file, grep, find_files | inherit | Lit des extraits de conversation et repère les comportements de l'agent que l'utilisateur veut empêcher (corrections, frustration, erreurs répétées), puis transforme chacun en règle hookify prête à l'emploi avec événement, motif regex et sévérité. À utiliser quand /hookify est lancé sans argument, ou quand l'utilisateur demande de relire la conversation et de créer des règles pour les erreurs commises. |
Skills
| Nom | Description |
|---|---|
| hookify-rules | Explique comment écrire des règles hookify, les fichiers Markdown .navin/hookify.<name>.local.md qui avertissent ou bloquent des actions de l'agent (commandes shell, modifications de fichiers, arrêt, prompts utilisateur) par correspondance de motifs regex. |
| hook-development | Écrire des hooks de cycle de vie Navin (hooks.json, PreToolUse, PostToolUse, UserPromptSubmit, SessionStart, Stop, SubagentStop) sous forme de commandes shell qui lisent le JSON de l'événement sur stdin et bloquent, avertissent ou ajoutent du contexte via les codes de sortie et une sortie JSON. |
Hooks, serveurs MCP et réglages
plugin.json ne déclare aucun hook, aucun serveur MCP et aucun réglage : le plugin se compose uniquement des éléments ci-dessus.
Étapes de travail
| Étape | Utiliser |
|---|---|
| créer une règle à partir d'une instruction ou de la conversation | /hookify |
| trouver les comportements que l'utilisateur a corrigés | agent:conversation-analyzer |
| lister les règles et leur état | /hookify-list |
| activer ou désactiver des règles | /hookify-configure |
| expliquer le fonctionnement des règles | /hookify-help |
| écrire ou corriger une règle à la main | skill:hookify-rules |
| écrire un hook shell complet au lieu d'une règle | skill:hook-development |
L'activer dans un projet
Activer hookify crée 8 activations dans le projet : le plugin lui-même, 2 skills, 4 commandes et 1 agent. Retirer l'activation du plugin les retire toutes.
curl -X POST <control-plane-url>/v1/projects/<project>/navin-library/activations \
-H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
-d '{"kind": "plugin", "name": "hookify"}'
<project> : identifiant ou slug du projet. <token> : clé d'API avec le rôle éditeur sur le projet.
client.navin_library.activate("<project>", "plugin", "hookify")