🧭 Sommaire
Une Communication Contextuelle Révolutionnaire
🎯 Pourquoi les Mentions de Contexte ?
- • Précision : Informations exactes et ciblées
- • Efficacité : Réduction du temps de communication
- • Contexte : Compréhension profonde du projet
- • Automatisation : Collecte automatique d'informations
- • Intégration : Connexion native avec VS Code
- • Flexibilité : Multiples types de références
Les mentions de contexte représentent une innovation majeure dans l'interaction avec les assistants IA. Plutôt que de copier-coller manuellement du code ou de décrire verbalement des problèmes, Roocode vous permet de référencer directement les éléments de votre projet avec une simple mention.
Cette approche transforme radicalement votre workflow en permettant à Roocode d'accéder instantanément aux informations pertinentes : contenu de fichiers, diagnostics d'erreurs, historique Git, sortie de terminal, et même contenu web externe.
💡 Exemple Rapide
Au lieu d'écrire : "J'ai une erreur dans mon fichier utils.ts à la ligne 42, voici le code..."
Écrivez simplement : "@/src/utils.ts @problems Corrige l'erreur dans cette fonction"
Roocode accède automatiquement au fichier et aux diagnostics d'erreur pour une assistance précise.
Types de Mentions Disponibles
📁Mentions de Fichiers
Référencez directement le contenu de fichiers spécifiques avec leurs numéros de ligne.
@/src/components/Header.tsx📂Mentions de Dossiers
Incluez le contenu de tous les fichiers d'un dossier pour une vue d'ensemble.
@/src/components🚨Mentions de Problèmes
Importez automatiquement tous les diagnostics du panneau Problèmes de VS Code.
@problems💻Mentions Terminal
Capturez la dernière commande et sa sortie pour un débogage contextuel.
@terminal🔀Mentions Git
Référencez des commits spécifiques ou les changements non committés.
@a1b2c3d @git-changes🌐Mentions URL
Importez du contenu web externe converti automatiquement en Markdown.
@https://example.comMentions de Fichiers : Précision Maximale
📁 Fonctionnement des Mentions de Fichiers
✨ Avantages
- • Contenu complet avec numéros de ligne
- • Support multi-format : texte, PDF, DOCX
- • Référence précise pour discussions
- • Mise à jour automatique du contexte
⚠️ Limitations
- • Fichiers très volumineux peuvent être tronqués
- • Fichiers binaires non supportés
- • Chemin doit commencer par
/ - • Sensible à la casse
💡 Exemples Pratiques
1. Analyse de Code
Prompt :
"Analyse la performance de @/src/utils/dataProcessor.ts et suggère des optimisations"
Résultat :
Roocode accède automatiquement au fichier, analyse le code ligne par ligne, et propose des optimisations spécifiques avec références aux numéros de ligne.
2. Débogage Ciblé
Prompt :
"La fonction getUserData dans @/src/api/users.ts retourne undefined, peux-tu identifier le problème ?"
Résultat :
Roocode examine le fichier, identifie la fonction spécifique, analyse la logique et propose une correction avec explication détaillée.
3. Documentation Automatique
Prompt :
"Génère une documentation complète pour @/src/components/DataTable.tsx"
Résultat :
Documentation automatique avec description des props, méthodes, exemples d'usage et intégration dans le projet.
Mentions de Dossiers : Vue d'Ensemble
📂 Analyse Contextuelle de Dossiers
Les mentions de dossiers permettent d'inclure le contenu de tous les fichiers d'un répertoire spécifique, offrant à Roocode une vue d'ensemble complète pour des analyses architecturales et des refactorisations globales.
🔍 Comportement Important
- • Non-récursif : Seuls les fichiers directs du dossier
- • Fichiers texte uniquement : Binaires automatiquement exclus
- • Filtrage intelligent : Exclusion de node_modules, .git, etc.
- • Limite de contexte : Attention aux dossiers volumineux
🎯 Cas d'Usage Optimaux
Analyse d'Architecture
"Analyse l'architecture de @/src/components et suggère des améliorations"
→ Roocode examine tous les composants, identifie les patterns, dépendances et propose une restructuration optimisée.
Refactoring Global
"Refactorise @/src/utils pour utiliser TypeScript strict"
→ Analyse de tous les utilitaires et migration cohérente vers TypeScript avec types stricts.
Documentation Globale
"Crée une documentation pour l'API dans @/src/api"
→ Documentation complète de tous les endpoints avec exemples et schémas de données.
Tests Automatisés
"Génère des tests unitaires pour @/src/services"
→ Création de tests complets pour tous les services avec mocks et cas de test appropriés.
Mentions de Problèmes : Débogage Intelligent
🚨 Intégration Native avec VS Code
La mention @problems révolutionne le débogage en important automatiquement tous les diagnostics du panneau Problèmes de VS Code. Plus besoin de copier-coller les erreurs - Roocode accède directement aux informations structurées.
📊 Informations Incluses
- • Chemins de fichiers complets
- • Numéros de ligne et colonnes précis
- • Messages d'erreur détaillés
- • Niveau de sévérité (erreur/warning/info)
- • Source du diagnostic (TypeScript, ESLint, etc.)
🎯 Avantages
- • Gain de temps considérable
- • Contexte complet automatique
- • Priorisation par sévérité
- • Groupement par fichier
- • Synchronisation en temps réel
🔧 Exemples de Débogage
Correction d'Erreurs TypeScript
"@problems Corrige toutes les erreurs TypeScript dans le projet"
Exemple de diagnostic importé :
src/components/UserCard.tsx:23:15
Error TS2339: Property 'email' does not exist on type 'User'
Source: TypeScript
Résolution de Warnings ESLint
"@problems Optimise le code en résolvant tous les warnings ESLint"
Roocode analyse tous les warnings, propose des corrections automatiques et explique l'impact de chaque modification sur la qualité du code.
Débogage Combiné
"@problems @/src/api/auth.ts Corrige les erreurs dans ce fichier spécifique"
Combinaison puissante : diagnostics globaux + contenu de fichier spécifique pour une résolution ciblée et contextuelle.
Mentions Terminal : Contexte d'Exécution
💻 Capture Intelligente du Terminal
La mention @terminal capture automatiquement la dernière commande exécutée dans votre terminal VS Code ainsi que sa sortie complète. Cette fonctionnalité est particulièrement utile pour le débogage d'erreurs de compilation, d'installation ou d'exécution.
📊 Informations Capturées
- • Commande exécutée avec arguments
- • Sortie complète (stdout et stderr)
- • Code de retour de la commande
- • Contexte d'exécution (répertoire, environnement)
⚡ Limitations
- • Limité au buffer visible du terminal
- • Ne vide pas le terminal après capture
- • Une seule commande à la fois
- • Dépend de l'état actuel du terminal
🔧 Exemples d'Usage
Débogage d'Erreurs de Build
"@terminal Analyse l'erreur de compilation et propose une solution"
Roocode examine la sortie d'erreur, identifie le problème spécifique et propose des corrections ciblées avec explications détaillées.
Optimisation de Commandes
"@terminal Cette commande est-elle optimale ? Suggère des améliorations"
Analyse de la commande exécutée et proposition d'alternatives plus efficaces ou de flags supplémentaires pour améliorer les performances.
Interprétation de Logs
"@terminal Explique cette sortie et identifie les points d'attention"
Décryptage des logs complexes, identification des warnings importants et explication des métriques de performance.
Mentions Git : Historique et Changements
🔀 Intégration Git Avancée
Roocode offre deux types de mentions Git puissantes : les références de commits spécifiques et l'accès aux changements non committés. Cette intégration permet une analyse contextuelle de l'évolution de votre code.
📝 Mentions de Commits
Format : @a1b2c3d (hash du commit)
- • Message de commit complet
- • Auteur et date
- • Diff détaillé des changements
- • Fichiers modifiés
🔄 Changements en Cours
Format : @git-changes
- • Sortie de
git status - • Diff des modifications non committées
- • Fichiers stagés et non-stagés
- • Nouveaux fichiers non trackés
🎯 Cas d'Usage Pratiques
Analyse de Commits
"Que fait exactement le commit @a1b2c3d ? Explique les changements et leur impact"
Roocode analyse le diff, explique la logique des modifications et identifie les implications sur le reste du code.
Génération de Messages de Commit
"@git-changes Génère un message de commit approprié pour ces changements"
Analyse des modifications en cours et génération d'un message de commit descriptif suivant les conventions du projet.
Revue de Code Assistée
"@git-changes Effectue une revue de code de mes changements actuels"
Revue automatique des modifications avec suggestions d'amélioration, détection de problèmes potentiels et vérification des bonnes pratiques.
Mentions URL : Intégration Web
🌐 Import de Contenu Web
Les mentions URL permettent d'importer directement du contenu web externe dans vos conversations avec Roocode. Le contenu est automatiquement nettoyé et converti en Markdown pour une meilleure lisibilité.
🔄 Processus de Traitement
Récupération
- • Navigateur headless automatique
- • Support JavaScript et contenu dynamique
- • Gestion des redirections
Nettoyage
- • Suppression des scripts et styles
- • Élimination de la navigation
- • Conversion en Markdown propre
💡 Exemples d'Utilisation
Documentation Externe
"Résume les points clés de @https://docs.react.dev/learn/thinking-in-react"
Import et synthèse automatique de documentation technique externe avec extraction des concepts essentiels.
Analyse d'Articles Techniques
"Compare les approches décrites dans @https://example.com/article avec notre implémentation actuelle"
Analyse comparative entre les bonnes pratiques externes et votre code existant avec suggestions d'amélioration.
Veille Technologique
"Quelles sont les implications de @https://blog.example.com/new-feature pour notre projet ?"
Évaluation de l'impact des nouvelles technologies ou fonctionnalités sur votre projet avec recommandations d'adoption.
Guide d'Utilisation Pratique
🎯 Comment Utiliser les Mentions
1. Déclenchement du Menu
Tapez @ dans le chat pour déclencher automatiquement le menu de suggestions.
2. Sélection et Validation
Sélectionnez avec Entrée ou clic souris.
- • Fichiers récemment ouverts
- • Dossiers visibles
- • Commits Git récents
- • Mots-clés spéciaux (problems, terminal, git-changes)
3. Combinaisons Multiples
Combinez plusieurs mentions dans une même requête pour un contexte enrichi.
"Corrige @problems dans @/src/components/Header.tsx en utilisant les infos de @terminal"
Bonnes Pratiques et Optimisations
✅ À Faire
- • Soyez spécifique : Mentionnez les fichiers exacts plutôt que des dossiers entiers
- • Combinez intelligemment : Associez @problems avec des fichiers spécifiques
- • Utilisez @terminal immédiatement après une erreur
- • Exploitez @git-changes avant de committer
- • Vérifiez les chemins : Commencez toujours par /
❌ À Éviter
- • Dossiers trop volumineux : Limitez les mentions de gros répertoires
- • Fichiers binaires : Ne fonctionnent pas avec les mentions
- • Chemins relatifs : Utilisez toujours des chemins absolus
- • Surcharge de contexte : Trop de mentions peuvent diluer l'attention
- • URLs complexes : Certaines pages peuvent mal se convertir
🚀 Optimisations Avancées
Gestion des Fichiers .rooignore
Les mentions de fichiers et dossiers contournent les règles .rooignore et .gitignore.
Filtrage Automatique
Le menu de suggestions filtre automatiquement les répertoires courants commenode_modules, .git, dist, et outpour réduire le bruit, même si leur contenu peut être inclus manuellement.
Fichiers Ouverts Prioritaires
Tous les fichiers actuellement ouverts dans VS Code apparaissent dans les suggestions, indépendamment des paramètres d'ignore ou des filtres de répertoire.
Conclusion : Maximiser l'Efficacité
🎯 L'Impact des Mentions de Contexte
Les mentions de contexte transforment fondamentalement la façon dont vous interagissez avec Roocode. En éliminant le besoin de copier-coller du code ou de décrire manuellement des problèmes, elles créent un flux de travail fluide et naturel.
🚀 Prochaines Étapes
1. Expérimentez Progressivement
Commencez par les mentions de fichiers simples, puis explorez graduellement les combinaisons plus complexes avec @problems et @terminal.
2. Intégrez dans Votre Workflow
Adoptez les mentions Git pour vos revues de code et utilisez @terminal systématiquement après chaque erreur de compilation.
3. Explorez les Combinaisons
Découvrez la puissance des mentions multiples pour créer des contextes riches et obtenir des analyses approfondies de votre code.
💡 Conseil Final
Les mentions de contexte ne sont pas seulement un raccourci - elles représentent une nouvelle façon de penser l'assistance IA. En fournissant un contexte précis et structuré, vous permettez à Roocode de vous offrir une aide véritablement personnalisée et pertinente pour votre projet spécifique.
Articles Connexes
Les Modes Spécialisés de Roocode : Guide Complet 2025
Découvrez en profondeur les différents modes de Roocode - Code, Architect, Debug, Orchestrator et plus. Comment chaque m...
Gestion du Contexte dans Roocode : La Compréhension Intelligente de Votre Projet
Comment Roocode analyse et comprend la structure de votre projet pour offrir une assistance véritablement contextuelle....
L'Implémentation MCP dans Roocode : Extensibilité Avancée
Découvrez comment Roocode implémente le Model Context Protocol (MCP) d'Anthropic pour une extensibilité révolutionnaire....
Intégrations de Roocode avec les Outils de Développement
Toutes les intégrations de Roocode avec l'écosystème de développement moderne : GitHub, AWS, Docker, et plus. Comment cr...
Restez Informé
Recevez les dernières actualités sur l'IA et le développement directement dans votre boîte mail. Conseils exclusifs, nouveautés Roocode et analyses approfondies.
En vous inscrivant, vous acceptez de recevoir nos emails. Vous pouvez vous désinscrire à tout moment.
