Criar e usar skills
Cria uma skill reutilizável que ensina ao Bob um workflow repetível para entradas de changelog, depois invoca-a explicitamente e deixa o Bob ativá-la automaticamente.
Uma skill é um conjunto de instruções reutilizável que ensina ao Bob um workflow especializado e repetível. Em vez de reescrever as mesmas regras de formatação ou lista de verificação em cada prompt, defines o workflow uma vez num ficheiro SKILL.md. O Bob segue então essas instruções sempre que a skill se aplica, quer a invoques diretamente quer o Bob a ative sozinho.
Neste tutorial, crias uma skill que adiciona entradas a um ficheiro CHANGELOG.md usando o formato Keep a Changelog, criando o ficheiro se ainda não existir. Invocas a skill explicitamente com um comando slash, depois fazes uma segunda alteração e pedes ao Bob para a registar sem nomear a skill, para veres o Bob ativá-la automaticamente com base na sua descrição.
Pré-requisitos
Para completar este tutorial, precisas de:
- Se ainda não o tens, clona o código de demonstração Galaxium Travels.
git clone https://github.com/IBM/galaxium-travels- Bob IDE com o código de demonstração Galaxium Travels aberto.
- Embora não seja obrigatório, considera completar primeiro Iniciar um projeto com /init e AGENTS.md e Escrever prompts eficazes para o Bob.
Criar uma skill para entradas de changelog
Abrir a interface de chat
Abre a interface de chat do Bob clicando no ícone do Bob junto à barra de navegação, ou usa o atalho Option + Command + B (macOS) ou Ctrl + Alt + B (Windows).
Muda para o modo Agent usando o seletor de modo na interface de chat. O modo Agent dá ao Bob o acesso às ferramentas de que precisa para ativar skills e editar ficheiros.
Abrir as definições de Skills
Existem várias formas de criar uma skill no Bob. Podes usar a interface de utilizador (UI), ou usar o comando /create-skill no chat do Bob para uma configuração guiada.
Neste tutorial, usas o separador Skills nas definições do Bob para criar uma skill.
- Abaixo da interface de chat, clica em Bob Settings.
- Clica em Skills na barra lateral esquerda.
- Clica no botão + para criar uma nova skill.
Preencher os detalhes da skill
Introduz os seguintes valores no formulário de criação de skill:
| Campo | Valor |
|---|---|
| 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 | Ativado |
| Scope & Location | galaxium-travels |
O Skill Name é o que escreves para invocar a skill diretamente, por exemplo /changelog-entry. A Description é o que o Bob lê para decidir se a skill se aplica a um pedido quando não a invocas pelo nome.
Quando Allow Bob to use this skill está ativado, o Bob pode usar a skill por sua conta quando um prompt o requer, ou podes invocá-la explicitamente. Definir Scope & Location como galaxium-travels guarda a skill no diretório .bob/skills/ do projeto, para que o git o acompanhe junto com o código e a tua equipa possa aceder-lhe. Escolher Global (all workspaces) em vez disso guardaria a skill fora do repositório em ~/.bob/skills/.
Introduz o seguinte na caixa de texto 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.Clica em Create.
O Bob guarda a skill em galaxium-travels/.bob/skills/changelog-entry/SKILL.md.
Invocar a skill diretamente
Invoca a skill pelo nome para poderes ver as instruções que o Bob segue.
Fazer uma pequena alteração
Pede ao Bob que faça uma edição pequena e de baixo risco para teres algo para registar:
Add a one-line note to the end of the README.md that says "Powered by IBM Bob."O Bob edita README.md. Aprova a edição se solicitado.
Registar a alteração com a skill
Na interface de chat, digita /changelog-entry e prime Enter ou clica na sugestão /changelog-entry que aparece. De seguida, introduz o seguinte prompt:
Add a changelog entry for this change.O Bob pode pedir permissão para usar ferramentas da skill e editar ficheiros. Aprova se solicitado. O Bob carrega a skill changelog-entry, cria CHANGELOG.md dado que o projeto não tem um, e adiciona uma entrada que segue o formato definido na skill, semelhante a:
## [Unreleased]
### Added
- Add "Powered by IBM Bob." note to the end of README.mdVerificar a entrada
Pede ao Bob que te mostre o changelog.
Show me CHANGELOG.mdA entrada corresponde à entrada do changelog que o Bob gerou no passo anterior.
Deixar o Bob ativar a skill automaticamente
Inicia uma nova janela de tarefa clicando no botão + acima da interface de chat.
Faz uma segunda alteração e pede ao Bob para a registar sem mencionar a skill pelo nome. Como deixaste Allow Bob to use this skill ativado, o Bob pode reconhecer a partir da descrição da skill que se aplica e ativá-la por conta própria.
Fazer outra pequena alteração
Add a one-line comment above the main heading in README.md that says "Galaxium Travels".Aprova a edição se solicitado.
Pedir ao Bob para registar a alteração, sem nomear a skill
Update the changelog for this edit.O Bob reconhece que o pedido corresponde à descrição da skill changelog-entry e ativa-a sem teres de escrever /changelog-entry. Se solicitado, aprova as permissões da skill e de edição de ficheiros. O Bob adiciona outra entrada no mesmo formato.
Com esta definição ativada, o Bob ativa automaticamente as skills, incluindo changelog-entry, sempre que se aplicam, sem perguntar primeiro.
Gerir as tuas skills
O separador Skills nas definições do Bob, onde criaste changelog-entry, é também onde visualizas todas as skills disponíveis no workspace atual e global. Usa-o para verificar as skills carregadas do workspace, confirmar se uma skill vem do projeto (.bob/skills/) ou da localização global (~/.bob/skills/), e editar ou eliminar uma skill.
Limpeza
Para remover os ficheiros criados neste tutorial:
- Em Bob Settings, clica em Skills e depois elimina a skill
changelog-entry. - Elimina o diretório
galaxium-travelsclonado nos pré-requisitos. Isto também removeCHANGELOG.mde as edições deREADME.mdefetuadas neste tutorial.
Próximos passos
Neste tutorial, aprendeste como as skills te permitem definir um workflow uma vez e ter o Bob a aplicá-lo de forma consistente, quer invoques a skill explicitamente com /skill-name quer deixes o Bob ativá-la automaticamente com base na sua descrição.
Avança para Adicionar um modo personalizado para aprender como os modos personalizados combinam uma definição de função, instruções de comportamento e acesso a ferramentas numa persona especializada para um trabalho específico.
Escrever prompts eficazes para o Bob
Maximize o output do Bob escrevendo prompts eficazes.
Adicionar capacidades ao Bob
Estenda as capacidades de trabalho do Bob criando um modo personalizado de gerente de produto com uma definição de função personalizada, instruções comportamentais e restrições de acesso a ferramentas determinísticas.