KI-Workflow für automatisierte GitHub Code Review E-Mails - n8n-Workflow

Markdown-formatted text:
Softwareentwicklungsteams, die sofortiges Feedback zu neuen Commits benötigen.
DevOps-Ingenieure, die automatisierte Qualitätstore mittels n8n in ihre CI/CD-Pipelines integrieren möchten.
n8n-Nutzer, die ein fortgeschrittenes Beispiel für die Kombination von Webhooks, Custom Code und großen Sprachmodellen (LLMs) suchen.
Technische Leiter, die die Code-Qualität über mehrere Repositories hinweg mit einem einzigen n8n-Workflow überwachen möchten.

Manuelle Code-Reviews sind oft zeitaufwendig und fehleranfällig. Dieser n8n-Workflow löst dieses Problem durch die Einrichtung einer KI-gesteuerten Echtzeit-Feedbackschleife zur Code-Qualität. Sobald ein Entwickler Code in ein überwachtes GitHub-Repository pusht, aktiviert der n8n-Trigger die Automatisierung sofort. Der Workflow ruft die vollständigen Commit-Details ab und übergibt den formatierten Code-Diff zur Analyse an einen intelligenten KI-Agenten, der Groq nutzt. Der Agent analysiert funktionale Probleme, Stil, potenzielle Sicherheitslücken und schlägt Verbesserungen vor, wobei er eine strukturierte HTML-Zusammenfassung zurückgibt. Dieser gesamte Prozess, gesteuert durch verschiedene n8n-Nodes, gewährleistet schnelles, konsistentes Code-Feedback, das direkt über Gmail in den Posteingang des Reviewers gelangt, was dies zu einer der nützlichsten n8n-Vorlagen für moderne Teams macht.

Dieser leistungsstarke n8n-Workflow startet seine Ausführung mit dem Github Trigger n8n-Node. Dieser n8n-Trigger ist so konfiguriert, dass er auf 'push'-Events in einem spezifischen Repository lauscht.

1. Trigger & Daten-Parsing: Bei einem Push erfasst der Github Trigger die Payload. Der nachfolgende Parser n8n-Node extrahiert wesentliche Metadaten (Repo-Name, Owner, Commit-ID).


2. Abrufen der Commit-Details: Ein HTTP Request n8n-Node verwendet anschließend die Commit-ID, um die GitHub API aufzurufen und die detaillierten Commit-Informationen, einschließlich der wichtigen Patch-/Diff-Daten, abzurufen.


3. HTML-Formatierung (Code Node): Ein spezialisierter Code n8n-Node nimmt die Rohdaten des Commits und wandelt sie in eine aufwendig gestaltete HTML-Ausgabe um. Dies beinhaltet die farbliche Kennzeichnung der Code-Diffs (Grün für Hinzufügungen, Rot für Löschungen) für optimale Lesbarkeit in einem E-Mail-Client.


4. KI-Analyse (AI Agent Node): Der AI Agent n8n-Node empfängt dieses formatierte HTML. Er wird durch einen strikten System-Prompt angewiesen, als erfahrener Code-Reviewer zu agieren, wobei der Fokus auf funktionalen Aspekten, Stil und Sicherheitsbedenken liegt. Er nutzt das Groq Chat Model und optional einen Simple Memory n8n-Node zur Verarbeitung (der Speicher ist bei einer einmaligen Überprüfung optional).


5. Ausgabe-Kombination: Ein Output Parser Code n8n-Node fasst die ursprünglichen Commit-Details (vom ersten Code-Node) und die vom KI-Agenten erstellte strikte HTML-Zusammenfassung zusammen.


6. Abschließende Benachrichtigung: Die fertige HTML-Ausgabe wird über den Gmail n8n-Node an den angegebenen Empfänger (den Reviewer oder das Entwicklungsteam) gesendet, wodurch der automatisierte n8n-Workflow abgeschlossen wird. Der Flow endet anschließend mit dem End Workflow n8n-Node.

Markdown-formatted text:

