Bonnes pratiques

Suivez ces directives pour tirer le meilleur parti de votre expérience avec Bob Shell.

Comprendre et utiliser les modes

Les modes de Bob sont des personas spécifiques à des tâches qui façonnent son comportement. Choisir le mode approprié vous aide à obtenir les meilleurs résultats.

Modes intégrés

Bob Shell est livré avec trois modes intégrés, chacun conçu pour des objectifs spécifiques :

ModeObjectifQuand l'utiliser
AgentÉcrire et modifier du codePour implémenter des fonctionnalités, corriger des bugs ou apporter des améliorations au code
PlanPlanifier et concevoirAvant l'implémentation, quand vous avez besoin de planifier l'architecture ou de créer des spécifications techniques
AskObtenir des informationsQuand vous avez besoin d'explications ou d'informations sans modifier des fichiers

Stratégie de sélection de mode

Pour le workflow le plus efficace :

Commencez avec le mode Plan pour les nouveaux projets ou les fonctionnalités complexes afin de créer un plan d'implémentation détaillé avant d'écrire du code. Lisez attentivement le plan pour vous assurer qu'il correspond à votre objectif.

Passez au mode Agent pour la plupart des tâches de développement quotidiennes lorsque vous êtes prêt à implémenter.

Utilisez le mode Ask quand vous avez besoin d'explications ou d'informations sans modifier des fichiers.

Changez de mode dans une session bob chat en tapant /mode agent, /mode plan ou /mode ask. Pour plus de détails, consultez Modes.

Modes personnalisés

Vous pouvez créer des modes spécialisés pour des tâches ou workflows spécifiques :

  • Créez des modes pour des tâches spécialisées comme les revues de sécurité ou la rédaction de documentation.
  • Configurez des modes personnalisés avec des permissions d'accès aux outils et des définitions de rôle spécifiques.
  • Partagez les modes avec votre équipe pour standardiser les workflows.

Apprenez-en plus sur la création et la configuration de modes personnalisés dans la documentation Modes personnalisés.

Optimisation du workflow

Planifier avant de coder

Commencez toujours les projets ou fonctionnalités complexes en mode Plan pour :

  • Générer un plan d'implémentation détaillé.
  • Décomposer les problèmes complexes en étapes gérables.
  • Identifier les défis potentiels avant qu'ils ne surviennent.
  • Créer une feuille de route pour l'implémentation.

Cette approche prévient les changements cassants et fournit une direction claire pour le développement.

Utiliser git comme filet de sécurité

Committez votre travail fréquemment pour pouvoir récupérer des changements indésirables :

  • Créez des commits fréquents et petits avec des messages clairs.
  • Poussez les changements vers des dépôts distants régulièrement.
  • Utilisez des branches pour les fonctionnalités expérimentales.

Si Bob produit des résultats médiocres, revenir à un commit précédent est plus efficace que d'essayer de corriger une sortie défectueuse avec de nouvelles instructions. Démarrez une nouvelle session bob chat après avoir revert pour que la mauvaise sortie ne soit plus dans le contexte.

Surveiller l'utilisation et optimiser les coûts

Suivez votre consommation de Bobcoins en consultant l'utilisation de votre compte. Soyez attentif à la taille de la fenêtre de contexte — les longues conversations consomment plus de tokens et donc plus de Bobcoins.

Intégrer avec le contrôle de version

Git fournit un filet de sécurité essentiel pour éviter la suppression accidentelle et permanente de code. Committez régulièrement avant et après les changements importants assistés par IA.

Stratégies de communication

Écrire des prompts efficaces

La qualité de vos prompts affecte directement la qualité des réponses de Bob :

  • Soyez précis et clair : Des prompts vagues mènent à des résultats vagues. Détaillez ce que Bob doit et ne doit pas faire.
  • Fournissez des exemples : Quand c'est possible, incluez des exemples du format ou du style de sortie souhaité.

Utiliser les mentions de contexte

Les mentions de contexte vous permettent de référencer des éléments spécifiques de votre projet directement dans vos conversations avec Bob Shell :

  • Utilisez @/chemin/vers/fichier.js pour inclure le contenu d'un fichier spécifique.
  • Utilisez @/chemin/vers/dossier pour inclure tous les fichiers d'un répertoire.
bob chat

# Référencer un fichier spécifique
> Explique ce que fait @src/utils.js et comment ça fonctionne

# Référencer un répertoire
> Examine les tests dans @tests/ et identifie les lacunes

Cette approche est plus efficace que de copier-coller du code ou de décrire les emplacements des fichiers.

Gérer la fenêtre de contexte

Bob dispose d'une fenêtre de contexte de 270 000 tokens, qui inclut votre historique de conversation, le contenu des fichiers et la sortie des outils. Pour l'utiliser efficacement :

  • Démarrez de nouvelles sessions bob chat régulièrement avec des objectifs spécifiques.
  • Évitez de donner à Bob toute votre base de code d'un coup.
  • Utilisez des références directes aux fichiers pour fournir un contexte ciblé.
  • Décomposez les tâches complexes en sous-tâches plus petites et focalisées.

Consultez Gestion de la fenêtre de contexte pour une explication approfondie du fonctionnement de la fenêtre de contexte et des stratégies pour la gérer.

Sécurité et contrôle

Configurer les paramètres d'approbation automatique

Bob Shell vous permet de contrôler quelles actions nécessitent votre approbation avant de s'exécuter :

  • Approbation manuelle : Examinez et approuvez chaque action de Bob (paramètre le plus sûr).
  • Approbation automatique : Accordez à Bob la capacité d'exécuter des tâches spécifiques sans interruption.
  • Approche hybride : Approuvez automatiquement les actions à faible risque tout en exigeant une confirmation pour les tâches plus risquées.
  • Commandes auto-approuvées : Définissez une liste de commandes de confiance que Bob peut exécuter sans demander d'approbation à chaque fois.

Configurez ces paramètres dans ~/.bob/settings/settings.json selon votre niveau de confort et la sensibilité de votre projet.

Apprenez-en plus sur les paramètres d'approbation automatique dans la documentation Approbation automatique des actions.

Utiliser .bobignore

Le fichier .bobignore vous permet de spécifier les fichiers et répertoires auxquels Bob ne doit pas accéder ni modifier :

Créez un fichier .bobignore à la racine de votre projet.

Ajoutez des modèles pour les fichiers sensibles, les artefacts de build et les ressources volumineuses.

Utilisez la même syntaxe que .gitignore.

Cela aide à protéger les informations sensibles et à prévenir les modifications accidentelles des fichiers générés.

Apprenez-en plus sur le contrôle d'accès aux fichiers dans la documentation Ignorer des fichiers.

Pour des informations plus détaillées sur les directives de sécurité, consultez Directives de sécurité.

Configurer des règles

Bob vous permet de spécifier des règles pour contrôler comment Bob effectue les tâches :

  • Définissez des règles globalement ou par projet dans le répertoire .bob.
  • Créez des règles spécifiques aux modes dans les répertoires .bob/rules-{mode-slug}/.
  • Utilisez les règles pour imposer des standards de codage, des exigences de documentation ou d'autres contraintes de workflow.

Pour plus d'informations sur les modes personnalisés et les règles, consultez la documentation Modes personnalisés.

Comment trouvez-vous ce sujet ?