Configuración y personalización

Verdent for VS Code ofrece amplias opciones de configuración para adaptarse a tu flujo de trabajo de desarrollo, tus preferencias de programación y los estándares de tu equipo. Configura los ajustes mediante la interfaz nativa de configuración de VS Code, personaliza los atajos de teclado y crea reglas y subagentes para comportamientos especializados.

Lo que aprenderás

• Configurar los ajustes de la extensión VS Code para Verdent
• Personalizar los atajos de teclado para un flujo de trabajo eficiente
• Crear y gestionar reglas para personalizar el comportamiento del agente
• Construir subagentes personalizados para tareas especializadas

Requisitos previos

• Verdent for VS Code instalado y autenticado
• Acceso a la configuración de VS Code (Cmd+, o Ctrl+,)
• Conocimientos básicos de JSON para los archivos de reglas (opcional)

Ajustes de la extensión VS Code

A los ajustes de Verdent for VS Code se accede desde varias ubicaciones según el tipo de configuración y su alcance.

Acceder a los ajustes

Ajustes de la extensión (nativos de VS Code):

1. Abre la configuración de VS Code: Cmd+, (macOS) o Ctrl+, (Windows/Linux)
2. Busca "Verdent" en la barra de búsqueda de ajustes
3. Modifica los ajustes de la extensión (por ejemplo, verdent.enableCheckpoints)

Ajustes específicos de Verdent:

Selecciona el botón Settings en la barra superior de Verdent para acceder a:

• Rules - User Rules, Project Rules, Plan Rules
• Servidores MCP - Configuraciones de Model Context Protocol
• Subagents - Gestión de subagentes personalizados

Controles dentro del chat:

Muchos ajustes pueden activarse directamente desde el cuadro de entrada en la parte inferior del panel de Verdent:

• Switch Permission - Manual Accept, Auto-Run, Plan, Skip Permissions
• Switch Mode - modos Agent, Plan, Chat
• Switch/Customize AI Model - presets de Performance, Balance, Efficiency
• Think Hard Mode - presupuesto máximo de razonamiento para análisis complejos
• Add Context - adjunta archivos usando menciones con @
• Add Images or Files - incluye capturas de pantalla o documentos
• Add Subagent - delega en subagentes especializados

Los cambios de configuración surten efecto de inmediato sin necesidad de reiniciar VS Code.

Ajustes de extensión disponibles

Verdent for VS Code ofrece 2 ajustes de extensión principales que pueden configurarse mediante la interfaz de ajustes de VS Code:

Referencia de controles del cuadro de entrada

El cuadro de entrada en la parte inferior del panel de Verdent proporciona acceso rápido a los controles de configuración:

Modos de permiso

Presets de modelo

Personalización de atajos de teclado

Atajos predeterminados

Atajo principal:

• macOS: Cmd+L - Abrir/enfocar el panel de Verdent
• Windows/Linux: Ctrl+L - Abrir/enfocar el panel de Verdent
  • Comando: verdent.addToChat
  • Funciona desde la paleta de comandos y el contexto del editor

Este es el atajo esencial para acceder rápidamente a Verdent desde cualquier lugar de VS Code sin interrumpir tu flujo de programación.

Comandos adicionales:

Disponibles a través de la paleta de comandos (los atajos predeterminados pueden personalizarse):

• verdent.addFeedBack - Enviar comentarios
• verdent.addTerminalOutputToChat - Añadir la salida del terminal a Verdent
• verdent.addToChatBySearch - Añadir a Verdent mediante búsqueda
• verdent.centerButtonClicked - Centro de usuario
• verdent.historyButtonClicked - Historial del proyecto
• verdent.mcpButtonClicked - Añadir servidor MCP
• verdent.openInNewTabByParams - Abrir en una pestaña nueva
• verdent.plusButtonClicked - Nueva sesión
• verdent.rulesButtonClicked - Configuración de reglas
• verdent.SettingClicked - Menú de ajustes
• verdent.subagentButtonClicked - Añadir subagente

Personalizar atajos

Todos los atajos de teclado de Verdent pueden personalizarse mediante el sistema estándar de asignación de teclas de VS Code.

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

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

