Configuração e personalização

Verdent for VS Code oferece amplas opções de configuração para se adaptar ao seu fluxo de trabalho de desenvolvimento, às suas preferências de programação e aos padrões da sua equipe. Configure as opções por meio da interface de configurações nativa do VS Code, personalize atalhos de teclado e crie regras e subagentes para comportamentos especializados.

O que você vai aprender

• Configurar as opções da extensão VS Code para o Verdent
• Personalizar atalhos de teclado para um fluxo de trabalho eficiente
• Criar e gerenciar regras para um comportamento personalizado do agente
• Construir subagentes personalizados para tarefas especializadas

Pré-requisitos

• Verdent for VS Code instalado e autenticado
• Acesso às configurações do VS Code (Cmd+, ou Ctrl+,)
• Compreensão básica de JSON para arquivos de regras (opcional)

Configurações da extensão VS Code

As configurações do Verdent for VS Code são acessadas em vários locais, dependendo do tipo e do escopo da configuração.

Acessando as configurações

Configurações da extensão (VS Code nativo):

1. Abra as configurações do VS Code: Cmd+, (macOS) ou Ctrl+, (Windows/Linux)
2. Pesquise por "Verdent" na barra de busca de configurações
3. Modifique as configurações da extensão (por exemplo, verdent.enableCheckpoints)

Configurações específicas do Verdent:

Clique no botão Settings na barra superior do Verdent para acessar:

• Rules - User Rules, Project Rules, Plan Rules
• Servidores MCP - Configurações do Model Context Protocol
• Subagents - Gerenciamento de subagentes personalizados

Controles no chat:

Muitas configurações podem ser alternadas diretamente na Input Box, na parte inferior do painel do Verdent:

• Switch Permission - Manual Accept, Auto-Run, Plan, Skip Permissions
• Switch Mode - modos Agent, Plan, Chat
• Switch/Customize AI Model - presets Performance, Balance, Efficiency
• Think Hard Mode - orçamento máximo de raciocínio para análises complexas
• Add Context - anexe arquivos usando @-menções
• Add Images or Files - inclua capturas de tela ou documentos
• Add Subagent - delegue a subagentes especializados

As alterações nas configurações têm efeito imediato, sem necessidade de reiniciar o VS Code.

Referência das configurações disponíveis da extensão

Verdent for VS Code fornece 2 configurações principais de extensão que podem ser definidas pela interface de configurações do VS Code:

Referência dos controles da Input Box

A Input Box, na parte inferior do painel do Verdent, oferece acesso rápido aos controles de configuração:

Modos de permissão

Presets de modelo

Personalização de atalhos de teclado

Atalhos padrão

Atalho principal:

• macOS: Cmd+L - abre/foca o painel do Verdent
• Windows/Linux: Ctrl+L - abre/foca o painel do Verdent
  • Comando: verdent.addToChat
  • Funciona a partir da Command Palette e do contexto do editor

Este é o atalho essencial para acessar o Verdent rapidamente de qualquer lugar no VS Code sem interromper seu fluxo de programação.

Comandos adicionais:

Disponíveis pela Command Palette (os atalhos padrão podem ser personalizados):

• verdent.addFeedBack - enviar feedback
• verdent.addTerminalOutputToChat - adicionar a saída do terminal ao Verdent
• verdent.addToChatBySearch - adicionar ao Verdent por busca
• verdent.centerButtonClicked - User Center
• verdent.historyButtonClicked - Project History
• verdent.mcpButtonClicked - adicionar servidor MCP
• verdent.openInNewTabByParams - abrir em nova aba
• verdent.plusButtonClicked - nova sessão
• verdent.rulesButtonClicked - configurações de Rules
• verdent.SettingClicked - menu de configurações
• verdent.subagentButtonClicked - adicionar subagente

Personalizando atalhos

Todos os atalhos de teclado do Verdent podem ser personalizados usando o sistema padrão de keybindings do VS Code.

{
  "key": "cmd+shift+v",
  "command": "verdent.addToChat"
}

{
  "key": "ctrl+shift+v",
  "command": "verdent.addToChat"
}

