Fil de meng shao (@shao__meng)

[Guide pratique] Comment comprendre efficacement des bases de code inconnues à l'aide de Cursor : flux de travail structurés et décomposition de bases de code complexes en une documentation facilement compréhensible en alternant entre différents modes et modèles L'objectif principal est d'exploiter l'IA pour comprendre rapidement et en profondeur l'architecture du code, la pile technologique et la logique métier d'un nouveau projet, et générer une documentation pouvant être consultée à plusieurs reprises. L'analyse détaillée du flux de travail divise le processus de compréhension du code en sept étapes claires, que nous résumons comme suit : 1. Exploration de la sécurité et analyse globale (Phase de préparation) Activer le « mode Demande » : • Opération : Basculez le curseur en mode Demande. Objectif : Il s’agit d’un mode en lecture seule destiné à empêcher toute modification accidentelle du code lors de son exploration et à garantir la sécurité de la base de code. Recherche rapide : • Opération : Sélectionnez le modèle plus rapide Composer 1 et laissez-le analyser (grep) l'ensemble du code source et les principaux sous-dossiers. • Objectif : Permettre à l'IA d'acquérir une compréhension préliminaire et macroscopique du projet grâce à une analyse rapide. 2. Élaborer un plan d'apprentissage (phase de planification) Élaborer un plan de compréhension : • Fonctionnement : Passer en mode Plan. • Consigne : Exiger que l'IA élabore un plan sur « la manière de comprendre le code source ». • Priorité au contenu : en commençant par l’intégration technologique (telle que les bibliothèques tierces comme Resend et le SDK d’IA), puis en passant progressivement à la structure des répertoires de fichiers. • Objectif : Au lieu de lire du code à l’aveuglette, laissez l’IA vous aider à planifier un parcours d’apprentissage logique et clair. 3. Génération automatisée de documents (phase d'exécution) Indexation et décomposition en profondeur : • Opération : Enregistrez le plan de l'étape précédente au format Markdown, passez en mode Agent et sélectionnez un modèle performant. • Commande : Demandez à l'agent d'indexer l'intégralité de la base de données et de commencer à décomposer le code source en plusieurs documents Markdown. Catégories de documents : • Architecture front-end • Architecture backend • Parcours utilisateur (processus métier) • Panne technique 4. Assistance visuelle (Niveau avancé) Diagramme d'architecture complexe : • Scénario : Si le projet contient des composants complexes tels que Redis et des microservices, de simples descriptions textuelles ne sont pas suffisamment intuitives. • Action : Revenir au modèle Claude. • Objectif : Tirer parti des puissantes capacités de compréhension contextuelle de Claude pour générer des diagrammes d'architecture ou des organigrammes des flux de travail des produits, facilitant ainsi la compréhension visuelle. 5. Révision et itération (Phase d'internalisation) Lecture et questions-réponses : • Opération : Passez en mode aperçu pour lire le document généré. • Boucle : Si vous rencontrez des détails que vous ne comprenez pas, vous pouvez revenir au mode Demande et demander de l'aide à l'IA. • Répétition : Répétez ce processus plusieurs fois jusqu'à ce qu'un cadre cognitif de base soit établi. 💡 Point clé : « Un mauvais stylo est pire qu’une bonne mémoire » — Ne vous contentez pas de lire passivement. Mettez l’accent sur le développement de deux habitudes de prise de notes : • Notes d'implémentation technique : Un bref compte rendu de la logique sous-jacente à la mise en œuvre d'une fonction spécifique. • Noms des fichiers clés : Notez les noms des fichiers importants impliqués dans le flux de travail principal afin de pouvoir les localiser facilement ultérieurement. L'essence de cette approche réside dans le principe de « diviser pour mieux régner » et dans la préférence pour l'écriture plutôt que la lecture. Au lieu de vous plonger directement dans un océan de code, elle utilise d'abord les capacités de planification de l'IA pour générer un plan, puis ses capacités d'exécution pour générer des instructions, et enfin elle s'attaque aux difficultés grâce à des diagrammes ciblés.