Alcance de la personalización:

• Todos los comandos de Verdent pueden reasignarse
• Pueden asignarse múltiples atajos al mismo comando
• Los atajos predeterminados pueden eliminarse
• Los cambios se sincronizan entre equipos con la sincronización de ajustes de VS Code

Atajos específicos de plataforma

Verdent sigue las convenciones de teclado específicas de cada plataforma de VS Code:

Patrones comunes:

• Ajustes: Cmd+, (macOS) frente a Ctrl+, (Windows/Linux)
• Paleta de comandos: Cmd+Shift+P (macOS) frente a Ctrl+Shift+P (Windows/Linux)
• Atajos de teclado: Cmd+K Cmd+S (macOS) frente a Ctrl+K Ctrl+S (Windows/Linux)

Instrucciones personalizadas y personas

Verdent for VS Code admite dos sistemas para personalizar el comportamiento de la IA: Rules para preferencias y directrices, y Subagents para personas de tareas especializadas.

Sistema de reglas

Las reglas definen cómo se comporta y responde Verdent durante las sesiones de programación. Las reglas se almacenan en archivos Markdown y se aplican de forma continua a lo largo de las conversaciones.

Tres tipos de reglas

1. User Rules (VERDENT.md):

• Ubicación: ~/.verdent/ (directorio de configuración global)
• Alcance: Se aplican a todas las conversaciones en todos los proyectos
• Propósito: Preferencias personales de programación, estilo de comunicación, estándares de documentación

2. Project Rules (AGENTS.md):

• Ubicación: Directorio raíz del proyecto o espacio de trabajo
• Alcance: Se aplican solo al proyecto actual
• Control de versiones: Pueden confirmarse en git para estándares de todo el equipo
• Propósito: Estándares de programación específicos del proyecto, patrones de arquitectura, requisitos de pruebas

3. Plan Rules (plan_rules.md):

• Ubicación: ~/.verdent/ (directorio de configuración global)
• Alcance: Se aplican al usar Plan Mode en todos los proyectos
• Propósito: Personalizar el contenido, el formato y el nivel de detalle del plan

Crear y editar reglas

Ejemplo 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

Ejemplo 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

Almacenamiento y aplicación de las reglas

Prioridad de configuración:

Cuando las reglas entran en conflicto, Verdent aplica este orden de prioridad:

1. Project Rules (AGENTS.md) - Máxima prioridad (específicas del proyecto)
2. User Rules (VERDENT.md) - Preferencias globales del usuario
3. Comportamiento predeterminado - Los valores predeterminados integrados de Verdent

Subagentes

Los subagentes son agentes de IA especializados con prompts de sistema personalizados y ventanas de contexto aisladas para gestionar tareas específicas.

Subagentes integrados

Verdent incluye tres subagentes predeterminados disponibles de inmediato sin configuración:

Crear subagentes personalizados

Formato del archivo del subagente:

---
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

Gestionar subagentes

Accede a través de Settings → Subagents para:

• Edit: Modificar prompts de sistema, permisos de herramientas y configuraciones
• Copy: Duplicar subagentes para crear variaciones o plantillas
• Delete: Eliminar subagentes no utilizados
• Enable/Disable: Alternar la disponibilidad sin eliminar

Usar subagentes

Subagentes integrados:

• Referéncialos con menciones con @: @Verifier, @Explorer, @Code-reviewer
• Se invocan automáticamente cuando se detectan los tipos de tarea apropiados

Subagentes personalizados:

• Selecciona el botón Add Subagent en el cuadro de entrada
• Elige uno del menú desplegable
• El agente principal delega automáticamente las tareas apropiadas

Subagentes frente a reglas

Ejemplo de flujo de trabajo:

1. User Rule: "Generar pruebas unitarias para todas las funciones nuevas"
2. Agente principal: Detecta la necesidad de generar pruebas
3. Delega en el subagente Test Generator: Enfoque de pruebas exhaustivo y especializado
4. Subagente: Genera un conjunto completo de pruebas con contexto aislado
5. Agente principal: Recibe los resultados y continúa sin contaminar el contexto

Preguntas frecuentes

Consulta también