Produtividade Avançada: Combinar Agentes, Competências e Modos
Nesta página
Lição atualizada em 2 de novembro de 2026. Os ficheiros de agente de exemplo utilizam agora as chaves documentadas pela Vibe:
instructions(e nãosystem_prompt),active_model(e nãomodel), blocos[tools.<tool>]para aprovações (a chaveauto_approvenão existe num ficheiro de agente) e os nomes corretos das ferramentas (edit, e nãoedit_file; sem a ferramentalist_dir). Lembrete da Lição 3:safetyé um indicador visual, não uma permissão. Fonte: Referência de configuração.
O Ecossistema Completo
Dominou agora os três pilares do Mistral Vibe: os agentes decidem quem executa, as competências descrevem o que fazer e os modos definem o contexto. Isoladamente, cada um oferece um ganho modesto. É a sua combinação que altera a natureza do trabalho — e esta lição mostra-lhe como os organizar num ambiente de desenvolvimento profissional coerente.
Tudo começa com a organização. O que o acompanha de projeto para projeto reside em ~/.vibe/; o que só faz sentido para um repositório específico permanece no repositório. Esta separação impede que arraste uma competência de inicialização de base de dados para todos os projetos e, mais importante, garante que um colega possa clonar o seu repositório sem perder as ferramentas de que necessita.
~/.vibe/
├── agents/
│ ├── review.toml # Modo de revisão de código (seguro)
│ ├── dev.toml # Modo de desenvolvimento (neutro)
│ ├── deploy.toml # Modo de implementação (destrutivo)
│ └── ci-runner.toml # Subagente de CI (yolo, apenas contentor)
├── skills/
│ ├── code-review/SKILL.md
│ ├── test-gen/SKILL.md
│ ├── smart-commit/SKILL.md
│ ├── lint-fix/SKILL.md
│ └── db-migrate/SKILL.md
└── config.toml
mon-projet/.vibe/
├── skills/
│ ├── deploy-staging/SKILL.md # Específico do projeto
│ └── seed-database/SKILL.md # Específico do projeto
└── config.toml # Configuração local
Um Dia Típico
A manhã começa em modo de só leitura. Começa com o agente personalizado plan criado na Lição 2 (o Vibe não fornece um nativo), pergunta o que mudou desde segunda-feira e obtém uma explicação de um módulo que não toca há seis meses — nada disto modifica um ficheiro. Assim que explorou o terreno, Shift+Tab muda-o para o modo de revisão para tratar um pull request.
# Comece com o agente plan personalizado da Lição 2 (só leitura)
vibe --agent plan
# Explore as alterações recentes
> Which files have been modified since Monday?
> Analyze the architecture of the src/api/ module
# Mude para o modo de revisão
# Shift+Tab → review
> Review the changes in PR #42
Segue-se a implementação, que requer um modo capaz de escrever. Descreve o que pretende e depois delega tudo o que é mecânico aos comandos slash: gerar testes para o ficheiro que acabou de escrever, limpar o diretório tocado.
# Mude para o modo dev
# Shift+Tab → dev
> Implement the POST /api/users endpoint with Zod validation
# Utilize comandos slash
/test-gen src/api/users.ts
/lint-fix src/api/
Antes de fazer o commit, a mesma sequência repete-se sempre, razão pela qual os transformámos em comandos.
# Comandos slash em sequência
/lint-fix src/
/code-review src/api/users.ts
# Smart commit
/smart-commit
Finalmente, a implementação ocorre num modo destructive onde cada passo requer a sua validação. Aqui, a mudança de modo atua tanto como uma barreira de segurança quanto como uma troca de ferramentas.
# Mude para o modo deploy (destrutivo, confirmação necessária)
# Shift+Tab → deploy
> Deploy to staging
# O Vibe segue a sequência: test → build → deploy → verify
Fazer Agentes e Competências Comunicarem
Um agente pode conhecer as suas competências e lembrá-las no momento certo. Basta mencioná-las no seu prompt de sistema: o agente não as executa por si, mas sugere o comando relevante imediatamente após produzir código, exatamente no momento em que poderia esquecer.
# ~/.vibe/agents/fullstack-dev.toml
display_name = "Fullstack Dev"
safety = "neutral"
instructions = """
You are a fullstack developer.
Available skills you can suggest to the user:
- /test-gen for unit tests
- /lint-fix for cleanup
- /smart-commit for commits
- /code-review for code review
After each implementation, suggest relevant skills.
"""
Os subagentes, por outro lado, tratam de uma parte isolada do pipeline enquanto continua a trabalhar. Uma verificação de segurança só de leitura é o caso de escola: só precisa de read_file e grep, pelo que não pode quebrar nada, e corre em paralelo sem o interromper.
# Subagente para análise de segurança (corre em paralelo)
display_name = "Security Check"
agent_type = "subagent"
safety = "safe"
instructions = """Analyze files for OWASP Top 10 vulnerabilities."""
enabled_tools = ["read_file", "grep"]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Três Fluxos de Trabalho Recorrentes
O primeiro, «Explorar → Planear → Executar», adequa-se a novas funcionalidades: explora a base de código com o seu agente plan para compreender o contexto, pede ao Vibe para propor um plano de implementação e depois executa esse plano com o agente dev ou accept-edits. O segundo, «Escrever → Rever → Corrigir», aplica-se ao código que acabou de escrever: implemente com o agente dev, reveja com /code-review e corrija os problemas identificados voltando ao modo dev. O terceiro, «Testar → Commit → Implementar», fecha o ciclo: /test-gen seguido da execução dos testes, /smart-commit para uma mensagem convencional e o agente deploy para o lançamento em produção com verificação.
Dois Níveis de Configuração
O config.toml global declara o que o acompanha em toda a parte, incluindo um diretório de competências partilhadas pela equipa — é assim que uma convenção de commit ou uma lista de verificação de revisão deixa de ser uma questão pessoal.
# ~/.vibe/config.toml
# Competências ativadas globalmente
enabled_skills = ["code-review", "test-gen", "lint-fix", "smart-commit"]
# Caminhos para competências partilhadas pela equipa
skill_paths = ["/home/equipe/vibe-skills"]
O ficheiro local complementa este conjunto com competências específicas do projeto e, crucialmente, remove as que não pertencem lá. Esta lista disabled_skills é tão importante quanto a ativação: o preenchimento automático poluído com comandos irrelevantes acaba por ser ignorado.
# mon-projet/.vibe/config.toml
# Competências adicionais para este projeto
enabled_skills = ["deploy-staging", "seed-database", "db-migrate"]
# Desativar competências irrelevantes
disabled_skills = ["experimental-*"]
Finalmente, verifique se tudo isto produz um efeito real. Cronometre a sua mudança de contexto: passar de uma tarefa para outra deve demorar menos de cinco segundos com Shift+Tab; caso contrário, os seus modos estão mal definidos. De seguida, conte quantas vezes por dia os seus comandos slash são realmente utilizados — um comando não chamado em duas semanas deve ser eliminado ou renomeado. Por fim, observe quantos problemas o modo de revisão deteta antes do commit: esta é a métrica mais reveladora, pois conta os erros que nunca chegaram à produção.
Pontos-chave
- Organize os seus agentes por nível de segurança e as suas competências por funcionalidade
- Siga o padrão «Explorar → Planear → Executar» para novas funcionalidades
- Utilize comandos slash para tarefas repetitivas
- Combine agentes globais com competências locais de projeto
Shift+Tabé o seu atalho mais produtivo- Meça e ajuste a sua configuração regularmente