Configuration et personnalisation

Verdent for VS Code offre de nombreuses options de configuration pour s'adapter à votre flux de travail de développement, à vos préférences de codage et aux standards de votre équipe. Configurez les paramètres via l'interface de paramètres native de VS Code, personnalisez les raccourcis clavier, et créez des règles et des sous-agents pour un comportement spécialisé.

Ce que vous allez apprendre

• Configurer les paramètres de l'extension VS Code pour Verdent
• Personnaliser les raccourcis clavier pour un flux de travail efficace
• Créer et gérer des règles pour un comportement d'agent personnalisé
• Créer des sous-agents personnalisés pour des tâches spécialisées

Prérequis

• Verdent for VS Code installé et authentifié
• Accès aux paramètres de VS Code (Cmd+, ou Ctrl+,)
• Compréhension de base du JSON pour les fichiers de règles (facultatif)

Paramètres de l'extension VS Code

Les paramètres de Verdent for VS Code sont accessibles à plusieurs endroits selon le type et la portée de la configuration.

Accéder aux paramètres

Paramètres de l'extension (natifs de VS Code) :

1. Ouvrez les paramètres de VS Code : Cmd+, (macOS) ou Ctrl+, (Windows/Linux)
2. Recherchez « Verdent » dans la barre de recherche des paramètres
3. Modifiez les paramètres de l'extension (par exemple, verdent.enableCheckpoints)

Paramètres spécifiques à Verdent :

Sélectionnez le bouton Settings dans la barre supérieure de Verdent pour accéder à :

• Rules - règles utilisateur, règles de projet, règles de plan
• Serveurs MCP - configurations du Model Context Protocol
• Subagents - gestion des sous-agents personnalisés

Contrôles dans le chat :

De nombreux paramètres peuvent être activés directement depuis la zone de saisie en bas du panneau Verdent :

• Switch Permission - Manual Accept, Auto-Run, Plan, Skip Permissions
• Switch Mode - modes Agent, Plan, Chat
• Switch/Customize AI Model - préréglages Performance, Balance, Efficiency
• Think Hard Mode - budget de réflexion maximal pour un raisonnement complexe
• Add Context - joindre des fichiers via des mentions @
• Add Images or Files - inclure des captures d'écran ou des documents
• Add Subagent - déléguer à des sous-agents spécialisés

Les changements de paramètres prennent effet immédiatement, sans nécessiter le redémarrage de VS Code.

Paramètres d'extension disponibles

Verdent for VS Code propose 2 paramètres d'extension essentiels qui peuvent être configurés via l'interface de paramètres de VS Code :

Référence des contrôles de la zone de saisie

La zone de saisie en bas du panneau Verdent donne un accès rapide aux contrôles de configuration :

Modes de permission

Préréglages de modèle

Personnalisation des raccourcis clavier

Raccourcis par défaut

Raccourci principal :

• macOS : Cmd+L - ouvrir/donner le focus au panneau Verdent
• Windows/Linux : Ctrl+L - ouvrir/donner le focus au panneau Verdent
  • Commande : verdent.addToChat
  • Fonctionne depuis la palette de commandes et le contexte de l'éditeur

Il s'agit du raccourci essentiel pour accéder rapidement à Verdent depuis n'importe où dans VS Code sans interrompre votre flux de codage.

Commandes supplémentaires :

Disponibles via la palette de commandes (les raccourcis par défaut peuvent être personnalisés) :

• verdent.addFeedBack - donner un retour
• verdent.addTerminalOutputToChat - ajouter la sortie du terminal à Verdent
• verdent.addToChatBySearch - ajouter à Verdent par recherche
• verdent.centerButtonClicked - centre utilisateur
• verdent.historyButtonClicked - historique du projet
• verdent.mcpButtonClicked - ajouter un serveur MCP
• verdent.openInNewTabByParams - ouvrir dans un nouvel onglet
• verdent.plusButtonClicked - nouvelle session
• verdent.rulesButtonClicked - paramètres des règles
• verdent.SettingClicked - menu des paramètres
• verdent.subagentButtonClicked - ajouter un sous-agent

Personnaliser les raccourcis

Tous les raccourcis clavier de Verdent peuvent être personnalisés à l'aide du système standard de raccourcis clavier de VS Code.

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

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

