Configurazione e personalizzazione

Verdent for VS Code offre ampie opzioni di configurazione per adattarsi al tuo flusso di lavoro di sviluppo, alle tue preferenze di scrittura del codice e agli standard del team. Configura le impostazioni tramite l'interfaccia nativa di VS Code, personalizza le scorciatoie da tastiera e crea regole e sottoagenti per comportamenti specializzati.

Cosa imparerai

• Configurare le impostazioni dell'estensione VS Code per Verdent
• Personalizzare le scorciatoie da tastiera per un flusso di lavoro efficiente
• Creare e gestire regole per un comportamento personalizzato dell'agente
• Creare sottoagenti personalizzati per attività specializzate

Prerequisiti

• Verdent for VS Code installato e autenticato
• Accesso alle impostazioni di VS Code (Cmd+, o Ctrl+,)
• Conoscenza di base di JSON per i file delle regole (facoltativa)

Impostazioni dell'estensione VS Code

Le impostazioni di Verdent for VS Code sono accessibili da più posizioni a seconda del tipo di configurazione e dell'ambito.

Accedere alle impostazioni

Impostazioni dell'estensione (VS Code native):

1. Apri le impostazioni di VS Code: Cmd+, (macOS) o Ctrl+, (Windows/Linux)
2. Cerca "Verdent" nella barra di ricerca delle impostazioni
3. Modifica le impostazioni dell'estensione (es. verdent.enableCheckpoints)

Impostazioni specifiche di Verdent:

Seleziona il pulsante Settings nella barra superiore di Verdent per accedere a:

• Rules - Regole utente, regole di progetto, regole del piano
• Server MCP - Configurazioni Model Context Protocol
• Subagents - Gestione dei sottoagenti personalizzati

Controlli in chat:

Molte impostazioni possono essere attivate direttamente dalla casella di input in fondo al pannello di Verdent:

• Switch Permission - Manual Accept, Auto-Run, Plan, Skip Permissions
• Switch Mode - modalità Agent, Plan, Chat
• Switch/Customize AI Model - preset Performance, Balance, Efficiency
• Think Hard Mode - Budget massimo di ragionamento per il pensiero complesso
• Add Context - Allega file usando le @-menzioni
• Add Images or Files - Includi screenshot o documenti
• Add Subagent - Delega a sottoagenti specializzati

Le modifiche alle impostazioni hanno effetto immediatamente senza richiedere il riavvio di VS Code.

Riferimento delle impostazioni dell'estensione disponibili

Verdent for VS Code offre 2 impostazioni principali dell'estensione che possono essere configurate tramite l'interfaccia delle impostazioni di VS Code:

Riferimento dei controlli della casella di input

La casella di input in fondo al pannello di Verdent offre accesso rapido ai controlli di configurazione:

Modalità di autorizzazione

Preset dei modelli

Personalizzazione delle scorciatoie da tastiera

Scorciatoie predefinite

Scorciatoia principale:

• macOS: Cmd+L - Apri/porta in primo piano il pannello di Verdent
• Windows/Linux: Ctrl+L - Apri/porta in primo piano il pannello di Verdent
  • Comando: verdent.addToChat
  • Funziona dalla Command Palette e dal contesto dell'editor

Questa è la scorciatoia essenziale per accedere rapidamente a Verdent da qualsiasi punto di VS Code senza interrompere il flusso di lavoro.

Comandi aggiuntivi:

Disponibili tramite la Command Palette (le scorciatoie predefinite possono essere personalizzate):

• verdent.addFeedBack - Invia feedback
• verdent.addTerminalOutputToChat - Aggiungi l'output del terminale a Verdent
• verdent.addToChatBySearch - Aggiungi a Verdent tramite ricerca
• verdent.centerButtonClicked - Centro utente
• verdent.historyButtonClicked - Cronologia del progetto
• verdent.mcpButtonClicked - Aggiungi server MCP
• verdent.openInNewTabByParams - Apri in una nuova scheda
• verdent.plusButtonClicked - Nuova sessione
• verdent.rulesButtonClicked - Impostazioni delle regole
• verdent.SettingClicked - Menu delle impostazioni
• verdent.subagentButtonClicked - Aggiungi sottoagente

Personalizzare le scorciatoie

