Comandos de barra: acionar competências num só gesto
Nesta página
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: truereserva 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: truegera 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