VorobiovD/air

Was macht air?

KI-Review — automatisierte Code-Review mit Verifikation, Mustererkennung und Teamwissen

Übersicht

VorobiovD/air automatisiert Code-Reviews durch KI, die nicht nur statische Analysen durchführt, sondern auch Tests ausführt und das Verhalten des Codes zur Laufzeit prüft. Es lernt aus historischen Reviews und teamweiten Konventionen, um relevante, kontextangepasste Kommentare zu liefern.

Hauptfunktionen

• Automatische Verifikation: Führt für geänderte Codeabschnitte bereitgestellte Tests aus und meldet Fehler.
• Mustererkennung: Analysiert wiederkehrende Code-Muster und schlägt Optimierungen vor.
• Team-Wissen: Berücksichtigt interne Coding-Standards, Namenskonventionen und Architekturrichtlinien.
• Plattformunterstützung: Integriert sich in GitHub, GitLab sowie CLI-Tools.

So funktioniert es

1. Ein Entwickler erstellt einen Pull Request (PR).
2. air analysiert die Änderungen (Diff) und identifiziert relevante Testpfade.
3. Automatisierte Ausführung von Tests für die betroffenen Module.
4. KI-generierte Kommentare mit Bewertung und Verbesserungsvorschlägen.
5. Optional: Automatische Übernahme von Korrekturen per Approved-Review.

Voraussetzungen

• Python 3.10+
• Installierte Abhängigkeiten aus requirements.txt
• Zugriff auf die Code-Repository-Plattform (z. B. GitHub Token)

Installation

git clone https://github.com/VorobiovD/air.git
cd air
pip install -r requirements.txt

Konfiguration

Erstelle eine Datei air_config.yaml mit folgendem Inhalt:

repository:
  platform: github
  owner: team-name
  name: project
review:
  auto_verify: true
  learn_from_history: true
  team_rules:
    - max_line_length: 120
    - naming_convention: snake_case

Verwendung

CLI

air review --pr 42

GitHub Action (Beispiel)

name: AI Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run AI Review
        run: air review --pr ${{ github.event.pull_request.number }}

Lizenz

MIT

Mitwirken

Beiträge sind willkommen! Bitte lies die CONTRIBUTING.md.