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.
- 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 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
- 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é
- 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
- 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.
- 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
- Maintenez une documentation claire des objectifs des Hooks
- Incluez des exemples de comportement attendu
- Documentez toute limitation ou cas limite
- 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
- 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
- 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
Meilleures pratiques