Skills
Cria conjuntos de instruções reutilizáveis para workflows especializados. Define workflows personalizados, adiciona ficheiros de suporte e ensina ao Bob tarefas especializadas para resultados consistentes.
Os skills são conjuntos de instruções reutilizáveis que ensinam ao Bob novos workflows e tarefas especializadas. Pensa neles como receitas que Bob segue para completar tipos específicos de trabalho de forma consistente e repetível.
Porquê usar skills
- Reutilização: Define workflows uma vez e usa-os em múltiplas conversas.
- Consistência: Garante que Bob segue a mesma abordagem sempre que executa tarefas específicas.
- Especialização: Cria expertise específica de domínio para revisões de código, testes, documentação e mais.
- Colaboração em equipa: Partilha workflows padronizados com a tua equipa através do controlo de versões.
- Flexibilidade: Inclui ficheiros de suporte como checklists, templates e materiais de referência.
Requisitos
Os skills estão disponíveis apenas no modo Advanced. Isto garante que Bob tem acesso a todas as ferramentas necessárias para executar workflows baseados em skills de forma eficaz.
Como funcionam os skills
Quando ativas um skill, Bob recebe as instruções do skill e obtém acesso a quaisquer ficheiros de suporte no diretório do skill. Bob segue então estas instruções para completar a tua tarefa de acordo com o workflow definido.
Os skills carregam uma vez por conversa para evitar prompts duplicados. Bob determina automaticamente quando ativar um skill com base no teu pedido e na descrição do skill.
Criar um skill
Configuração básica
Cria uma pasta dentro de .bob/skills/ na raiz do teu projeto, ou usa ~/.bob/skills/ para skills globais.
Adiciona um ficheiro SKILL.md dentro dessa pasta.
Estrutura exemplo:
Formato de SKILL.md
O ficheiro SKILL.md usa frontmatter YAML seguido das instruções do skill:
---
name: code-review
description: Review code for bugs, security issues, and best practices
---
When reviewing code, check for:
- Security vulnerabilities
- Performance issues
- Missing error handling at API boundaries
- Unused imports and dead code
Provide a summary with severity levels for each finding.Campos obrigatórios:
name: O nome de exibição do skill usado na interface do Bobdescription: Um resumo claro que ajuda Bob a decidir quando ativar este skill — skills sem descrições são ignorados
Secção de instruções:
Tudo abaixo do delimitador --- torna-se as instruções que Bob recebe quando o skill é ativado.
Adicionar ficheiros de suporte
Podes incluir ficheiros adicionais e subpastas junto ao SKILL.md para fornecer materiais de referência, templates, checklists, scripts ou outros recursos. Bob pode ler estes ficheiros automaticamente assim que o skill é ativado.
Exemplo com ficheiros de suporte:
Os ficheiros e pastas de suporte podem incluir:
- Checklists e templates
- Documentação de referência
- Exemplos de configuração
- Scripts e utilitários em subpastas
- Guias de estilo
- Quaisquer outros recursos necessários para o skill
Localizações dos skills
Os skills podem ser definidos em dois níveis:
| Localização | Âmbito | Caso de uso |
|---|---|---|
<project>/.bob/skills/ | Específico do projeto | Workflows exclusivos deste projeto |
~/.bob/skills/ | Global | Workflows pessoais ou de toda a organização |
Prioridade: Se ambas as localizações contiverem um skill com o mesmo nome, o skill ao nível do projeto tem precedência.
Aprovar skills
Por predefinição, Bob pede a tua permissão antes de ativar um skill. Isto dá-te controlo sobre quando os workflows especializados são aplicados.
Para saltar o prompt de aprovação:
Abre as definições do Bob.
Navega para a secção de Aprovação automática.
Ativa o toggle para Skills.
Com esta definição ativada, Bob ativa skills automaticamente quando apropriado sem pedir permissão.
Separador de definições de Skills
O separador Skills nas definições do Bob dá-te um local central para ver e gerir os skills disponíveis no teu workspace. Usa-o para ver quais skills estão carregados, verificar as suas localizações e confirmar que skills dos teus diretórios de projeto ou globais estão a ser detetados corretamente.
Escrever skills eficazes
Descrições claras
Escreve descrições que indiquem claramente quando o skill deve ser usado. Bob baseia-se nestas descrições para determinar a relevância do skill.
Bem: "Review code for bugs, security issues, and best practices"
Evitar: "Code review skill"
Instruções focadas
Mantém o ficheiro SKILL.md principal focado no workflow principal. Move o material de referência detalhado, exemplos e checklists para ficheiros de suporte.
Exemplo:
---
name: api-documentation
description: Generate API documentation following OpenAPI standards
---
Generate API documentation that includes:
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example requests and responses
Follow the style guide in `api-style-guide.md` and use the template in `api-template.md`.Passos acionáveis
Estrutura as instruções como passos claros e acionáveis que Bob pode seguir sistematicamente.
Exemplo:
---
name: feature-implementation
description: Implement new features following team standards
---
<Steps>
<Step>
Review the feature requirements.
</Step>
<Step>
Create a plan with file changes needed.
</Step>
<Step>
Implement the feature with tests.
</Step>
<Step>
Update documentation.
</Step>
<Step>
Verify all tests pass.
</Step>
</Steps>
Follow coding standards in `coding-standards.md`.Skills de exemplo
Skill de revisão de código
---
name: security-review
description: Review code for security vulnerabilities and best practices
---
Perform a security-focused code review:
<Steps>
<Step>
Check for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Authentication/authorization issues
- Sensitive data exposure
</Step>
<Step>
Review security best practices:
- Input validation
- Output encoding
- Secure configuration
- Error handling
</Step>
<Step>
Provide findings with:
- Severity level (Critical, High, Medium, Low)
- Location in code
- Recommended fix
- Reference to security standards
</Step>
</Steps>
Use the severity guide in `severity-levels.md` for classification.Skill de documentação
---
name: api-docs
description: Generate comprehensive API documentation
---
Create API documentation that includes:
<Steps>
<Step>
Overview section:
- Purpose and use cases
- Authentication requirements
- Base URL and versioning
</Step>
<Step>
For each endpoint:
- HTTP method and path
- Description and purpose
- Request parameters
- Request body schema
- Response codes and schemas
- Example requests and responses
</Step>
<Step>
Additional sections:
- Error handling
- Rate limiting
- Pagination
</Step>
</Steps>
Follow the template in `api-doc-template.md` and examples in `api-examples.md`.Dicas e boas práticas
- Começa de forma simples: Começa com instruções básicas e refina com base nos resultados.
- Usa ficheiros de suporte: Mantém
SKILL.mdconciso movendo o conteúdo detalhado para ficheiros complementares. - Testa exaustivamente: Verifica que os skills funcionam como esperado antes de partilhá-los com a tua equipa.
- Controlo de versões: Inclui skills do projeto no teu repositório para consistência da equipa.
- Nomes claros: Usa nomes de skills descritivos que indiquem o seu propósito.
- Responsabilidade única: Cria skills focados para tarefas específicas em vez de tentar lidar com múltiplos workflows não relacionados.
Literate Coding
Escreve código com assistência de IA diretamente no teu editor usando instruções em linguagem natural exatamente onde o código deve ficar. O Bob gera a implementação no contexto com inline diffs.
Bobalytics
O Bobalytics fornece análises e insights sobre como o IBM Bob contribui para o teu processo de desenvolvimento de software. Use-o para entender o impacto do Bob na tua codebase, rastrear os gastos de Bobcoins e monitorar a adoção pela equipa em toda a tua organização.