Creare e usare skill
Crea una skill riutilizzabile che insegna a Bob un workflow ripetibile per le voci di changelog, poi invocala esplicitamente e lascia che Bob la attivi automaticamente.
Una skill è un insieme di istruzioni riutilizzabile che insegna a Bob un workflow specializzato e ripetibile. Invece di riscrivere le stesse regole di formattazione o checklist in ogni prompt, definisci il workflow una volta sola in un file SKILL.md. Bob segue poi quelle istruzioni ogni volta che la skill si applica, che tu la invochi direttamente o che Bob la attivi da solo.
In questo tutorial, crei una skill che aggiunge voci a un file CHANGELOG.md usando il formato Keep a Changelog, creando il file se non esiste ancora. Invochi la skill esplicitamente con un comando slash, poi fai una seconda modifica e chiedi a Bob di registrarla senza nominare la skill, per vedere Bob attivarla automaticamente in base alla sua descrizione.
Prerequisiti
Per completare questo tutorial, hai bisogno di:
- Se non ce l'hai ancora, clona il codice dimostrativo Galaxium Travels.
git clone https://github.com/IBM/galaxium-travels- Bob IDE con il codice dimostrativo Galaxium Travels aperto.
- Sebbene non obbligatorio, considera di completare prima Avviare un progetto con /init e AGENTS.md e Scrivere prompt efficaci per Bob.
Creare una skill per le voci di changelog
Aprire l'interfaccia di chat
Apri l'interfaccia di chat di Bob cliccando sull'icona Bob accanto alla barra di navigazione, o usa la scorciatoia Option + Command + B (macOS) o Ctrl + Alt + B (Windows).
Passa alla modalità Agent usando il selettore di modalità nell'interfaccia di chat. La modalità Agent dà a Bob l'accesso agli strumenti di cui ha bisogno per attivare le skill e modificare i file.
Aprire le impostazioni Skills
Ci sono più modi per creare una skill in Bob. Puoi usare l'interfaccia utente (UI), o usare il comando /create-skill nella chat di Bob per una configurazione guidata.
In questo tutorial, usi la scheda Skills nelle impostazioni di Bob per creare una skill.
- Sotto l'interfaccia di chat, clicca su Bob Settings.
- Clicca su Skills nella barra laterale sinistra.
- Clicca sul pulsante + per creare una nuova skill.
Compilare i dettagli della skill
Inserisci i seguenti valori nel modulo di creazione della skill:
| Campo | Valore |
|---|---|
| Skill Name | changelog-entry |
| Description | Adds an entry to CHANGELOG.md using the Keep a Changelog format, creating the file if it does not exist, so change history stays consistent and release-ready. |
| Allow Bob to use this skill | Attivo |
| Scope & Location | galaxium-travels |
Il Skill Name è ciò che digiti per invocare la skill direttamente, ad esempio /changelog-entry. La Description è ciò che Bob legge per decidere se la skill si applica a una richiesta quando non la invochi per nome.
Quando Allow Bob to use this skill è attivo, Bob può usare la skill da solo quando un prompt lo richiede, oppure puoi invocarla esplicitamente. Impostare Scope & Location su galaxium-travels salva la skill nella directory .bob/skills/ del progetto, in modo che git la traccia insieme al codice e il tuo team possa accedervi. Scegliere Global (all workspaces) invece salverebbe la skill fuori dal repository in ~/.bob/skills/.
Inserisci quanto segue nella casella di testo Skill Instructions:
---
name: changelog-entry
description: Adds an entry to CHANGELOG.md using the Keep a Changelog format, creating the file if it does not exist, so change history stays consistent and release-ready.
user-invocable: true
---
Add an entry to CHANGELOG.md using the Keep a Changelog format (https://keepachangelog.com/).
- If CHANGELOG.md does not exist, create it at the project root with this structure before adding an entry:
# Changelog
All notable changes to this project are documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
## [Unreleased]
- Add new entries under the `## [Unreleased]` section, under one of these subheadings: `### Added`, `### Changed`, `### Fixed`, `### Removed`. Create the subheading if it is not already present under `## [Unreleased]`.
- Write each entry as a single bullet point in the imperative mood ("Add", not "Added"), starting with a capital letter, with no trailing period.
- Base the entry on the actual diff, not on the wording of the request. Run `git diff` to review what changed before writing the entry.
- Only edit CHANGELOG.md. Do not stage or commit the change.Clicca su Create.
Bob salva la skill in galaxium-travels/.bob/skills/changelog-entry/SKILL.md.
Invocare la skill direttamente
Invoca la skill per nome per vedere le istruzioni che Bob segue.
Fare una piccola modifica
Chiedi a Bob di fare una piccola modifica a basso rischio in modo da avere qualcosa da registrare:
Add a one-line note to the end of the README.md that says "Powered by IBM Bob."Bob modifica README.md. Approva la modifica se richiesto.
Registrare la modifica con la skill
Nell'interfaccia di chat, digita /changelog-entry e premi Invio o clicca sul suggerimento /changelog-entry che appare. Poi, inserisci il seguente prompt:
Add a changelog entry for this change.Bob potrebbe chiedere il permesso di usare gli strumenti della skill e di modificare i file. Approva se richiesto. Bob carica la skill changelog-entry, crea CHANGELOG.md dato che il progetto non ne ha uno, e aggiunge una voce che segue il formato definito nella skill, simile a:
## [Unreleased]
### Added
- Add "Powered by IBM Bob." note to the end of README.mdVerificare la voce
Chiedi a Bob di mostrarti il changelog.
Show me CHANGELOG.mdLa voce corrisponde alla voce di changelog che Bob ha generato nel passaggio precedente.
Lasciare che Bob attivi la skill automaticamente
Avvia una nuova finestra di attività cliccando sul pulsante + sopra l'interfaccia di chat.
Fai una seconda modifica e chiedi a Bob di registrarla senza menzionare la skill per nome. Poiché hai lasciato Allow Bob to use this skill attivo, Bob può riconoscere dalla descrizione della skill che si applica e attivarla da solo.
Fare un'altra piccola modifica
Add a one-line comment above the main heading in README.md that says "Galaxium Travels".Approva la modifica se richiesto.
Chiedere a Bob di registrare la modifica, senza nominare la skill
Update the changelog for this edit.Bob riconosce che la richiesta corrisponde alla descrizione della skill changelog-entry e la attiva senza che tu debba digitare /changelog-entry. Se richiesto, approva i permessi della skill e di modifica dei file. Bob aggiunge un'altra voce nello stesso formato.
Con questa impostazione attiva, Bob attiva automaticamente le skill, inclusa changelog-entry, ogni volta che si applicano, senza chiedere prima.
Gestire le tue skill
La scheda Skills nelle impostazioni di Bob, dove hai creato changelog-entry, è anche dove visualizzi tutte le skill disponibili nel workspace attuale e globale. Usala per controllare le skill caricate del workspace, confermare se una skill proviene dal progetto (.bob/skills/) o dalla posizione globale (~/.bob/skills/), e modificare o eliminare una skill.
Pulizia
Per rimuovere i file creati in questo tutorial:
- In Bob Settings, clicca su Skills, poi elimina la skill
changelog-entry. - Elimina la directory
galaxium-travelsclonata nei prerequisiti. Questo rimuove ancheCHANGELOG.mde le modifiche aREADME.mdeffettuate in questo tutorial.
Passi successivi
In questo tutorial, hai imparato come le skill ti permettono di definire un workflow una volta sola e di farlo applicare in modo coerente da Bob, che tu invochi la skill esplicitamente con /skill-name o lasci che Bob la attivi automaticamente in base alla sua descrizione.
Passa ad Aggiungere una modalità personalizzata per imparare come le modalità personalizzate combinano una definizione di ruolo, istruzioni di comportamento e accesso agli strumenti in un persona specializzato per un lavoro specifico.
Scrivere prompt efficaci per Bob
Massimizza l'output di Bob scrivendo prompt efficaci.
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.