Tutte le scorciatoie da tastiera di Verdent possono essere personalizzate usando il sistema di keybinding standard di VS Code.

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

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

Ambito della personalizzazione:

• Tutti i comandi di Verdent possono essere rimappati
• È possibile assegnare più scorciatoie allo stesso comando
• Le scorciatoie predefinite possono essere rimosse
• Le modifiche si sincronizzano tra le macchine con Settings Sync di VS Code

Scorciatoie specifiche per piattaforma

Verdent segue le convenzioni di tastiera specifiche per piattaforma di VS Code:

Schemi comuni:

• Impostazioni: Cmd+, (macOS) vs Ctrl+, (Windows/Linux)
• Command Palette: Cmd+Shift+P (macOS) vs Ctrl+Shift+P (Windows/Linux)
• Scorciatoie da tastiera: Cmd+K Cmd+S (macOS) vs Ctrl+K Ctrl+S (Windows/Linux)

Istruzioni personalizzate e persone

Verdent for VS Code supporta due sistemi per personalizzare il comportamento dell'AI: Rules per preferenze e linee guida, e Subagents per persone specializzate su attività.

Sistema di regole

Le regole definiscono come Verdent si comporta e risponde durante le sessioni di scrittura del codice. Le regole sono memorizzate in file Markdown e applicate continuamente durante le conversazioni.

Tre tipi di regole

1. Regole utente (VERDENT.md):

• Posizione: ~/.verdent/ (directory di configurazione globale)
• Ambito: Applicate a tutte le conversazioni in tutti i progetti
• Scopo: Preferenze personali di scrittura del codice, stile di comunicazione, standard di documentazione

2. Regole di progetto (AGENTS.md):

• Posizione: Directory radice del progetto o workspace
• Ambito: Applicate solo al progetto corrente
• Controllo di versione: Possono essere sottoposte a commit in git per standard condivisi in tutto il team
• Scopo: Standard di scrittura del codice specifici del progetto, pattern architetturali, requisiti di test

3. Regole del piano (plan_rules.md):

• Posizione: ~/.verdent/ (directory di configurazione globale)
• Ambito: Applicate quando si usa Plan Mode in tutti i progetti
• Scopo: Personalizzare contenuto, formato e livello di dettaglio del piano

Creare e modificare le regole

Esempio di regole utente:

# 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

Esempio di regole di progetto:

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

Archiviazione e applicazione delle regole

Priorità di configurazione:

Quando le regole entrano in conflitto, Verdent applica questo ordine di priorità:

1. Regole di progetto (AGENTS.md) - Priorità massima (specifiche del progetto)
2. Regole utente (VERDENT.md) - Preferenze utente globali
3. Comportamento predefinito - I valori predefiniti integrati di Verdent

Sottoagenti

I sottoagenti sono agenti AI specializzati con prompt di sistema personalizzati e finestre di contesto isolate per gestire attività specifiche.

Sottoagenti integrati

Verdent include tre sottoagenti predefiniti immediatamente disponibili senza configurazione:

Creare sottoagenti personalizzati

Formato del file del sottoagente:

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

Gestire i sottoagenti

Accedi tramite Settings → Subagents per:

• Edit: Modificare prompt di sistema, permessi degli strumenti, configurazioni
• Copy: Duplicare i sottoagenti per varianti o template
• Delete: Rimuovere i sottoagenti inutilizzati
• Enable/Disable: Attivare/disattivare la disponibilità senza eliminare

Usare i sottoagenti

Sottoagenti integrati:

• Richiamali con le @-menzioni: @Verifier, @Explorer, @Code-reviewer
• Invocati automaticamente quando vengono rilevati i tipi di attività appropriati

Sottoagenti personalizzati:

• Seleziona il pulsante Add Subagent nella casella di input
• Seleziona dal menu a discesa
• L'agente principale delega automaticamente le attività appropriate

Sottoagenti vs regole

Esempio di flusso di lavoro:

1. Regola utente: "Genera test unitari per tutte le nuove funzioni"
2. Agente principale: Rileva la necessità di generare test
3. Delega al sottoagente Test Generator: Approccio di test specializzato e completo
4. Sottoagente: Genera una suite di test completa con contesto isolato
5. Agente principale: Riceve i risultati e prosegue senza inquinare il contesto

FAQ (domande frequenti)

Vedi anche