Passer au contenu principal
Afficher en Markdown

Hooks

Aperçu

Les Hooks utilisent un schéma JSON défini dans des fichiers autonomes situés à .kiro/hooks/*.json. Cela remplace le format .kiro.hook de l'IDE précédent par un schéma structuré et validé, partagé avec la CLI — le même fichier de hook fonctionne sur toutes les surfaces.

json
{ "version": "v1", "hooks": [ { "name": "format-on-save", "trigger": "PostFileSave", "matcher": "\\.ts$", "action": { "type": "command", "command": "prettier --write {{filePath}}" } } ] }

Détails du schéma

ChampRequisDescription
versionOuiVersion du schéma — actuellement "v1"
hooks[].nameOuiIdentifiant unique du hook
hooks[].triggerOuiNom du déclencheur d'événement en PascalCase (voir le tableau ci-dessous)
hooks[].matcherNonMotif regex comparé au sujet de l'événement
hooks[].action.typeOuiType d'action : command ou agent
hooks[].action.commandCond.Commande shell à exécuter (lorsque action.type: "command")
hooks[].action.promptCond.Requête de l'agent à injecter (lorsque action.type: "agent")

Déclencheurs disponibles

DéclencheurSe déclenche quandLe matcher correspond àPeut bloquer?
SessionStartLa session commence—Non
StopL'exécution de l'agent se termine—Non
UserPromptSubmitVous envoyez un messageLe texte de la requêteOui
PreTaskExecAvant le début d'une tâche de spec—Oui
PostTaskExecAprès la fin d'une tâche de spec—Non
PreToolUseAvant l'exécution d'un outilLe nom de l'outilOui
PostToolUseAprès l'exécution d'un outilLe nom de l'outilNon
PostFileCreateUn nouveau fichier est créé par l'agentLe chemin du fichierNon
PostFileSaveUn fichier est enregistré ou modifié par l'agentLe chemin du fichierNon
PostFileDeleteUn fichier est supprimé par l'agentLe chemin du fichierNon

Blocage : une action command qui se termine avec le code de sortie 2 bloque l'événement déclencheur (PreToolUse, UserPromptSubmit, PreTaskExec). Utilisez ceci pour l'application de politiques — par exemple, bloquer les écritures dans les fichiers *.env. Tout autre code de sortie non nul est traité comme une erreur, pas comme un blocage.

Migration depuis les noms de déclencheurs 0.x

Les anciens noms de déclencheurs .kiro.hook correspondent directement aux nouveaux déclencheurs en PascalCase :

Ancien (when.type)Nouveau (trigger)
agentSpawnSessionStart
agentStopStop
promptSubmitUserPromptSubmit
preToolUsePreToolUse
postToolUsePostToolUse
fileCreatedPostFileCreate
fileEditedPostFileSave
fileDeletedPostFileDelete
preTaskExecutionPreTaskExec
postTaskExecutionPostTaskExec
userTriggeredRemplacé par des fichiers de steering manuels — voir ci-dessous

Vos motifs regex se transfèrent directement; la structure when/then devient trigger/matcher/action. L'IDE migre les hooks pour vous : ouvrez le panneau Agent Hooks et cliquez sur l'insigne de mise à niveau sur chaque hook hérité.

Les hooks manuels (l'ancien déclencheur userTriggered) sont remplacés par des fichiers de steering manuels — des fichiers markdown dans .kiro/steering/ invoqués comme des commandes barre oblique /<filename>. Voir Steering.

Types d'action

  • command — exécute un sous-processus; reçoit le contexte JSON sur stdin. La variable de gabarit {{filePath}} est disponible pour les déclencheurs liés aux fichiers.
  • agent — injecte une requête dans le contexte de l'agent au moment du déclenchement. Utilisez ceci pour ajouter du steering conditionnel (par exemple, « Un fichier de test a été enregistré — vérifiez la couverture »). Contrairement à command, cela ne peut pas bloquer le déclencheur.

Pour la référence complète (sémantique des codes de sortie, charges utiles stdin, hooks globaux dans ~/.kiro/hooks/), voir Hooks.

Page mise à jour : 11 août 2026