Umfassender Repository-Bug-Analyse- und Fix-Workflow

{ "task": "umfassende_repository_analyse", "objective": "Durchführung einer erschöpfenden Analyse des gesamten Codebestands, um alle verifizierbaren Fehler, Sicherheitslücken und kritischen Probleme über jeden Technologie-Stack hinweg zu identifizieren, zu priorisieren, zu beheben und zu dokumentieren", "analysis_phases": [ { "phase": 1, "name": "Repository-Erkennung & -Kartierung", "steps": [ { "step": "1.1", "title": "Architektur- & Strukturanalyse", "actions": [ "Vollständige Verzeichnisstruktur kartieren (src/, lib/, tests/, docs/, config/, scripts/, build/, deploy/)", "Alle verwendeten Technologie-Stacks und Frameworks identifizieren", "Abhängigkeitsmanifeste parsen (package.json, requirements.txt, go.mod, pom.xml, Gemfile, Cargo.toml, composer.json)", "Einstiegspunkte, Hauptausführungspfade und Modulgrenzen dokumentieren", "Build-Systeme analysieren (Webpack, Gradle, Maven, Make, CMake)", "CI/CD-Konfigurationen überprüfen (GitHub Actions, GitLab CI, Jenkins, CircleCI)", "Vorhandene Dokumentation prüfen (README, CONTRIBUTING, API-Spezifikationen, Architekturdiagramme)" ] }, { "step": "1.2", "title": "Entwicklungsumgebungs-Inventar", "actions": [ "Test-Frameworks identifizieren (Jest, Mocha, pytest, PHPUnit, Go test, JUnit, RSpec, xUnit)", "Linter/Formatter-Konfigurationen überprüfen (ESLint, Prettier, Black, Flake8, RuboCop, golangci-lint, Checkstyle)", "Nach Inline-Issue-Markern suchen (TODO, FIXME, HACK, XXX, BUG, NOTE)", "Git-Verlauf auf problematische Muster und aktuelle Hotfixes analysieren", "Vorhandene Testabdeckungsberichte und -metriken extrahieren", "Bereits verwendete Code-Analyse-Tools identifizieren (SonarQube, CodeClimate, etc.)" ] } ] }, { "phase": 2, "name": "Systematische Fehlererkennung", "bug_categories": [ { "category": "KRITISCH", "severity": "P0", "types": [ "SQL-Injection-Schwachstellen", "Cross-Site-Scripting (XSS)-Fehler", "Cross-Site-Request-Forgery (CSRF)-Schwachstellen", "Authentifizierungs-/Autorisierungs-Bypass", "Remote-Code-Execution (RCE)-Risiken", "Datenkorruption oder dauerhafter Datenverlust", "Systemabstürze, Deadlocks oder Endlosschleifen", "Speicherlecks und Ressourcenerschöpfung", "Unsichere kryptografische Implementierungen", "Hartcodierte Geheimnisse oder Anmeldeinformationen" ] }, { "category": "FUNKTIONAL", "severity": "P1-P2", "types": [ "Logikfehler (falsche Bedingungen, falsche Berechnungen, Off-by-One-Fehler)", "Zustandsverwaltungsprobleme (Race Conditions, veralteter Zustand, unsachgemäße Mutationen)", "Falsche API-Verträge oder Anfrage-/Antwort-Zuordnungen", "Fehlende oder unzureichende Eingabevalidierung", "Unterbrochene Geschäftslogik oder Workflow-Verstöße", "Falsche Datentransformationen oder Serialisierung", "Typkonflikte oder unsichere Typumwandlungen", "Falsche Ausnahmebehandlung oder Fehlerweitergabe" ] }, { "category": "INTEGRATION", "severity": "P2", "types": [ "Falsche Nutzung externer APIs oder veraltete Endpunkte", "Datenbankabfragefehler, SQL-Syntaxprobleme oder N+1-Probleme", "Fehler bei der Verarbeitung von Nachrichtenwarteschlangen (RabbitMQ, Kafka, SQS)", "Dateisystem-Operationsfehler (Berechtigungen, Pfad-Traversal)", "Netzwerkkommunikationsprobleme (Timeouts, Wiederholungen, Verbindungspooling)", "Cache-Inkonsistenz oder Invalidierungsprobleme", "Fehlgebrauch von Drittanbieter-Bibliotheken oder Versionsinkompatibilitäten" ] }, { "category": "GRENZFÄLLE", "severity": "P2-P3", "types": [ "Null-/Undefined-/Nil-/None-Pointer-Dereferenzierungen", "Behandlung leerer Arrays/Listen/Sammlungen", "Grenzfälle mit Null oder negativen Werten", "Randbedingungen (max/min Ganzzahlen, String-Längenlimits)", "Fehlende Fehlerbehandlung oder verschluckte Ausnahmen", "Fehler bei Timeout- und Wiederholungslogik", "Gleichzeitige Zugriffsprobleme ohne ordnungsgemäße Sperrung", "Überlauf/Unterlauf bei numerischen Operationen" ] }, { "category": "CODEQUALITÄT", "severity": "P3-P4", "types": [ "Nutzung veralteter APIs", "Toter Code oder unerreichbare Codepfade", "Zirkuläre Abhängigkeiten", "Leistungsengpässe (ineffiziente Algorithmen, redundante Operationen)", "Fehlende oder falsche Typannotationen", "Inkonsistente Fehlerbehandlungsmuster", "Ressourcenlecks (Dateihandles, Datenbankverbindungen, Netzwerk-Sockets)", "Unsachgemäßes Logging (Offenlegung sensibler Daten, unzureichender Kontext)" ] } ], "discovery_methods": [ "Statische Code-Analyse mit sprachspezifischen Tools", "Mustererkennung für häufige Anti-Patterns und Code-Smells", "Schwachstellenscan von Abhängigkeiten (npm audit, pip-audit, bundle-audit, cargo audit)", "Kontrollfluss- und Datenflussanalyse", "Erkennung von totem Code", "Konfigurationsvalidierung gegen Best Practices", "Dokumentations-zu-Implementierungs-Querverifizierung", "Sicherheitsfokussierte Code-Überprüfung" ] }, { "phase": 3, "name": "Fehlerdokumentation & Priorisierung", "bug_report_schema": { "bug_id": "Sequenzieller Identifikator (BUG-001, BUG-002, etc.)", "severity": { "type": "enum", "values": [ "KRITISCH", "HOCH", "MITTEL", "NIEDRIG" ], "description": "Schweregrad des Fehlers" }, "category": { "type": "enum", "values": [ "SICHERHEIT", "FUNKTIONAL", "LEISTUNG", "INTEGRATION", "CODEQUALITÄT" ], "description": "Fehlerklassifizierung" }, "location": { "files": [ "Array betroffener Dateipfade mit Zeilennummern" ], "component": "Modul-/Service-/Funktionsname", "function": "Spezifischer Funktions- oder Methodenname" }, "description": { "current_behavior": "Was ist defekt oder falsch", "expected_behavior": "Was stattdessen passieren sollte", "root_cause": "Technische Erklärung, warum es defekt ist" }, "impact_assessment": { "user_impact": "Auswirkung auf Endbenutzer (Datenverlust, Sicherheitsgefährdung, UX-Verschlechterung)", "system_impact": "Auswirkung auf das System (Leistung, Stabilität, Skalierbarkeit)", "business_impact": "Auswirkung auf das Geschäft (Compliance, Umsatz, Reputation, rechtliche Aspekte)" }, "reproduction": { "steps": [ "Schritt-für-Schritt-Anleitung zur Reproduktion" ], "test_data": "Beispieldaten oder benötigte Bedingungen", "actual_result": "Was passiert, wenn reproduziert", "expected_result": "Was passieren sollte" }, "verification": { "code_snippet": "Demonstrativer Code, der den Fehler zeigt", "test_case": "Test, der aufgrund dieses Fehlers fehlschlagen würde", "logs_or_metrics": "Nachweise aus Logs oder Monitoring" }, "dependencies": { "related_bugs": [ "Array verwandter BUG-IDs" ], "blocking_issues": [ "Array von Fehlern, die zuerst behoben werden müssen" ], "blocked_by": [ "Externe Faktoren, die die Behebung verhindern" ] }, "metadata": { "discovered_date": "ISO-8601-Zeitstempel", "discovered_by": "Verwendetes Tool oder Methode", "cve_id": "Falls zutreffend, CVE-Identifikator", "cwe_id": "Falls zutreffend, CWE-Identifikator" } }, "prioritization_matrix": { "criteria": [ { "factor": "Schweregrad", "weight": 0.4, "scale": "KRITISCH=100, HOCH=70, MITTEL=40, NIEDRIG=10" }, { "factor": "Benutzerauswirkung", "weight": 0.3, "scale": "Alle Benutzer=100, Viele=70, Einige=40, Wenige=10" }, { "factor": "Behebungskomplexität", "weight": 0.15, "scale": "Einfach=100, Mittel=60, Komplex=20" }, { "factor": "Regressionsrisiko", "weight": 0.15, "scale": "Niedrig=100, Mittel=60, Hoch=20" } ], "formula": "prioritäts_score = Σ(faktor_wert × gewicht)" } }, { "phase": 4, "name": "Implementierung der Behebungen", "fix_workflow": [ { "step": 1, "action": "Isolierten Fix-Zweig erstellen", "naming": "fix/BUG-{id}-{kurzbeschreibung}" }, { "step": 2, "action": "Zuerst fehlschlagenden Test schreiben", "rationale": "Testgetriebene Entwicklung stellt sicher, dass die Behebung verifizierbar ist" }, { "step": 3, "action": "Minimale, fokussierte Behebung implementieren", "principle": "Kleinste Änderung, die das Problem korrekt löst" }, { "step": 4, "action": "Verifizieren, dass der Test jetzt besteht", "validation": "Spezifischen Test und zugehörige Testsuite ausführen" }, { "step": 5, "action": "Vollständige Regressionstestsuite ausführen", "validation": "Sicherstellen, dass keine vorhandene Funktionalität bricht" }, { "step": 6, "action": "Dokumentation aktualisieren", "scope": "API-Dokumentation, Inline-Kommentare, Changelog" } ], "fix_principles": [ "MINIMALE_ÄNDERUNG: Die kleinste Änderung vornehmen, die das Problem korrekt behebt", "KEINE_BEREICHSERWEITERUNG: Unabhängiges Refactoring oder Feature-Erweiterungen vermeiden", "RÜCKWÄRTSKOMPATIBEL: Bestehende API-Verträge beibehalten, es sei denn, der Fehler selbst ist brechend", "KONVENTIONEN_BEFOLGEN: Vorhandenen Codestil und Muster des Projekts einhalten", "DEFENSIVE_PROGRAMMIERUNG: Schutzmaßnahmen hinzufügen, um ähnliche Fehler in der Zukunft zu verhindern", "EXPLIZIT_VOR_IMPLIZIT: Absicht durch Codestruktur und Kommentare klar machen", "SCHNELL_SCHEITERN: Eingaben früh validieren und mit klaren Fehlermeldungen scheitern" ], "code_review_checklist": [ "Behebung adressiert die Grundursache, nicht nur Symptome", "Alle Randfälle sind ordnungsgemäß behandelt", "Fehlermeldungen sind klar, umsetzbar und geben keine sensiblen Informationen preis", "Leistungsauswirkung ist akzeptabel (kein O(n²), wenn O(n) ausreicht)", "Sicherheitsimplikationen gründlich berücksichtigt", "Keine neuen Compiler-Warnungen oder Lint-Fehler", "Änderungen sind durch Tests abgedeckt", "Dokumentation ist aktualisiert und genau", "Brechende Änderungen sind klar markiert und gerechtfertigt", "Abhängigkeiten sind aktuell und sicher" ] }, { "phase": 5, "name": "Testen & Validierung", "test_requirements": { "mandatory_tests_per_fix": [ { "type": "Unit-Test", "description": "Isolierter Test für die spezifische Fehlerbehebung", "coverage": "Muss den genauen Codepfad abdecken, der defekt war" }, { "type": "Integrationstest", "description": "Test, ob der Fehler mehrere Komponenten betrifft", "coverage": "End-to-End-Fluss durch betroffene Systeme" }, { "type": "Regressionstest", "description": "Sicherstellen, dass die Behebung vorhandene Funktionalität nicht bricht", "coverage": "Alle verwandten Funktionen und Codepfade" }, { "type": "Randfalltests", "description": "Grenzbedingungen und Eckfälle abdecken", "coverage": "Nullwerte, leere Eingaben, Grenzen, Fehlerbedingungen" } ] }, "test_structure_template": { "description": "Sprachunabhängige Teststruktur", "template": [ "describe('BUG-{ID}: {beschreibung}', () => {", " test('reproduziert ursprünglichen Fehler', () => {", " // Dieser Test demonstriert, dass der Fehler existierte", " // Sollte vor der Behebung fehlschlagen, nach der Behebung bestehen", " });", "", " test('verifiziert, dass die Behebung das Problem löst', () => {", " // Dieser Test beweist korrektes Verhalten nach der Behebung", " });", "", " test('behandelt Randfall: {fall}', () => {", " // Zusätzliche Abdeckung für verwandte Szenarien", " });", "});" ] }, "validation_steps": [ { "step": "Vollständige Testsuite ausführen", "commands": { "javascript": "npm test", "python": "pytest", "go": "go test ./...", "java": "mvn test", "ruby": "bundle exec rspec", "rust": "cargo test", "php": "phpunit" } }, { "step": "Codeabdeckung messen", "tools": [ "Istanbul/NYC", "Coverage.py", "JaCoCo", "SimpleCov", "Tarpaulin" ] }, { "step": "Statische Analyse ausführen", "tools": [ "ESLint", "Pylint", "golangci-lint", "SpotBugs", "Clippy" ] }, { "step": "Leistungsbenchmarking", "condition": "Wenn die Behebung heiße Pfade oder kritische Operationen betrifft" }, { "step": "Sicherheitsscan", "tools": [ "Snyk", "OWASP Dependency-Check", "Trivy", "Bandit" ] } ] }, { "phase": 6, "name": "Dokumentation & Berichterstattung", "fix_documentation_requirements": [ "Inline-Code-Kommentare aktualisieren, die die Behebung und deren Notwendigkeit erklären", "API-Dokumentation überarbeiten, wenn sich das Verhalten geändert hat", "CHANGELOG.md mit Fehlerbehebungseintrag aktualisieren", "Fehlerbehebungsleitfäden erstellen oder aktualisieren", "Workarounds für aufgeschobene/unbehobene Probleme dokumentieren", "Migrationshinweise hinzufügen, wenn die Behebung Benutzeraktionen erfordert" ], "executive_summary_template": { "title": "Fehlerbehebungsbericht - {repository_name}", "metadata": { "date": "ISO-8601-Datum", "analyzer": "Tool/Personenname", "repository": "Vollständiger Repository-Pfad", "commit_hash": "Git-Commit-SHA", "duration": "Analysedauer in Stunden" }, "overview": { "total_bugs_found": "Ganzzahl", "total_bugs_fixed": "Ganzzahl", "bugs_deferred": "Ganzzahl", "test_coverage_before": "Prozentsatz", "test_coverage_after": "Prozentsatz", "files_analyzed": "Ganzzahl", "lines_of_code": "Ganzzahl" }, "critical_findings": [ "Top 3-5 kritischste gefundene Fehler und deren Behebungen" ], "fix_summary_by_category": { "security": "Anzahl", "functional": "Anzahl", "performance": "Anzahl", "integration": "Anzahl", "code_quality": "Anzahl" }, "detailed_fix_table": { "columns": [ "BUG-ID", "Datei", "Zeile", "Kategorie", "Schweregrad", "Beschreibung", "Status", "Test hinzugefügt" ], "format": "Markdown-Tabelle oder CSV" }, "risk_assessment": { "remaining_high_priority": [ "Liste unbehobener kritischer Probleme" ], "recommended_next_steps": [ "Priorisierte Aktionspunkte" ], "technical_debt": [ "Zusammenfassung identifizierter technischer Schulden" ], "breaking_changes": [ "Alle rückwärtsinkompatiblen Behebungen" ] }, "testing_results": { "test_command": "Exakter Befehl zum Ausführen der Tests", "tests_passed": "X von Y", "tests_failed": "Anzahl mit Gründen", "tests_added": "Anzahl", "coverage_delta": "+X% oder -X%" } }, "deliverables_checklist": [ "Alle Fehler im standardisierten Format dokumentiert", "Behebungen mit minimalem Umfang implementiert", "Testsuite aktualisiert und bestehend", "Dokumentation aktualisiert (Code, API, Benutzerhandbücher)", "Code-Überprüfung abgeschlossen und genehmigt", "Leistungsauswirkung bewertet und akzeptabel", "Sicherheitsüberprüfung für sicherheitsrelevante Behebungen durchgeführt", "Bereitstellungshinweise und Rollback-Plan vorbereitet", "Changelog mit benutzersichtbaren Änderungen aktualisiert", "Stakeholder über kritische Behebungen informiert" ] }, { "phase": 7, "name": "Kontinuierliche Verbesserung", "pattern_analysis": { "objectives": [ "Wiederkehrende Fehlermuster im gesamten Codebestand identifizieren", "Architektonische Probleme erkennen, die Fehler ermöglichen", "Lücken in der Teststrategie finden", "Bereiche mit technischen Schulden hervorheben" ], "outputs": [ "Bericht über häufige Fehlermuster", "Empfehlungen für vorbeugende Maßnahmen", "Vorschläge zur Tool-Verbesserung", "Vorschläge für architektonisches Refactoring" ] }, "monitoring_recommendations": { "metrics_to_track": [ "Fehlererkennungsrate im Zeitverlauf", "Zeit bis zur Lösung nach Schweregrad", "Regressionsrate (wieder eingeführte Fehler)", "Prozentsatz der Testabdeckung", "Code-Churn in fehleranfälligen Bereichen", "Anzahl der Abhängigkeitsschwachstellen" ], "alerting_rules": [ "Kritische Sicherheitsschwachstellen in Abhängigkeiten", "Fehlschläge der Testsuite", "Codeabdeckung fällt unter Schwellenwert", "Leistungsverschlechterung bei Schlüsseloperationen" ], "logging_improvements": [ "Strukturiertes Logging hinzufügen, wo es fehlt", "Korrelations-IDs für Anfrageverfolgung einbeziehen", "Sicherheitsrelevante Ereignisse protokollieren", "Sicherstellen, dass Fehlerprotokolle Stack-Traces und Kontext enthalten" ] } } ], "constraints_and_best_practices": [ "NIEMALS Sicherheit für Einfachheit oder Bequemlichkeit kompromittieren", "VOLLSTÄNDIGES Prüfprotokoll aller Änderungen beibehalten", "SEMANTISCHE VERSIONIERUNG befolgen, wenn Behebungen die öffentliche API ändern", "RATENLIMITS beim Testen externer Dienste respektieren", "FEATURE-FLAGS für risikoreiche oder schrittweise Einführungen von Behebungen verwenden", "ALLE Annahmen dokumentieren, die während der Analyse getroffen werden", "ROLLBACK-Strategie für jede Behebung in Betracht ziehen", "RÜCKWÄRTSKOMPATIBLE Behebungen bevorzugen, wenn möglich", "VERMEIDEN, neue Abhängigkeiten ohne Rechtfertigung einzuführen", "IN MEHREREN UMGEBUNGEN testen, wenn zutreffend" ], "output_formats": [ { "format": "markdown", "purpose": "Menschlich lesbare Dokumentation und Berichte", "filename_pattern": "bug_report_{datum}.md" }, { "format": "json", "purpose": "Maschinenlesbar für automatisierte Verarbeitung", "filename_pattern": "bug_data_{datum}.json", "schema": "Dem in Phase 3 definierten bug_report_schema folgen" }, { "format": "csv", "purpose": "Import in Fehlerverfolgungssysteme (Jira, GitHub Issues)", "filename_pattern": "bugs_{datum}.csv", "columns": [ "BUG-ID", "Schweregrad", "Kategorie", "Datei", "Zeile", "Beschreibung", "Status" ] }, { "format": "yaml", "purpose": "Konfigurationsfreundliches Format für CI/CD-Integration", "filename_pattern": "bug_config_{datum}.yaml" } ], "special_considerations": { "monorepos": "Jedes Paket/Workspace separat analysieren mit paketübergreifender Abhängigkeitsverfolgung", "microservices": "Inter-Service-Verträge, API-Kompatibilität und verteilte Ablaufverfolgung berücksichtigen", "legacy_code": "Behebungsrisiko vs. Nutzen abwägen; hochwirksame, risikoarme Behebungen priorisieren", "third_party_dependencies": "Schwachstellen upstream melden; Alternativen in Betracht ziehen, wenn nicht gewartet", "high_traffic_systems": "Bereitstellungsstrategien (Blue-Green, Canary) für Behebungen in Betracht ziehen", "regulated_industries": "Compliance-Anforderungen sicherstellen (HIPAA, PCI-DSS, SOC2, GDPR)", "open_source_projects": "Beitragsrichtlinien befolgen; vor großen Änderungen mit Maintainern in Kontakt treten" }, "success_criteria": { "quantitative": [ "Alle KRITISCHEN und HOHEN Schweregradfehler behoben", "Testabdeckung um mindestens X% erhöht", "Null Sicherheitsschwachstellen in Abhängigkeiten", "Alle Tests bestehen", "Codequalitätsmetriken verbessert (zyklomatische Komplexität, Wartbarkeitsindex)" ], "qualitative": [ "Codebestand ist wartbarer", "Dokumentation ist klar und umfassend", "Team kann Behebungen sicher bereitstellen", "Mechanismen zur zukünftigen Fehlerverhinderung vorhanden", "Entwicklungsgeschwindigkeit verbessert" ] } }

Umfassender Repository-Bug-Analyse- und Fix-Workflow

Prompt-InhaltSpeichern

Melde dich an, um den vollständigen Prompt zu sehen

Verwendung

Referenzen

Diskussion