Passer au contenu principal
Afficher en Markdown

Meilleures pratiques

Suivre ces meilleures pratiques vous aidera à créer des Hooks fiables, efficaces et faciles à maintenir qui améliorent votre flux de travail de développement.

Conception des Hooks

Soyez précis et clair

  • Lorsque vous utilisez une action de requête d'agent, rédigez des instructions détaillées et sans ambiguïté pour l'agent
  • Concentrez-vous sur une tâche spécifique par Hook
  • Utilisez des étapes numérotées pour les opérations complexes

Testez en profondeur

  • Testez les Hooks avec des scénarios d'exemple avant de les déployer
  • Vérifiez que les Hooks fonctionnent avec les cas limites
  • Pour les Hooks liés aux fichiers, commencez avec des modèles de fichiers limités avant d'élargir

Surveillez la performance

  • Assurez-vous que les Hooks ne ralentissent pas votre flux de travail
  • Tenez compte de la fréquence des événements déclencheurs
  • Optimisez les requêtes pour plus d'efficacité

Considérations de sécurité

Validez les entrées

  • Assurez-vous que les Hooks gèrent le contenu inattendu de manière appropriée
  • Tenez compte des cas limites potentiels
  • Testez avec des entrées malformées ou inattendues

Limitez la portée

  • Pour les Hooks liés aux fichiers, ciblez des types de fichiers ou des répertoires spécifiques lorsque c'est possible
  • Utilisez des modèles de fichiers précis pour éviter les exécutions inutiles
  • Tenez compte de l'impact des Hooks sur l'ensemble de votre base de code

Utilisez des modèles glob de fichiers spécifiques (par exemple, src/**/*.ts) plutôt que des modèles généraux qui correspondent à tout.

Révisez régulièrement

  • Mettez à jour la logique des Hooks à mesure que votre projet évolue
  • Supprimez les Hooks qui ne sont plus nécessaires
  • Affinez les requêtes en fonction des résultats réels

Collaboration d'équipe

Documentez les Hooks

  • Maintenez une documentation claire des objectifs des Hooks
  • Incluez des exemples de comportement attendu
  • Documentez toute limitation ou cas limite

Partagez les configurations

  • Utilisez des Hooks cohérents entre les membres de l'équipe
  • Stockez les configurations des Hooks dans le contrôle de version
  • Créez des Hooks standards pour les flux de travail courants de l'équipe

Intégration au contrôle de version

  • Envisagez des Hooks qui s'intègrent à votre système de contrôle de version
  • Créez des Hooks pour les flux de travail de révision de code
  • Utilisez des Hooks pour faire respecter les normes de l'équipe

Conseils de performance

  • Utilisez des modèles de fichiers spécifiques pour réduire les exécutions inutiles de Hooks
  • Gardez les instructions de requête d'agent concises pour minimiser le temps de réponse
  • Définissez des délais d'expiration appropriés pour les actions de commande shell (par défaut : 60 secondes)
  • Privilégiez les actions de commande shell pour les tâches déterministes - elles sont plus rapides et ne consomment pas de crédits
Page mise à jour : 11 août 2026