Modos Personalizados: Revisão de Código, Implementação, Lint
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 nomes reais de 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.
Crie modos adaptados ao seu fluxo de trabalho
A lição sobre modos unificados introduziu o conceito; agora é hora de o colocar à prova. Vamos construir três modos personalizados que cobrem necessidades recorrentes para qualquer programador: revisão de código, implementação e linting. Cada um é um ficheiro .toml colocado em ~/.vibe/agents/, com instruções específicas. O que distingue estes três modos não são tanto as suas instruções, mas o par enabled_tools / [tools.<tool>]: é isto que decide o que a Vibe pode tocar e, consequentemente, o risco que corre; safety é apenas o rótulo visual.
Um revisor que não pode estragar nada
O modo de revisão de código transforma a Vibe num revisor exigente que analisa a qualidade, a segurança e a manutenibilidade do seu código. Como apenas lê, está marcado como safe, e as suas ferramentas de leitura estão definidas com permission = "always": funciona sem o interromper e sem risco, uma vez que nenhum ficheiro será modificado. A lista de ferramentas mantém esta promessa: sem write_file, sem edit, sem bash.
# ~/.vibe/agents/review.toml
display_name = "Code Review"
description = "In-depth code review: security, performance, maintainability."
safety = "safe"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
You are a senior developer in code review mode.
Process:
1. Read modified files (git diff or specified files)
2. Analyze each change across 4 axes:
- Security (injection, XSS, CSRF, exposed secrets)
- Performance (N+1, nested loops, memory)
- Maintainability (naming, complexity, duplication)
- Correctness (logic, edge cases, types)
Output format:
## 🔴 Critiques (fix before merge)
## 🟡 Warnings (fix soon)
## 🟢 Suggestions (optional improvements)
For each point: file, line, problem, proposed fix.
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
O formato de saída imposto no prompt não é cosmético: permite-lhe distinguir à primeira vista o que bloqueia um pull request e o que pode esperar. Inicia o modo e fornece-lhe uma instrução de forma livre ou um âmbito específico.
vibe --agent review
# > Analyze modified files in the current branch
# > /review src/api/
Uma implementação que se recusa a improvisar
O modo de implementação é exatamente o oposto. Toca em produção, por isso está marcado como destructive, e as suas ferramentas de escrita e bash permanecem com permission = "ask": cada ação requer a sua validação. Todo o valor do modo reside na sequência fixa do seu prompt e, especialmente, nas suas condições de paragem. Uma implementação improvisada numa sexta-feira à noite começa sempre com um passo saltado; aqui, um teste vermelho para tudo.
# ~/.vibe/agents/deploy.toml
display_name = "Deploy"
description = "Controlled deployment with tests, build, and verification."
safety = "destructive"
active_model = "codestral" # alias declared in config.toml (Lesson 2)
instructions = """
You are in deployment mode. Follow this sequence WITHOUT EXCEPTION:
1. VERIFY — clean git status, no uncommitted files
2. TEST — run the full test suite
3. BUILD — production build
4. VALIDATE — check the build (size, errors, warnings)
5. CONFIRM — ask the user before continuing
6. DEPLOY — run the deployment command
7. VERIFY — confirm the service responds correctly
If a step fails: STOP. Explain the problem and propose a solution.
Never deploy if tests fail.
Never deploy if the build contains critical warnings.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
A presença de ask_user_question nas ferramentas é essencial: sem ela, o passo 5 seria um desejo, pois o agente não teria qualquer meio técnico de o questionar.
vibe --agent deploy
# > Follows the sequence test → build → deploy → verification
Limpeza automática, mas disciplinada
Entre os dois situa-se o modo lint, que automatiza a formatação, convenções e ordenação de imports. Modifica ficheiros, por isso é neutral, mas as suas correções são mecânicas e reversíveis via Git: aprovar as suas ferramentas de imediato (permission = "always") poupa-o de clicar cinquenta vezes. Se a sua lista incluir bash, faça-o apenas num ambiente isolado ou limite o bash a uma allowlist de comandos de lint apenas. As três regras no final do prompt são o que o impede de descarrilar — um agente em execução livre instalará rapidamente o Biome num projeto que vive perfeitamente bem com o ESLint.
# ~/.vibe/agents/lint.toml
display_name = "Lint & Fix"
description = "Automatic cleanup: lint, format, imports, conventions."
safety = "neutral"
active_model = "codestral" # alias declared in config.toml (Lesson 2)
instructions = """
You are in code cleanup mode.
Tasks:
1. Detect project tools (ESLint, Biome, Prettier, oxlint)
2. Run lint with auto-fix
3. Run formatting
4. Sort and clean up imports
5. Remove detectable dead code
6. Report errors that cannot be fixed automatically
Rules:
- Use tools already configured in the project
- Do not modify tool configuration
- Do not add new tools without asking
"""
enabled_tools = [
"read_file",
"edit",
"bash",
"grep",
]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.bash]
permission = "always" # reserve for isolated environments only
[tools.grep]
permission = "always"
Mais dois modos e uma regra de organização
O mesmo raciocínio aplica-se a outras necessidades. Um modo de documentação permanece neutral, mas mantém write_file e edit em "ask", porque gerar ficheiros num repositório merece uma verificação antes da escrita.
# ~/.vibe/agents/docs.toml
display_name = "Documentation"
description = "Generates and updates technical documentation."
safety = "neutral"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
Generate technical documentation. For each file:
- JSDoc/TSDoc for public functions
- README with usage examples
- Documented environment variables
- API schemas if applicable
"""
enabled_tools = ["read_file", "write_file", "edit", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Um modo de migração, entretanto, junta-se ao deploy na categoria destructive: uma migração de esquema falhada não pode ser desfeita com um git revert, daí a exigência de um script de reversão sistemático.
# ~/.vibe/agents/migrate.toml
display_name = "Migration"
description = "Handles database and dependency migrations."
safety = "destructive"
active_model = "mistral-medium-3.5" # model built into Vibe
instructions = """
You handle migrations. Absolute rules:
- Always generate a rollback script
- Test the migration on a copy before production
- Document every schema change
"""
enabled_tools = ["read_file", "write_file", "bash", "grep", "ask_user_question"]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Finalmente, organize o seu diretório de agentes para que a criticidade seja legível na própria estrutura da árvore. Quando mudar de modo via teclado durante uma sessão, precisa de saber, sem pensar, se o modo que acabou de ativar pode escrever no seu disco.
~/.vibe/agents/
├── review.toml # safe — read-only
├── lint.toml # neutral — controlled modifications
├── docs.toml # neutral — file generation
├── deploy.toml # destructive — with confirmation
└── migrate.toml # destructive — with confirmation
Pontos-chave
- Cada modo é um ficheiro
.tomlem~/.vibe/agents/desenhado para um fluxo de trabalho específico - O modo review possui apenas ferramentas de leitura, aprovadas de imediato: só pode ler
- O modo deploy mantém o
bashe a escrita em"ask": pede confirmação - O modo lint aprova as suas ferramentas de edição de imediato: corrige automaticamente
- Ajuste o
active_modelcom base na complexidade da tarefa - As
instructionssão fundamentais: seja preciso sobre a sequência e as regras