Standardizzare il comportamento di Bob
Standardizza il comportamento di Bob nel tuo team utilizzando file di regole a livello di progetto che indicano a Bob di documentare il suo codice e ricordare le sue azioni precedenti.
Le regole di Bob sono file di testo semplici che definiscono istruzioni applicate a ogni conversazione con Bob. Bob memorizza le regole come file in una cartella designata all'interno del progetto o a livello utente globale, e inietta automaticamente il contenuto di ogni file di regole in ogni conversazione attraverso tutte le modalità. L'iniezione di regole consente ai team e ai singoli sviluppatori di applicare standard di codifica, preferenze di comunicazione e vincoli di flusso di lavoro senza ripetere le istruzioni in ogni prompt.
Le regole a livello di progetto in galaxium-travels/.bob sono controllate dalla versione insieme al tuo codice, il che significa:
- Le regole si propagano automaticamente a tutti i membri del team che clonano il repository.
- Le modifiche alle regole passano attraverso il normale processo di revisione del codice.
- La cronologia delle regole è tracciata in git.
In questo tutorial, indichi a Bob di parlare in modo conciso, documentare il suo codice e ricordare le sue azioni precedenti aggiungendo file di regole nella directory .bob. Poiché includerai questi file nel controllo di versione, Bob li applicherà in tutto il tuo team.
Prerequisiti
Per completare questo tutorial, hai bisogno di quanto segue:
- Se non lo hai già, clona il codice demo di Galaxium Travels. Il comando di clonazione verifica anche il branch
bob-learning-path-branchche contiene il codice che usi nei tutorial.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels- Bob IDE con il codice demo di Galaxium Travels aperto
- Completa il tutorial Avviare un progetto per creare la cartella
.bob. - Sebbene non sia obbligatorio, considera di fare il Tutorial di avvio rapido per familiarizzare con l'interfaccia e le funzionalità di Bob.
- Python o Python 3. Puoi scaricare Python dal sito ufficiale.
Creare un file di regole Bob personalizzato
Il comando /init di Bob crea una cartella .bob con file AGENTS.md per ogni modalità di Bob che dirige il comportamento di Bob in ogni modalità. Crea le tue regole personalizzate aggiungendo un nuovo file alla cartella rules. Bob leggerà il contenuto del file di regole, il che significa che le istruzioni che aggiungi si applicheranno a tutte le interazioni con Bob.
Creare la cartella delle regole
Se una cartella rules non esiste già in .bob, creane una.
Creare regole Bob personalizzate
Nel file basic_rules.md, crea regole personalizzate aggiungendo il seguente testo:
Aggiungere una regola di standard di documentazione
Always include concise JSDoc strings for every public function.La regola di standard di documentazione garantisce che Bob generi documentazione coerente ogni volta che Bob scrive o modifica funzioni pubbliche, indipendentemente dall'attività.
Aggiungere una regola di stile di comunicazione
Be very concise in your wording.La regola di stile di comunicazione controlla come Bob formula risposte e commenti, il che è utile per i team che preferiscono output concisi e diretti rispetto a spiegazioni dettagliate.
Aggiungere una regola di monologo interno
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.mdIl monologo interno produce un registro persistente di tutto ciò che Bob ha fatto attraverso tutte le conversazioni.
I vantaggi del monologo interno includono quanto segue:
- Traccia di audit: Una registrazione di quali modifiche ha apportato Bob e quando.
- Continuità tra sessioni: Bob può fare riferimento alla cartella del monologo interno nelle conversazioni future per comprendere il lavoro precedente.
- Trasparenza del team: Nei repository condivisi, il monologo mostra cosa hanno fatto diversi membri del team con Bob.
Una volta aggiunte tutte le regole, il tuo file basic_rules.md apparirà come segue:
Testare le regole
Apri la barra laterale della chat agentica, passa alla modalità Codice ed esegui il seguente prompt per far modificare a Bob il README.md. Bob potrebbe fare suggerimenti come migliorare con una migliore risoluzione dei problemi, revisione completa o correggere imprecisioni. Puoi scegliere il suggerimento che meglio si adatta alla tua visione per il README.
Update the readmeBob aggiorna il README.md e crea una cartella chiamata internal-monologue e crea un file che ti mostra gli aggiornamenti che ha apportato al README.
Prossimi passi
In questo tutorial, hai imparato come le regole di Bob ti permettono di definire istruzioni persistenti che si applicano a ogni conversazione e modalità. Le regole a livello di progetto sono controllate dalla versione insieme al tuo codice, quindi il tuo team condivide automaticamente gli stessi standard. Il pattern del monologo interno ti fornisce una traccia di audit delle azioni di Bob attraverso tutte le sessioni.
Passa a Aggiungere capacità Bob per imparare a creare modalità personalizzate che definiscono personaggi specializzati con istruzioni su misura e accesso specifico agli strumenti.
Aggiungere capacità a Bob
Estendi le capacità lavorative di Bob creando una modalità personalizzata di product manager con una definizione di ruolo su misura, istruzioni comportamentali e vincoli di accesso agli strumenti deterministici.
Esplorare una codebase sconosciuta
Usa IBM Bob per comprendere rapidamente un'applicazione sconosciuta, come il suo scopo, la struttura del progetto, l'architettura, il tech stack, i componenti chiave, la copertura dei test e il modello di distribuzione. Senza dover dipendere da documentazione obsoleta o aspettare i tuoi colleghi.