Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Comandos de barra: acionar competências num só gesto

Aula 8 de 14 Atualizada a 2 de novembro de 2026 Avancado
Nesta página
  1. Atalhos para as suas competências
  2. Desenhar competências que se encadeiam
  3. O que passa ao comando
  4. Manter a legibilidade ao longo do tempo
  5. Pontos-chave

Lição atualizada em 2 de novembro de 2026 com base na documentação do Vibe: um comando de barra de competência anexa as instruções da mesma à sua mensagem, e disable-model-invocation: true reserva uma competência para acionamento manual. Fontes: Competências · Comandos e atalhos.

Atalhos para as suas competências

As competências que escreveu nas lições anteriores são inúteis se nada as chamar. Os comandos de barra são esse gatilho: comandos prefixados com / que escreve diretamente na sessão do Vibe. Não precisa de fazer declarações adicionais; toda a competência com user-invocable: true no seu frontmatter gera automaticamente um comando de barra com o nome da competência. Você escreve o SKILL.md e o Vibe trata de o expor.

A sintaxe cabe numa única linha: o nome do comando, seguido do que deseja processar.

# Numa sessão interativa do Vibe
/code-review src/api/auth.ts
/test-generator src/utils/helpers.ts
/doc-writer src/lib/database.ts

O Vibe adiciona as instruções do SKILL.md à sua mensagem, juntamente com o texto que escreveu após o comando. Para além destes comandos derivados das suas competências, o Vibe fornece comandos integrados disponíveis em todas as sessões:

/config          # Modificar a configuração do Vibe
/help            # Exibir ajuda
/clear           # Nova conversa (alias /new)
/model           # Escolher o modelo ativo
/resume          # Retomar uma sessão guardada
/compact         # Resumir o histórico para libertar contexto
/reload          # Recarregar configuração, instruções e competências

Desenhar competências que se encadeiam

Um único comando de barra poupa alguns segundos. O verdadeiro ganho está em encadeá-los: cada competência retoma o trabalho onde a anterior parou. Vejamos duas competências complementares, uma que limpa o código e outra que o submete ao controlo de versões.

A primeira, lint-fix, pressupõe que um projeto já tem as suas ferramentas configuradas e apenas precisa de as orquestrar pela ordem correta.

---
name: lint-fix
description: Lint e formatar código usando as regras do projeto
license: MIT
user-invocable: true
allowed-tools:
  - read_file
  - write_file
  - bash
  - grep
---

# Lint & Fix

Executar o lint e o formatador do projeto nos ficheiros especificados.

## Processo

1. Detetar o lint (ESLint, Biome, oxlint)
2. Detetar o formatador (Prettier, Biome)
3. Executar o lint com correção automática
4. Executar a formatação
5. Reportar erros não corrigíveis

A segunda, smart-commit, intervém assim que o código está limpo. Note a presença de ask_user_question nas suas ferramentas permitidas: escrever uma mensagem de commit afeta o histórico do repositório, pelo que é legítimo que a competência peça validação antes de executar.

---
name: smart-commit
description: Gerar uma mensagem de commit convencional a partir das alterações
license: MIT
user-invocable: true
allowed-tools:
  - bash
  - read_file
  - grep
  - ask_user_question
---

# Smart Commit

Analisar as alterações atuais do Git e gerar uma mensagem de commit
seguindo a convenção Conventional Commits.

## Processo

1. Executar `git diff --staged` para ver as alterações
2. Categorizar: feat, fix, refactor, docs, test, chore
3. Identificar o âmbito (ficheiro principal ou módulo)
4. Escrever uma mensagem concisa em inglês
5. Pedir validação ao utilizador
6. Executar o commit

Uma vez estas competências no lugar, um dia de desenvolvimento decorre assim: abre a sessão, explora o código existente, escreve código e, em seguida, percorre a cadeia de verificação antes de fazer o commit.

vibe

# Manhã: exploração
/code-review src/

# Desenvolvimento
# ... código ...

# Antes do commit
/lint-fix src/
/test-generator src/new-file.ts
/smart-commit

O que passa ao comando

Tudo o que segue o nome do comando é texto livre, passado à competência como contexto. Pode especificar um único ficheiro, listar vários ou dar uma instrução em linguagem natural em vez de listar caminhos.

# Passar um ficheiro específico
/code-review src/api/users.ts

# Passar vários ficheiros
/test-generator src/utils/math.ts src/utils/string.ts

# Passar instruções
/doc-writer Documentar apenas as funções públicas em src/lib/

Nem todas as suas competências precisam de se tornar comandos. Uma competência de análise chamada apenas por outras competências ou por um agente não tem lugar na sua conclusão automática: defina-a como user-invocable: false e ela desaparece da lista, permanecendo referenciável internamente.

---
name: internal-analyzer
description: Análise interna usada por outras competências
user-invocable: false
allowed-tools:
  - read_file
  - grep
---

Manter a legibilidade ao longo do tempo

Escreva apenas / numa sessão para ver a lista completa de comandos disponíveis, tanto os integrados como os pessoais, com cada nome e descrição. Esta lista é o seu painel de controlo: se não conseguir encontrar as suas próprias competências passados três meses, a sua nomenclatura desviou-se. Uma convenção verbo-objeto é suficiente para manter tudo consistente.

/lint-fix       → ação-objeto
/test-generate  → ação-objeto
/doc-write      → ação-objeto
/db-migrate     → contexto-ação

A descrição no frontmatter aparece nesta conclusão automática: é o que lhe lembrará, daqui a seis meses, exatamente o que o comando faz. “Ferramenta de teste” não lhe diz nada; a versão mais longa indica-lhe qual a estrutura, qual a linguagem e qual o âmbito.

# Mau
description: Ferramenta de teste

# Bom
description: Gerar testes unitários Vitest para funções TypeScript exportadas

Pontos-chave

  • Toda a competência com user-invocable: true gera automaticamente um comando de barra
  • Sintaxe: /nome-da-competencia argumentos-opcionais
  • Os argumentos são texto livre passado à competência como contexto
  • Combine comandos de barra para criar fluxos de trabalho diários
  • Escreva / para listar todos os comandos disponíveis
  • Nomeie as suas competências de forma consistente e descritiva