Navegador de Rastreo de Funciones (Acción de Usuario → Grafo de Llamadas → Recorrido de Código)
Rastrea una función desde la entrada en la interfaz o API a través de controladores, servicios y capas de datos para generar un grafo de llamadas y un recorrido anotado.
Resumen del prompt
Consejos para ti
- Proporciona registros o nombres de pruebas para precisar rutas de ejecución reales. - Incluye código de manejo de errores para capturar flujos alternativos. - Añade una muestra corta de payload usada en producción.
Del equipo de operacionesNexusAi TechnologyProblema que resuelve
Encontrar la ruta completa de una función a través de las capas es propenso a errores. Esto genera un grafo de llamadas confiable y señala dónde investigar a continuación.
Claridad de Ruta de Extremo a Extremo
Muestra exactamente cómo se mueve la información a través de las capas.
Anotaciones Accionables
Cada paso incluye propósito, entradas/salidas y efectos secundarios.
Detector de Brechas en Pruebas
Resalta pruebas faltantes o débiles a lo largo de la ruta.
Guía del Próximo Archivo
Indica qué leer a continuación y por qué.
Instrucciones del prompt de IA
Actúa como un ingeniero full-stack senior y cartógrafo de código.
Por qué esta tarea es importante:
Los rastreos de extremo a extremo revelan cómo fluye la información, dónde ocurren efectos secundarios y qué componentes son críticos para mantenimiento y pruebas.
Límites importantes:
- Trabaja solo con las rutas, controladores, servicios y fragmentos de modelos proporcionados.
- Si existen variantes múltiples, prioriza la ruta de producción.
Entradas del usuario:
- Descripción de la función (por ejemplo, “Crear Tarea” vía POST /tasks).
- Archivos relevantes: manejadores de rutas, controladores, servicios, modelos, middleware.
- Cualquier registro o nombre de prueba que cubra esta ruta.
Objetivos:
1) Generar un grafo de llamadas claro desde la entrada hasta la persistencia.
2) Anotar funciones clave con propósito, entradas/salidas y efectos secundarios.
3) Identificar riesgos, pruebas faltantes y brechas de observabilidad.
4) Recomendar el orden de los siguientes archivos a revisar.
Flujo de análisis:
1) Comienza en la ruta; localiza llamadas a controladores y servicios.
2) Sigue las transformaciones y validaciones de datos.
3) Registra llamadas externas (BD, colas, HTTP) y manejo de errores.
4) Contrasta con pruebas existentes.
5) Resume preocupaciones sobre rendimiento, fiabilidad y legibilidad.
Formato de salida requerido:
- Grafo de llamadas en texto (lista indentada) para copiar y pegar.
- Anotaciones por paso: propósito, parámetros, salida, efectos secundarios.
- Pruebas faltantes y casos de prueba sugeridos.
- Próximos 5 archivos a revisar.
Controles de calidad:
- Incluye nombres exactos de funciones y rutas de archivos.
- Distingue afirmaciones de conjeturas; marca claramente las conjeturas.
Lista de verificación:
- Todas las capas representadas (ruta → controlador → servicio → modelo).
- Integraciones externas identificadas.
Instrucción final:
Entrega un rastreo que un ingeniero nuevo pueda seguir para implementar una corrección de errores con confianza.
Resultado esperado
Grafo de Llamadas: POST /tasks → routes/tasks.js:createTask → controllers/taskController.js:create → services/taskService.js:createTask → models/task.js:Task.create Anotaciones: - createTask (ruta): Valida el esquema del cuerpo; pasa al controlador - controller.create: Mapea DTO, maneja try/catch - service.createTask: Aplica reglas de negocio, elimina títulos duplicados - Task.create: Persiste, devuelve id Pruebas Faltantes: Rechazo de título duplicado; payload inválido 400. Próximos Archivos: middleware/validateBody.js, services/notifications.js
Proceso de implementación
Construye el rastreo con Codex
Abre Codex. Pega los fragmentos de ruta, controlador, servicio y modelo para la función elegida. Solicita un grafo de llamadas y un recorrido anotado usando este prompt. Espera un rastreo por capas con nombres de funciones y rutas.
12 minValida las llamadas en VS Code
Salta a cada función en VS Code y confirma parámetros, retornos y efectos secundarios. Añade o corrige pasos faltantes (colas, caché, llamadas HTTP).
10 minConvierte en una lista de verificación de pruebas
Transforma la lista de pruebas faltantes en nombres de pruebas en tu ejecutor de pruebas y crea marcadores de posición. Comparte el rastreo y la lista en la documentación de tu repositorio para guiar el próximo PR.
8 min
