Communitygithub.com

AngChow/requirement-drift-auditor

Claude Code Skill – Prüft Git-Diffs anhand der ursprünglichen Anforderungen, erkennt abweichende Änderungen und generiert lokale Markdown/HTML-Auditberichte. Ein Hilfswerkzeug für manuelle Überprüfungen vor dem Teststart.

Was ist requirement-drift-auditor?

Diese Skill für Claude Code dient als automatisierter Prüfer für Abweichungen von Anforderungen in Git-Diffs. Sie vergleicht alle Änderungen im Arbeitsverzeichnis mit einer vorab definierten Liste von Anforderungen (z. B. aus einer Markdown-Datei) und kennzeichnet Änderungen, die nicht den spezifizierten Anforderungen entsprechen – sogenannte „Anforderungsdrift“. Die Skill unterstützt Entwicklerteams, die mit Git und Claude Code arbeiten, und ist besonders hilfreich für manuelle Code-Reviews oder vor dem Teststart. Das Tool extrahiert Anforderungen aus einer Quelldatei (z. B. `REQUIREMENTS.md`), analysiert den aktuellen Git-Diff (einschließlich ungestagter, gestagter und neuer Änderungen), und erstellt einen Bericht, der die Übereinstimmung der Änderungen mit den Anforderungen bewertet. Der generierte Bericht wird sowohl im Markdown- als auch im HTML-Format in einem lokalen Ordner (`audit-report`) gespeichert. Dadurch erhalten Entwickler eine klare, visuelle Aufstellung über potenzielle Abweichungen und können vor dem Commit oder Teststart Korrekturen vornehmen. Die Skill ist plattformunabhängig (Linux, macOS, Windows mit Git Bash) und erfordert lediglich eine gültige Git-Installation sowie Claude Code.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add AngChow/requirement-drift-auditor

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht requirement-drift-auditor?

Claude Code Skill – Prüft Git-Diffs anhand der ursprünglichen Anforderungen, erkennt abweichende Änderungen und generiert lokale Markdown/HTML-Auditberichte. Ein Hilfswerkzeug für manuelle Überprüfungen vor dem Teststart.

Funktionsweise

Diese Skill erstellt aus den aktuellen Git-Diffs (vor dem Commit) einen detaillierten Abgleichsbericht zwischen den festgelegten Anforderungen und den tatsächlich vorgenommenen Änderungen.

Eingabe

  • Anforderungsdatei: Eine Datei mit Anforderungsbeschreibungen (z. B. REQUIREMENTS.md)
  • Git-Diff: Differenzen im Arbeitsverzeichnis (ungestagte, gestagte und nicht versionierte Dateien)

Ausgabe

  • Lokale Berichte: audit-report/requirement-audit.md und audit-report/requirement-audit.html
  • Bericht enthält:
    • Projekt-ID und Audit-Zeitstempel
    • Liste der nicht versionierten Dateien
    • Bewertung der Übereinstimmung jeder Änderung mit den Anforderungen (✔ oder ✘)
    • Gesamtbilanz: Anzahl der abweichenden/genehmigten Änderungen
    • Empfehlungsleiste (z. B. „Abweichungen korrigieren vor dem Commit“)

Voraussetzungen

  • Git (Version >= 2.x)
  • Claude Code (installiert und eingerichtet)
  • Ein Projekt mit einer Anforderungsdatei (z. B. REQUIREMENTS.md)

Installation

  1. Füge diese Skill zu deinem Claude-Code-Arbeitsbereich hinzu (z. B. durch Einbinden als Git-Submodul oder einfaches Klonen).
  2. Stelle sicher, dass die Anforderungsdatei im Projektstamm vorhanden ist.
  3. Führe den Befehl claude drift-audit aus (oder rufe die Skill über Claude Code auf).

Beispiel

# Skill ausführen
claude drift-audit

Bekannte Einschränkungen

  • Berücksichtigt nur Textdiffs; binäre Dateien werden ignoriert.
  • Anforderungen müssen in der Datei strukturiert sein (z. B. als nummerierte Liste oder Abschnitte).
  • Berichte werden lokal gespeichert; kein externer Server.

Lizenz

MIT

Verwandte Skills