Passer au contenu principal
Afficher en Markdown

Dépannage des hooks

Problèmes courants

Le hook ne se déclenche pas

  • Pour les hooks liés aux fichiers, vérifiez que le modèle de fichier correspond à vos fichiers cibles
  • Vérifiez que le hook est activé (recherchez l'icône en forme d'œil dans le panneau Agent Hooks)
  • Assurez-vous que le type d'événement est correct pour ce que vous essayez d'automatiser
  • Pour les hooks Pre/Post Tool Use, vérifiez que le nom de l'outil correspond à l'outil invoqué

Comportement inattendu du hook

  • Passez en revue les instructions du hook pour en vérifier la clarté
  • Vérifiez l'absence de hooks conflictuels qui pourraient interférer entre eux
  • Vérifiez que les modèles de fichiers ou les correspondances d'outils ne sont pas trop larges
  • Testez le hook avec un cas minimal pour isoler le problème

Problèmes de performance

  • Pour les hooks liés aux fichiers, limitez la portée du hook avec des modèles de fichiers plus précis
  • Pour les hooks avec une action de requête d'agent, simplifiez toute instruction de hook complexe
  • Pour les hooks avec une action de commande shell, assurez-vous que la commande se termine rapidement
  • Réduisez la fréquence des événements déclencheurs
  • Vérifiez que votre paramètre de délai d'expiration est approprié (par défaut : 60 secondes)

Erreurs de commande shell

  • Vérifiez que la commande fonctionne lorsqu'elle est exécutée manuellement dans un terminal
  • Vérifiez que toutes les variables d'environnement requises sont disponibles
  • Assurez-vous que tous les outils ou dépendances externes sont installés
  • Passez en revue la sortie STDERR pour les messages d'erreur
  • Vérifiez le panneau de sortie de Kiro pour les journaux d'exécution des hooks
Page mise à jour : 11 août 2026