n-shadloo/git-authoring

Was macht git-authoring?

Agent-Fähigkeit, die Ihren Git-Diff in saubere Conventional Commits verwandelt – plus auf Anfrage Datei-Staging und vollständige Pull-Request-Entwürfe. Funktioniert mit Claude, Codex, Cursor und Gemini.

Beschreibung

Diese Fähigkeit automatisiert das Erstellen von Git-Commit-Nachrichten und Pull-Requests. Sie analysiert Ihren aktuellen git diff, klassifiziert die Änderungen und schlägt eine nach dem Conventional Commits Standard formatierte Commit-Nachricht vor. Sie können diese Nachricht dann übernehmen, bearbeiten oder den Commit komplett ablehnen.

Zusätzlich kann der Skill auf Anfrage:

• Dateien zum Staging hinzufügen (git add)
• Einen vollständigen Pull-Request-Entwurf mit Titel, Zusammenfassung und Beschreibung der Änderungen erstellen

Verwendung

1. Stellen Sie sicher, dass Sie sich in einem Git-Repository befinden – führen Sie diesen Befehl in Ihrem Terminal aus:

git status

2. Rufen Sie den Skill auf – verwenden Sie einen Prompt wie:

„Erstelle einen Conventional Commit aus meinem aktuellen Diff“

3. Optional: Staging und PR-Erstellung – fügen Sie hinzu:

„Stage alle Dateien und erstelle daraus einen Pull-Request“

Anforderungen

• Git muss installiert und im Pfad (PATH) verfügbar sein
• Sie müssen sich in einem Git-Repository mit mindestens einem initialen Commit befinden (git init und git commit --allow-empty -m "initial")
• Für die PR-Erstellung: gh (GitHub CLI) muss installiert und authentifiziert sein

Funktionsweise

1. Der Skill liest den aktuellen git diff (sowohl ungestagede als auch gestagede Änderungen)
2. Er klassifiziert die Änderungen anhand von Schlüsselwörtern und Dateitypen (z.B. feat: bei neuen Funktionen, fix: bei Fehlerbehebungen, chore: bei Aufgaben)
3. Er generiert eine Commit-Nachricht im Format type(scope): beschreibung
4. Auf Wunsch führt er git add und git commit -m "..." aus
5. Für PRs erstellt er einen Entwurf mit gh pr create --draft --title "..." --body "..."

Plattformen

• Claude
• Codex
• Cursor
• Gemini

Beispiel

Diff:

diff --git a/src/feature.js b/src/feature.js
index 123..456 789
--- a/src/feature.js
+++ b/src/feature.js
@@ -10,6 +10,8 @@
+// Neue Funktion zum Berechnen der Summe
+function sum(a, b) {
+  return a + b;
+}

Generierte Commit-Nachricht:

feat(utils): add sum function

- Add new sum function in src/feature.js for basic arithmetic
- Implementation details: pure function with two parameters

Generierte Push-Nachricht:

Der Skill kann auch eine Push-Nachricht für den Pull-Request generieren, z.B.:

„Fügt eine Summenfunktion hinzu, um grundlegende arithmetische Operationen zu unterstützen.“

Installation

Legen Sie die Datei git-authoring.md (oder wie auch immer die Skill-Datei heißt) in Ihrem KI-Assistenten-Konfigurationsverzeichnis ab. Starten Sie den Assistenten neu. Der Skill ist dann automatisch verfügbar.