Escopo da personalização:

• Todos os comandos do Verdent podem ser remapeados
• Vários atalhos podem ser atribuídos ao mesmo comando
• Os atalhos padrão podem ser removidos
• As alterações são sincronizadas entre máquinas com o Settings Sync do VS Code

Atalhos específicos por plataforma

Verdent segue as convenções de teclado específicas de cada plataforma do VS Code:

Padrões comuns:

• Configurações: Cmd+, (macOS) vs Ctrl+, (Windows/Linux)
• Command Palette: Cmd+Shift+P (macOS) vs Ctrl+Shift+P (Windows/Linux)
• Atalhos de teclado: Cmd+K Cmd+S (macOS) vs Ctrl+K Ctrl+S (Windows/Linux)

Instruções personalizadas e personas

Verdent for VS Code oferece dois sistemas para personalizar o comportamento da IA: Rules para preferências e diretrizes, e Subagents para personas de tarefas especializadas.

Sistema de Rules

As Rules definem como o Verdent se comporta e responde durante as sessões de programação. As Rules são armazenadas em arquivos Markdown e aplicadas continuamente ao longo das conversas.

Três tipos de Rules

1. User Rules (VERDENT.md):

• Local: ~/.verdent/ (diretório de configuração global)
• Escopo: aplicado a todas as conversas em todos os projetos
• Finalidade: preferências pessoais de programação, estilo de comunicação, padrões de documentação

2. Project Rules (AGENTS.md):

• Local: diretório raiz do projeto ou espaço de trabalho
• Escopo: aplicado apenas ao projeto atual
• Controle de versão: pode ser commitado no git para padrões válidos em toda a equipe
• Finalidade: padrões de programação específicos do projeto, padrões arquiteturais, requisitos de testes

3. Plan Rules (plan_rules.md):

• Local: ~/.verdent/ (diretório de configuração global)
• Escopo: aplicado ao usar o Plan Mode em todos os projetos
• Finalidade: personalizar o conteúdo, o formato e o nível de detalhe do plano

Criando e editando Rules

Exemplo de User Rules:

# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code

Exemplo de Project Rules:

## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing

Armazenamento e aplicação de Rules

Prioridade de configuração:

Quando as regras entram em conflito, o Verdent aplica esta ordem de prioridade:

1. Project Rules (AGENTS.md) - prioridade máxima (específica do projeto)
2. User Rules (VERDENT.md) - preferências globais do usuário
3. Comportamento padrão - padrões internos do Verdent

Subagents

Subagents são agentes de IA especializados com prompts de sistema personalizados e janelas de contexto isoladas para lidar com tarefas específicas.

Subagents integrados

Verdent inclui três subagentes padrão disponíveis imediatamente, sem configuração:

Criando subagents personalizados

Formato do arquivo de Subagent:

---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt

You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues

Invocation policy (strict): Only run security-reviewer if user explicitly requests it.

When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment

When NOT to use:
- General code review without security focus
- Opening or reading files without analysis

Gerenciando subagents

Acesse por meio de Settings → Subagents para:

• Edit: modificar prompts de sistema, permissões de ferramentas, configurações
• Copy: duplicar subagentes para variações ou modelos
• Delete: remover subagentes não utilizados
• Enable/Disable: alternar a disponibilidade sem excluir

Usando subagents

Subagents integrados:

• Referencie com @-menções: @Verifier, @Explorer, @Code-reviewer
• Invocados automaticamente quando os tipos de tarefa adequados são detectados

Subagents personalizados:

• Clique no botão Add Subagent na Input Box
• Selecione no menu suspenso
• O agente principal delega automaticamente as tarefas adequadas

Subagent vs Rules

Exemplo de fluxo de trabalho:

1. User Rule: "Gerar testes unitários para todas as novas funções"
2. Agente principal: detecta a necessidade de geração de testes
3. Delega ao subagente Test Generator: abordagem especializada e abrangente de testes
4. Subagente: gera uma suíte de testes completa com contexto isolado
5. Agente principal: recebe os resultados e continua sem poluição de contexto

Perguntas frequentes (FAQs)

Veja também