Standardiser le comportement de Bob
Standardisez le comportement de Bob dans votre équipe en utilisant des fichiers de règles au niveau du projet qui indiquent à Bob de documenter son code et de se souvenir de ses actions précédentes.
Les règles de Bob sont des fichiers texte simples qui définissent des instructions appliquées à chaque conversation avec Bob. Bob stocke les règles sous forme de fichiers dans un dossier désigné au sein du projet ou au niveau utilisateur global, et injecte automatiquement le contenu de chaque fichier de règles dans chaque conversation à travers tous les modes. L'injection de règles permet aux équipes et aux développeurs individuels d'appliquer des normes de codage, des préférences de communication et des contraintes de flux de travail sans répéter les instructions à chaque invite.
Les règles au niveau du projet dans galaxium-travels/.bob sont versionnées avec votre code, ce qui signifie :
- Les règles se propagent automatiquement à tous les membres de l'équipe qui clonent le dépôt.
- Les modifications des règles passent par le processus normal de révision de code.
- L'historique des règles est suivi dans git.
Dans ce tutoriel, vous indiquez à Bob de parler de manière concise, de documenter son code et de se souvenir de ses actions précédentes en ajoutant des fichiers de règles dans le répertoire .bob. Parce que vous inclurez ces fichiers dans le contrôle de version, Bob les appliquera dans toute votre équipe.
Prérequis
Pour compléter ce tutoriel, vous avez besoin des éléments suivants :
- Si vous ne l'avez pas déjà, clonez le code de démonstration Galaxium Travels. La commande de clonage extrait également la branche
bob-learning-path-branchqui contient le code que vous utilisez dans les tutoriels.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels- Bob IDE avec le code de démonstration Galaxium Travels ouvert
- Complétez le tutoriel Démarrer un projet pour créer le dossier
.bob. - Bien que non obligatoire, envisagez de faire le Tutoriel de démarrage rapide pour vous familiariser avec l'interface et les fonctionnalités de Bob.
- Python ou Python 3. Vous pouvez télécharger Python depuis le site officiel.
Créer un fichier de règles Bob personnalisé
La commande /init de Bob crée un dossier .bob avec des fichiers AGENTS.md pour chaque mode de Bob qui dirige le comportement de Bob dans chaque mode. Créez vos propres règles personnalisées en ajoutant un nouveau fichier au dossier rules. Bob lira le contenu du fichier de règles, ce qui signifie que les instructions que vous ajoutez s'appliqueront à toutes les interactions avec Bob.
Créer le dossier de règles
Si un dossier rules n'existe pas déjà dans .bob, créez-en un.
Créer des règles Bob personnalisées
Dans le fichier basic_rules.md, créez des règles personnalisées en ajoutant le texte suivant :
Ajouter une règle de norme de documentation
Always include concise JSDoc strings for every public function.La règle de norme de documentation garantit que Bob génère une documentation cohérente chaque fois que Bob écrit ou modifie des fonctions publiques, quelle que soit la tâche.
Ajouter une règle de style de communication
Be very concise in your wording.La règle de style de communication contrôle la façon dont Bob formule les réponses et les commentaires, ce qui est utile pour les équipes qui préfèrent des résultats concis et directs plutôt que des explications détaillées.
Ajouter une règle de monologue interne
Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.mdLe monologue interne produit un journal persistant de tout ce que Bob a fait à travers toutes les conversations.
Les avantages du monologue interne incluent les éléments suivants :
- Piste d'audit : Un enregistrement des modifications apportées par Bob et du moment où elles ont été effectuées.
- Continuité inter-sessions : Bob peut référencer le dossier de monologue interne dans les conversations futures pour comprendre le travail antérieur.
- Transparence d'équipe : Dans les dépôts partagés, le monologue montre ce que différents membres de l'équipe ont fait avec Bob.
Une fois que vous avez ajouté toutes les règles, votre fichier basic_rules.md ressemblera à ceci :
Tester les règles
Ouvrez la barre latérale de chat agentique, passez en mode Code et exécutez l'invite suivante pour que Bob modifie le README.md. Bob peut faire des suggestions telles qu'améliorer avec un meilleur dépannage, une refonte complète ou corriger des inexactitudes. Vous pouvez choisir la suggestion qui correspond le mieux à votre vision du README.
Update the readmeBob met à jour le README.md et crée un dossier appelé internal-monologue et crée un fichier qui vous montre les mises à jour qu'il a apportées au README.
Prochaines étapes
Dans ce tutoriel, vous avez appris comment les règles de Bob vous permettent de définir des instructions persistantes qui s'appliquent à chaque conversation et mode. Les règles au niveau du projet sont versionnées avec votre code, de sorte que votre équipe partage automatiquement les mêmes normes. Le modèle de monologue interne vous fournit une piste d'audit des actions de Bob à travers toutes les sessions.
Passez à Ajouter des capacités Bob pour apprendre à créer des modes personnalisés qui définissent des personas spécialisés avec des instructions sur mesure et un accès spécifique aux outils.
Ajouter des capacités à Bob
Étendez les capacités professionnelles de Bob en créant un mode personnalisé de chef de produit avec une définition de rôle sur mesure, des instructions comportementales et des contraintes d'accès aux outils déterministes.
Inspecter une base de code inconnue
Utilise IBM Bob pour comprendre rapidement une application inconnue, notamment son objectif, la structure du projet, l'architecture, le tech stack, les composants clés, la couverture de tests et le modèle de déploiement. Sans dépendre d'une documentation obsolète ni attendre tes coéquipiers.