Feature Trace Navigator (Benutzeraktion → Aufrufgraph → Code-Durchgang)
Verfolge eine einzelne Funktion vom UI- oder API-Einstieg über Controller, Services und Datenschichten, um einen Aufrufgraphen und eine kommentierte Schritt-für-Schritt-Anleitung zu erstellen.
Prompt-Übersicht
Tipps für dich
- Stellen Sie Logs oder Testnamen bereit, um reale Ausführungspfade genau zu identifizieren. - Fügen Sie Fehlerbehandlungscode hinzu, um alternative Abläufe abzudecken. - Ergänzen Sie eine kurze Beispiel-Nutzlast, die in der Produktion verwendet wird.
Vom Operations-TeamNexusAi TechnologyProblem, das es löst
Den vollständigen Pfad einer Funktion über verschiedene Schichten zu finden, ist fehleranfällig. Dieses Tool erzeugt einen verlässlichen Aufrufgraphen und zeigt auf, wo als Nächstes genauer untersucht werden sollte.
End-to-End-Pfadklarheit
Zeigt genau, wie Daten durch die Schichten fließen.
Handlungsorientierte Kommentare
Jeder Schritt enthält Zweck, Ein-/Ausgaben und Seiteneffekte.
Testlückenfinder
Hebt fehlende oder schwache Tests entlang des Pfads hervor.
Anleitung für nächste Datei
Zeigt an, was als Nächstes gelesen werden sollte und warum.
KI-Prompt-Anweisungen
Agieren Sie als erfahrener Full-Stack-Entwickler und Code-Kartograf.
Warum diese Aufgabe wichtig ist:
End-to-End-Traces zeigen, wie Daten fließen, wo Seiteneffekte auftreten und welche Komponenten für Wartung und Tests entscheidend sind.
Wichtige Grenzen:
- Arbeiten Sie nur mit den bereitgestellten Routen-, Controller-, Service- und Modell-Snippets.
- Wenn mehrere Varianten existieren, priorisieren Sie den Produktionspfad.
Benutzereingaben:
- Funktionsbeschreibung (z. B. „Aufgabe erstellen“ via POST /tasks).
- Relevante Dateien: Routen-Handler, Controller, Services, Modelle, Middleware.
- Alle Logs oder Testnamen, die diesen Pfad abdecken.
Ziele:
1) Erstellen Sie einen klaren Aufrufgraphen vom Einstieg bis zur Persistenz.
2) Kommentieren Sie wichtige Funktionen mit Zweck, Eingaben/Ausgaben und Seiteneffekten.
3) Identifizieren Sie Risiken, fehlende Tests und Beobachtbarkeitslücken.
4) Empfehlen Sie die Reihenfolge der nächsten zu lesenden Dateien.
Analyseablauf:
1) Beginnen Sie bei der Route; finden Sie Controller- und Service-Aufrufe.
2) Verfolgen Sie Datenumwandlungen und Validierungen.
3) Notieren Sie externe Aufrufe (DB, Queue, HTTP) und Fehlerbehandlung.
4) Vergleichen Sie mit bestehenden Tests.
5) Fassen Sie Leistungs-, Zuverlässigkeits- und Lesbarkeitsprobleme zusammen.
Erforderliches Ausgabeformat:
- Textbasierter Aufrufgraph (eingerückte Liste) zum Kopieren/Einfügen.
- Kommentare pro Schritt: Zweck, Parameter, Ausgabe, Seiteneffekte.
- Fehlende Tests und vorgeschlagene Testfälle.
- Die nächsten 5 Dateien zur Überprüfung.
Qualitätskontrollen:
- Geben Sie genaue Funktionsnamen und Dateipfade an.
- Unterscheiden Sie zwischen gesicherten Aussagen und Vermutungen; markieren Sie Vermutungen deutlich.
Überprüfungscheckliste:
- Alle Schichten sind vertreten (Route → Controller → Service → Modell).
- Externe Integrationen sind identifiziert.
Abschließende Anweisung:
Liefern Sie einen Trace, dem ein neuer Entwickler folgen kann, um einen Bugfix sicher umzusetzen.
Erwartetes Ergebnis
Aufrufgraph: POST /tasks → routes/tasks.js:createTask → controllers/taskController.js:create → services/taskService.js:createTask → models/task.js:Task.create Kommentare: - createTask (Route): Validiert Body-Schema; leitet an Controller weiter - controller.create: Mappt DTO, behandelt try/catch - service.createTask: Erzwingt Geschäftsregeln, entfernt Duplikate im Titel - Task.create: Persistiert, gibt ID zurück Fehlende Tests: Ablehnung doppelter Titel; ungültige Nutzlast 400. Nächste Dateien: middleware/validateBody.js, services/notifications.js
Umsetzungsprozess
Erstellen Sie den Trace mit Codex
Öffnen Sie Codex. Fügen Sie die Snippets der Route, des Controllers, des Services und des Modells für die gewählte Funktion ein. Fordern Sie einen Aufrufgraphen und eine kommentierte Schritt-für-Schritt-Anleitung mit diesem Prompt an. Erwarten Sie einen mehrschichtigen Trace mit Funktionsnamen und Pfaden.
12 minValidieren Sie Aufrufe in VS Code
Springen Sie zu jeder Funktion in VS Code und prüfen Sie Parameter, Rückgaben und Seiteneffekte. Fügen Sie fehlende Schritte hinzu oder korrigieren Sie diese (Queues, Caching, HTTP-Aufrufe).
10 minWandeln Sie es in eine Test-Checkliste um
Verwandeln Sie die Liste fehlender Tests in Testnamen in Ihrem Test-Runner und erstellen Sie Platzhalter. Teilen Sie den Trace und die Checkliste in Ihren Repository-Dokumentationen, um den nächsten Pull Request zu unterstützen.
8 min