Hilo de meng shao (@shao__meng)

[Guía práctica] Cómo comprender de forma eficiente bases de código desconocidas mediante Cursor: flujos de trabajo estructurados y descomposición de bases de código complejas en documentación fácilmente comprensible alternando entre diferentes modos y modelos El objetivo principal es aprovechar la IA para comprender rápida y profundamente la arquitectura del código, la pila de tecnología y la lógica empresarial de un nuevo proyecto y generar documentación que pueda consultarse repetidamente. El análisis detallado del flujo de trabajo divide el proceso de comprensión del código en siete pasos claros, que resumimos a continuación: 1. Exploración de seguridad y análisis global (fase de preparación) Habilitar el "Modo Preguntar": • Operación: Cambie el cursor al modo Preguntar. Propósito: Este es un modo de solo lectura para evitar modificaciones accidentales del código durante la exploración y garantizar la seguridad de la base del código. Búsqueda rápida: • Operación: Seleccione el modelo más rápido Composer 1 y déjelo escanear (grep) toda la base de código y las subcarpetas clave. • Objetivo: Permitir que la IA obtenga una comprensión preliminar a nivel macro del proyecto a través de un escaneo rápido. 2. Desarrollar un plan de aprendizaje (fase de planificación) Generar un plan de comprensión: • Operación: Cambiar al modo de planificación. • Instrucción: Requerir que la IA cree un plan sobre "cómo entender la base del código". • Enfoque en el contenido: comenzando con la integración de tecnología (como bibliotecas de terceros como Resend y AI SDK), pasando gradualmente a la estructura de directorio de archivos. • Objetivo: En lugar de leer código a ciegas, deje que la IA lo ayude a planificar una ruta de aprendizaje lógicamente clara. 3. Generación automatizada de documentos (fase de ejecución) Indexación y descomposición de profundidad: • Operación: guarde el plan del paso anterior como un archivo Markdown, cambie al modo de agente y seleccione un modelo potente. • Comando: Instruye al Agente para que indexe toda la base de datos y comience a dividir la base de código en múltiples documentos Markdown. Categorías de documentos: • Frontend (Arquitectura Frontend) • Backend (arquitectura de backend) • Recorrido del usuario (proceso de negocio) • Avería técnica 4. Asistencia visual (etapa avanzada) Diagrama de arquitectura compleja: • Escenario: si el proyecto contiene componentes complejos como Redis y microservicios, las descripciones textuales simples no son lo suficientemente intuitivas. • Acción: volver al modelo Claude. • Objetivo: Aprovechar las poderosas capacidades de comprensión contextual de Claude para generar diagramas de arquitectura o diagramas de flujo de flujos de trabajo de productos, lo que ayuda en la comprensión visual. 5. Revisión e iteración (fase de internalización) Lectura y preguntas y respuestas: • Operación: cambie al modo de vista previa para leer el documento generado. • Bucle: si encuentras algún detalle que no entiendes, puedes volver al modo Preguntar y pedir ayuda a la IA. • Repetición: repita este proceso varias veces hasta que se establezca un marco cognitivo básico. 💡Conclusión clave: «Un mal bolígrafo es peor que una buena memoria». No te limites a leer pasivamente durante todo el proceso. Enfócate en desarrollar dos hábitos para tomar notas: • Notas de implementación de ingeniería: un breve registro de la lógica detrás de cómo se implementa una función específica. • Nombres de archivos clave: registre los nombres de los archivos importantes involucrados en el flujo de trabajo principal para localizarlos fácilmente más adelante. La esencia de este enfoque reside en "dividir y vencer" y "escribir en lugar de leer". En lugar de sumergirte directamente en un mar de código, primero utiliza las capacidades de planificación de la IA para generar un plan, luego utiliza sus capacidades de ejecución para generar instrucciones y, finalmente, aborda las dificultades mediante diagramas específicos.