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

Gestão de competências: descoberta, ativação e prioridade

Aula 7 de 14 Atualizada a 2 de novembro de 2026 Avancado
Nesta página
  1. Como o Vibe descobre competências
  2. Estrutura do diretório de competências
  3. Ativar e desativar competências
  4. Padrões de filtragem
  5. Duas competências com o mesmo nome
  6. Configuração ao nível do projeto
  7. Pontos-chave

Lição atualizada em 2 de novembro de 2026 com base na página Skills da documentação do Vibe: adicionadas as localizações .agents/skills/, a ordem oficial de descoberta (caminhos personalizados, projeto, utilizador) e o comando /reload. A documentação não define uma regra de prioridade para duas competências com o mesmo nome; a versão anterior descrevia uma. Fonte: Skills.

Como o Vibe descobre competências

Escrever uma competência é uma coisa; saber qual delas é realmente executada é outra. A documentação especifica a ordem pela qual o Vibe descobre as competências:

  1. Caminhos personalizados declarados em config.toml através de skill_paths;
  2. Competências do projeto, localizadas em ./.vibe/skills/ ou ./.agents/skills/, carregadas apenas se a pasta for considerada segura (trusted);
  3. Competências do utilizador, localizadas em ~/.vibe/skills/ ou ~/.agents/skills/.

As pastas .agents/skills/ seguem a especificação aberta Agent Skills: uma competência aí armazenada é partilhada com outros agentes que adotem a mesma especificação. Uma sessão ativa deteta competências adicionadas ou modificadas; se uma alteração não aparecer, digite /reload.

Estrutura do diretório de competências

As competências globais residem no seu diretório pessoal, cada uma na sua própria pasta contendo um SKILL.md. Estão disponíveis em qualquer lugar, em todos os projetos onde execute o Vibe.

~/.vibe/skills/
├── code-review/
│   └── SKILL.md
├── test-generator/
│   └── SKILL.md
└── doc-writer/
    └── SKILL.md

As competências locais, por outro lado, são versionadas juntamente com o código do projeto. Este é o local natural para uma competência de implementação ou migração, que depende da infraestrutura exata do repositório e não faria sentido noutro lugar.

mon-projet/
├── .vibe/
│   └── skills/
│       ├── deploy-prod/
│       │   └── SKILL.md
│       └── db-migrate/
│           └── SKILL.md
├── src/
└── package.json

Finalmente, existem caminhos personalizados, usados para referenciar competências localizadas noutros locais do seu sistema. Declara-os na configuração:

# ~/.vibe/config.toml
skill_paths = [
  "/home/equipe/shared-skills",
  "/opt/company-skills"
]

Este é o mecanismo preferencial para partilhar competências dentro de uma equipa, através de uma pasta de rede ou de um repositório Git clonado que todos atualizam do seu lado.

Ativar e desativar competências

Por predefinição, todas as competências descobertas estão ativas. Duas configurações simétricas permitem-lhe retomar o controlo. Com enabled_skills, muda para uma lista branca: apenas as competências listadas estão ativas; todas as outras são ignoradas.

# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]

Com disabled_skills, mantém-se numa lista negra: todas as competências estão ativas exceto as que nomear. Esta é a escolha correta quando uma única competência está temporariamente a atrapalhar o seu trabalho.

# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]

Padrões de filtragem

Ambos os campos aceitam três formas de entrada. A mais simples é o nome exato, que funciona enquanto a lista permanecer curta:

enabled_skills = ["code-review", "test-generator", "doc-writer"]

Os padrões glob assumem o controlo assim que os seus nomes seguirem uma convenção. O caráter * corresponde a qualquer sequência de caracteres, permitindo-lhe gerir uma família inteira numa única linha:

# Ativar todas as competências que começam por "test-"
enabled_skills = ["test-*"]

# Desativar todas as competências experimentais
disabled_skills = ["experimental-*", "beta-*"]

Para casos que os globs não cobrem — uma alternativa, um padrão no meio de um nome, um sufixo numérico — prefixe a expressão com re: para usar uma expressão regular:

# Ativar competências cujo nome contenha "review" ou "audit"
enabled_skills = ["re:review|audit"]

# Desativar competências versionadas (ex: "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+']   # cadeia literal: a barra invertida não precisa de escape

Duas competências com o mesmo nome

A documentação não descreve uma regra de prioridade para duas competências com o mesmo nome em locais diferentes. Portanto, não conte com uma “sobrescrita” implícita: dê-lhes nomes distintos (code-review-backend em vez de um segundo code-review) e verifique o que está realmente carregado. No menu /, a descrição de cada competência começa com o seu âmbito, project, user ou vibe, o que é suficiente para detetar um duplicado. Uma competência com o nome de um comando integrado não aparece neste menu.

Configuração ao nível do projeto

Todas estas definições combinam-se num ficheiro .vibe/config.toml colocado na raiz do projeto. O exemplo abaixo mostra as três alavancas em conjunto: restringir a lista às competências relevantes, excluir as que não o são e adicionar a pasta partilhada da equipa de backend.

# mon-projet/.vibe/config.toml

# Ativar apenas competências relevantes para este projeto
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]

# Ou desativar as que não são relevantes
disabled_skills = ["doc-writer"]

# Adicionar caminhos adicionais
skill_paths = ["/home/equipe/backend-skills"]

Para verificar quais as competências realmente disponíveis, abra o menu / na sessão: cada competência aparece lá com o seu âmbito. Este é o primeiro reflexo quando um comando de barra esperado permanece em falta, antes de tentar /reload e verificar o estado de confiança da pasta.

Pontos-chave

  • O Vibe descobre competências em ~/.vibe/skills/, .vibe/skills/ e skill_paths personalizados
  • As competências locais têm prioridade sobre as competências globais
  • Use enabled_skills ou disabled_skills para controlar a ativação
  • Padrões glob (test-*) e regex (re:review|audit) simplificam a filtragem
  • Crie um .vibe/config.toml por projeto para personalizar o contexto
  • Partilhe competências numa equipa através de skill_paths apontando para uma pasta comum