Portée de la personnalisation :

• Toutes les commandes Verdent peuvent être reconfigurées
• Plusieurs raccourcis peuvent être associés à la même commande
• Les raccourcis par défaut peuvent être supprimés
• Les changements sont synchronisés entre les machines grâce à la synchronisation des paramètres de VS Code

Raccourcis spécifiques à la plateforme

Verdent respecte les conventions de clavier spécifiques à chaque plateforme de VS Code :

Modèles courants :

• Paramètres : Cmd+, (macOS) vs Ctrl+, (Windows/Linux)
• Palette de commandes : Cmd+Shift+P (macOS) vs Ctrl+Shift+P (Windows/Linux)
• Raccourcis clavier : Cmd+K Cmd+S (macOS) vs Ctrl+K Ctrl+S (Windows/Linux)

Instructions personnalisées et personas

Verdent for VS Code prend en charge deux systèmes pour personnaliser le comportement de l'IA : les règles pour les préférences et les consignes, et les sous-agents pour des personas de tâches spécialisées.

Système de règles

Les règles définissent la manière dont Verdent se comporte et répond pendant les sessions de codage. Elles sont stockées dans des fichiers Markdown et appliquées en continu tout au long des conversations.

Trois types de règles

1. Règles utilisateur (VERDENT.md) :

• Emplacement : ~/.verdent/ (répertoire de configuration global)
• Portée : appliquées à toutes les conversations, dans tous les projets
• Objectif : préférences de codage personnelles, style de communication, standards de documentation

2. Règles de projet (AGENTS.md) :

• Emplacement : répertoire racine du projet ou espace de travail
• Portée : appliquées uniquement au projet en cours
• Contrôle de version : peuvent être versionnées via Git pour des standards partagés au sein de l'équipe
• Objectif : standards de codage spécifiques au projet, modèles d'architecture, exigences de test

3. Règles de plan (plan_rules.md) :

• Emplacement : ~/.verdent/ (répertoire de configuration global)
• Portée : appliquées lors de l'utilisation de Plan Mode dans tous les projets
• Objectif : personnaliser le contenu, le format et le niveau de détail des plans

Créer et modifier des règles

Exemple de règles utilisateur :

# 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

Exemple de règles de projet :

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

Stockage et application des règles

Ordre de priorité de la configuration :

En cas de conflit entre les règles, Verdent applique l'ordre de priorité suivant :

1. Règles de projet (AGENTS.md) - priorité la plus élevée (spécifique au projet)
2. Règles utilisateur (VERDENT.md) - préférences globales de l'utilisateur
3. Comportement par défaut - valeurs par défaut intégrées de Verdent

Sous-agents

Les sous-agents sont des agents IA spécialisés disposant de prompts système personnalisés et de fenêtres de contexte isolées pour traiter des tâches spécifiques.

Sous-agents intégrés

Verdent inclut trois sous-agents par défaut disponibles immédiatement, sans configuration :

Créer des sous-agents personnalisés

Format de fichier de sous-agent :

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

Gérer les sous-agents

Accédez à Settings → Subagents pour :

• Modifier : ajuster les prompts système, les autorisations d'outils, les configurations
• Copier : dupliquer des sous-agents pour créer des variantes ou des modèles
• Supprimer : retirer les sous-agents inutilisés
• Activer/désactiver : basculer la disponibilité sans suppression

Utiliser les sous-agents

Sous-agents intégrés :

• Référencez-les avec des mentions @ : @Verifier, @Explorer, @Code-reviewer
• Invoqués automatiquement lorsque des types de tâches appropriés sont détectés

Sous-agents personnalisés :

• Sélectionnez le bouton Add Subagent dans la zone de saisie
• Choisissez dans le menu déroulant
• L'agent principal délègue automatiquement les tâches appropriées

Sous-agents vs règles

Exemple de flux de travail :

1. Règle utilisateur : « Générer des tests unitaires pour toutes les nouvelles fonctions »
2. Agent principal : détecte le besoin de génération de tests
3. Délègue au sous-agent générateur de tests : approche de test approfondie et spécialisée
4. Sous-agent : génère une suite de tests complète avec un contexte isolé
5. Agent principal : reçoit les résultats et poursuit sans pollution du contexte

FAQ (questions fréquentes)

Voir aussi