Inicio / Extender: habilidades, MCP, subagentes, hooks, plugins

Hooks: automatizar el ciclo de vida

Un hook es una acción que el arnés ejecuta él mismo ante un evento preciso del ciclo de vida, nunca una preferencia confiada al modelo esperando que la recuerde.

Un hook es una acción que el arnés ejecuta él mismo cuando ocurre un evento preciso del ciclo de vida, nunca una petición que el modelo interpreta en el momento de actuar. Escribir en un archivo de memoria cada vez que haces un commit, lanzas los tests, sigue siendo una preferencia: el modelo puede olvidarla después de una conversación larga o una compactación. Un hook declarado sobre el evento correspondiente se ejecuta en cada ocurrencia, independientemente de lo que el modelo recuerde en ese instante.

El mecanismo: un evento, un comando, una decisión

Un hook se declara en settings.json, o en el archivo hooks.json de un plugin, asociado a un evento del ciclo de vida y a un tipo de acción: un comando de shell, una llamada HTTP, una herramienta MCP, una instrucción o un agente. Cuando el evento ocurre, el arnés ejecuta esa acción y espera a cambio una decisión, antes de que la cuestión llegue al modelo.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "./verifier-avant-commande.sh" }
        ]
      }
    ]
  }
}

Esta declaración asocia el evento PreToolUse, restringido a las llamadas de la herramienta Bash, a un script que se ejecuta antes de cada comando propuesto. Cada tipo de hook tiene su propio plazo de expiración por defecto, distinto según el evento que lo dispara: la lección siguiente detalla esos plazos evento por evento, así como los campos JSON precisos que un hook devuelve para bloquear, autorizar o enriquecer lo que ve el modelo.

Hook contra regla de memoria: qué garantiza realmente cada uno

Una regla de memoria depende de un modelo que la relee y decide aplicarla, en una ventana de contexto que crece a lo largo de la sesión. Un hook depende del arnés, que verifica el evento independientemente de lo que contenga la conversación en ese instante. La diferencia se nota sobre todo en una sesión larga: una instrucción repetida veinte veces en un archivo de memoria puede diluirse en un contexto cargado, mientras que un hook declarado una sola vez sigue ejecutándose de forma idéntica en la llamada número mil igual que en la primera.

Traducir un automatismo deseado en un hook en lugar de en una nota de memoria es, por tanto, menos una cuestión de estilo que una cuestión de fiabilidad mecánica: uno depende de una lectura atenta del modelo, el otro de un evento que el propio arnés constata.