1. Importieren der n8n-Vorlage: Kopieren Sie die bereitgestellte JSON und fügen Sie sie in Ihre n8n-Instanz über das Menü 'Neu' -> 'Import aus JSON' ein.


2. GitHub-Anmeldedaten: Richten Sie die Anmeldeinformationen für den GitHub Trigger n8n-Node und den HTTP Request n8n-Node ein.


3. Groq-Einrichtung: Konfigurieren Sie den Groq Chat Model n8n-Node mit Ihrem Groq API-Schlüssel.


4. Konfiguration des Github Triggers: Passen Sie die Repository-URL und die Besitzerdetails im Github Trigger n8n-Node an, um Ihr Zielprojekt zu überwachen. Stellen Sie sicher, dass der Webhook in Ihren GitHub Repository-Einstellungen korrekt eingerichtet ist, um auf die n8n Trigger-URL zu verweisen.


5. Gmail-Einrichtung: Konfigurieren Sie den Gmail n8n-Node mit Ihren OAuth2-Anmeldedaten. Aktualisieren Sie den Parameter sendTo auf die gewünschte E-Mail-Adresse des Reviewers.


6. Aktivieren: Speichern und aktivieren Sie den n8n-Workflow. Er wird nun automatisch bei jedem Push-Event ausgeführt.

Markdown-formatted text:
Github Trigger (n8n Trigger):
Funktion: Startet den n8n-Workflow bei einem 'push'-Event an ein spezifisches GitHub-Repository.
Wesentliche Konfiguration: Events auf push eingestellt. Die Repository-Details müssen manuell an Ihr Projekt angepasst werden.
HTTP Request (n8n-Node):
Funktion: Ruft detaillierte Commit-Metadaten ab, einschließlich Dateipatches, unter Verwendung dynamischer Ausdrücke, die auf die vom n8n Trigger bereitgestellte Commit-ID verweisen.
Wesentliche Konfiguration: Verwendet den GitHub OAuth2-Credential-Typ für sicheren API-Zugriff. Die URL wird dynamisch generiert, um Commit-Daten anzufordern: =https://api.github.com/repos/{{ $json.body.repository.owner.name }}/.../commits/{{ $json.body.head_commit.id }}.
Code (Formatter n8n-Node):
Funktion: Wandelt rohe GitHub Commit-Daten (Diffs) in farblich gekennzeichnetes, gestyltes HTML für eine hervorragende E-Mail-Visualisierung um. Es trennt hinzugefügte Zeilen (+, grün) und gelöschte Zeilen (-, rot).
Wesentliche Konfiguration: Enthält benutzerdefinierte JavaScript-Logik (formatPatch und renderResponse) zur Strukturierung von Metadaten (Repo-Infos, Autor, Nachricht) und Code-Diffs.
Groq Chat Model (n8n-Node):
Funktion: Stellt das LLM-Backend für den KI-Agenten bereit und nutzt das schnelle Modell llama-3.1-8b-instant für die schnelle Generierung der Code-Reviews.
Wesentliche Konfiguration: Erfordert ein Groq API-Credential.
AI Agent (n8n-Node):
Funktion: Dient als Kernintelligenz. Es nimmt den HTML-formatierten Code-Diff als Eingabe und generiert ein strikt strukturiertes Code-Review basierend auf den detaillierten Prompt-Anweisungen.
Wesentliche Konfiguration: Der System-Prompt zwingt die KI dazu, Funktionalität, Stil und Sicherheit zu prüfen, Verbesserungen vorzuschlagen und ihre Ergebnisse entscheidend in einem von zwei vordefinierten HTML-Blöcken zurückzugeben.
Gmail (n8n-Node):
Funktion: Versendet die finale, kombinierte HTML-Ausgabe (Commit-Details + KI-Review) als E-Mail-Benachrichtigung.
Wesentliche Konfiguration: Der Betreff ist auf 'Code Review' gesetzt. Die Nachricht verwendet die finale HTML-Ausgabe des Output Parser n8n-Nodes.