Segui queste linee guida per ottenere il massimo dalla tua esperienza con Bob Shell.

Comprendere e usare le modalità

Le modalità di Bob sono persona specifiche per task che modellano il suo comportamento. Selezionare la modalità appropriata ti aiuta a ottenere i migliori risultati.

Modalità integrate

Bob Shell viene fornito con tre modalità integrate, ciascuna progettata per scopi specifici:

Modalità	Scopo	Quando usarla
Agent	Scrittura e modifica del codice	Per implementare funzionalità, correggere bug o apportare miglioramenti al codice
Plan	Pianificazione e progettazione	Prima dell'implementazione, quando hai bisogno di pianificare l'architettura o creare specifiche tecniche
Ask	Ottenere informazioni	Quando hai bisogno di spiegazioni o informazioni senza modificare file

Strategia di selezione della modalità

Per il flusso di lavoro più efficace:

Inizia con la modalità Plan per nuovi progetti o funzionalità complesse per creare un piano di implementazione dettagliato prima di scrivere qualsiasi codice. Leggi attentamente il piano per verificare che sia allineato con il tuo obiettivo.

Passa alla modalità Agent per la maggior parte dei task di sviluppo quotidiani quando sei pronto per implementare.

Usa la modalità Ask quando hai bisogno di spiegazioni o informazioni senza modificare file.

Cambia modalità in una sessione bob chat digitando /mode agent, /mode plan, o /mode ask. Per ulteriori dettagli, consulta Modalità.

Modalità personalizzate

Puoi creare modalità specializzate per task o flussi di lavoro specifici:

Crea modalità per task specializzati come revisioni di sicurezza o scrittura di documentazione.

Configura modalità personalizzate con permessi di accesso agli strumenti specifici e definizioni di ruolo.

Condividi le modalità con il tuo team per standardizzare i flussi di lavoro.

Scopri di più sulla creazione e configurazione di modalità personalizzate nella documentazione delle Modalità personalizzate.

Ottimizzazione del flusso di lavoro

Pianifica prima di scrivere codice

Inizia sempre progetti o funzionalità complesse in modalità Plan per:

Generare un piano di implementazione dettagliato.

Suddividere i problemi complessi in passi gestibili.

Identificare le potenziali sfide prima che si presentino.

Creare una roadmap per l'implementazione.

Questo approccio previene le breaking change e fornisce una direzione chiara per lo sviluppo.

Usa git come rete di sicurezza

Esegui il commit del tuo lavoro frequentemente in modo da poter recuperare da modifiche indesiderate:

Crea commit frequenti e piccoli con messaggi chiari.

Fai il push delle modifiche ai repository remoti regolarmente.

Usa branch per le funzionalità sperimentali.

Se Bob produce risultati scadenti, tornare a un commit precedente è più efficace che cercare di correggere l'output difettoso con nuove istruzioni. Avvia una nuova sessione bob chat dopo il ripristino in modo che l'output errato non sia più nel contesto.

Monitora l'utilizzo e ottimizza i costi

Tieni traccia del consumo di Bobcoins esaminando l'utilizzo del tuo account. Presta attenzione alla dimensione della finestra di contesto — le conversazioni lunghe consumano più token e quindi più Bobcoins.

Integra con il controllo di versione

Git fornisce una rete di sicurezza essenziale per prevenire l'eliminazione accidentale e permanente del codice. Esegui il commit regolarmente prima e dopo modifiche significative assistite dall'AI.

Strategie di comunicazione

Scrivi prompt efficaci

La qualità dei tuoi prompt influisce direttamente sulla qualità delle risposte di Bob:

Sii specifico e chiaro: I prompt vaghi portano a output vaghi. Dettaglia cosa Bob dovrebbe e non dovrebbe fare.

Fornisci esempi: Quando possibile, includi esempi del formato o dello stile di output desiderato.

Usa le menzioni di contesto

Le menzioni di contesto ti consentono di fare riferimento a elementi specifici del tuo progetto direttamente nelle tue conversazioni con Bob Shell:

Usa @/path/to/file.js per includere contenuti di file specifici.

Usa @/path/to/folder per includere tutti i file in una directory.

bob chat

# Fai riferimento a un file specifico
> Spiega cosa fa @src/utils.js e come funziona

# Fai riferimento a una directory
> Esamina i test in @tests/ e identifica eventuali lacune

Questo approccio è più efficiente del copia-incolla del codice o della descrizione delle posizioni dei file.

Gestisci la finestra di contesto

Bob ha una finestra di contesto di 270.000 token, che include la cronologia della conversazione, i contenuti dei file e l'output degli strumenti. Per usarla efficacemente:

Avvia nuove sessioni bob chat regolarmente con obiettivi specifici.

Evita di fornire a Bob l'intero codebase in una volta.

Usa riferimenti diretti ai file per fornire contesto mirato.

Suddividi i task complessi in sotto-task più piccoli e focalizzati.

Consulta Gestione della finestra di contesto per una spiegazione più approfondita di come funziona la finestra di contesto e le strategie per gestirla.

Sicurezza e controllo

Configura le impostazioni di auto-approvazione

Bob Shell ti consente di controllare quali azioni richiedono la tua approvazione prima di essere eseguite:

Approvazione manuale: Esamina e approva ogni azione di Bob (impostazione più sicura).

Auto-approvazione: Concedi a Bob la capacità di eseguire task specifici senza interruzioni.

Approccio ibrido: Auto-approva le azioni a basso rischio richiedendo la conferma per le azioni più rischiose.

Comandi auto-approvati: Definisci un elenco di comandi attendibili che Bob può eseguire senza richiedere l'approvazione ogni volta.

Configura queste impostazioni in ~/.bob/settings/settings.json in base al tuo livello di comfort e alla sensibilità del tuo progetto.

Scopri di più sulle impostazioni di auto-approvazione nella documentazione Auto-approvazione delle azioni.

Usa .bobignore

Il file .bobignore ti consente di specificare file e directory a cui Bob non dovrebbe accedere o modificare:

Crea un file .bobignore nella root del tuo progetto.

Aggiungi pattern per file sensibili, artefatti di build e asset di grandi dimensioni.

Usa la stessa sintassi di .gitignore.

Questo aiuta a proteggere le informazioni sensibili e a prevenire modifiche accidentali ai file generati.

Scopri di più sul controllo dell'accesso ai file nella documentazione Ignorare file.

Per informazioni più dettagliate sulle linee guida di sicurezza, consulta Linee guida di sicurezza.

Configura le regole

Bob ti consente di specificare regole per controllare come Bob esegue i task:

Definisci regole globalmente o per progetto nella directory .bob.

Crea regole specifiche per modalità nelle directory .bob/rules-{mode-slug}/.

Usa le regole per applicare standard di codifica, requisiti di documentazione o altri vincoli del flusso di lavoro.

Per ulteriori informazioni sulle modalità personalizzate e le regole, consulta la documentazione delle Modalità personalizzate.

Best practice