Conventional Commits Skill für OpenClaw

OpenClaw Conventional Commits Skill — Überblick

Der Conventional Commits Skill bringt strukturierte, spezifikationskonforme Commit-Nachrichten in Ihren OpenClaw-Workflow. Anstatt Commit-Nachrichten von Grund auf zu schreiben oder die Conventional Commits Spezifikation auswendig zu lernen, bitten Sie einfach Ihren OpenClaw-Agenten, Nachrichten basierend auf Ihren gestagten Änderungen zu generieren oder zu validieren.

Conventional Commits ist eine leichtgewichtige Konvention über Commit-Nachrichten, die eine klare, maschinenlesbare Historie bereitstellt. Sie unterstützt automatische Changelogs, semantische Versionierung und Release-Tools in Tausenden von Open-Source- und Enterprise-Projekten. Mit diesem OpenClaw-Skill erhalten Sie all diese Vorteile ohne zusätzliche kognitive Belastung.

Typischer Workflow:

1. Stagen Sie Ihre Änderungen mit git add.
2. Bitten Sie OpenClaw, eine Commit-Nachricht zu schreiben.
3. Der Agent analysiert den Diff, bestimmt den korrekten Typ (feat, fix, docs usw.) und schlägt eine korrekt formatierte Nachricht vor — bereit zum Committen.

Voraussetzungen für den Conventional Commits Skill

Bevor Sie den Conventional Commits Skill installieren, stellen Sie sicher, dass Sie haben:

• OpenClaw installiert und laufend (v1.0+)
• Git installiert (v2.20+) — offizieller Download
• Ein mit git init initialisiertes Projekt-Repository
• clawhub CLI installiert für Skill-Management

Überprüfen Sie Ihre Einrichtung:

# OpenClaw-Version prüfen
openclaw --version

# Git-Version prüfen
git --version

# Bestätigen, dass Sie sich in einem Git-Repository befinden
git status

Conventional Commits Skill installieren

Installieren Sie den Conventional Commits Skill mit einem einzigen Befehl:

npx clawhub@latest install conventional-commits

Installation überprüfen:

clawhub list

Sie sollten conventional-commits in der Liste der installierten Skills sehen. Der Skill funktioniert sofort — keine API-Schlüssel oder externe Dienste erforderlich.

Conventional Commits Skill Konfiguration

Dieser Skill erfordert minimale Konfiguration. Er liest Ihre gestagten Git-Änderungen und formatiert Nachrichten gemäß der Conventional Commits Spezifikation. Sie können jedoch das Verhalten an die Konventionen Ihres Teams anpassen.

Commit-Typen

Der Skill erkennt die Standard-Conventional-Commits-Typen:

| Typ | Verwendung | |-----|-----------| | feat | Ein neues Feature für den Benutzer | | fix | Eine Fehlerbehebung | | docs | Nur Dokumentationsänderungen | | style | Formatierung, fehlende Semikolons (keine Logikänderung) | | refactor | Code-Umstrukturierung ohne Feature oder Fix | | perf | Leistungsverbesserungen | | test | Tests hinzufügen oder aktualisieren | | chore | Build-Prozess, Dependency-Updates, Tooling | | ci | CI/CD-Konfigurationsänderungen |

Scoped Commits

Der Skill unterstützt Scoped Commit-Nachrichten für Monorepos und größere Projekte:

feat(auth): add OAuth2 login flow
fix(api): handle null response from payment endpoint
docs(readme): update installation instructions

Sie können erlaubte Scopes in Ihrer Projektkonfiguration definieren, um Konsistenz zwischen Mitwirkenden zu gewährleisten.

Conventional Commits Skill Verwendungsbeispiele

1. Commit-Nachricht aus gestagten Änderungen generieren

Sie: „Schreib eine Commit-Nachricht für meine gestagten Änderungen."

Der Agent prüft git diff --staged, erkennt, dass Sie einen neuen API-Endpunkt hinzugefügt haben, und gibt zurück:

feat(api): add user profile endpoint

Implement GET /api/users/:id/profile with authentication
middleware and response caching.

Sie können akzeptieren, bearbeiten oder den Agenten bitten, mit einem anderen Ton oder Scope neu zu generieren.

2. Bestehende Commit-Nachricht validieren

Sie: „Prüfe, ob diese Commit-Nachricht der Konvention folgt: 'Updated the login page'"

Der Agent analysiert die Nachricht und gibt spezifisches Feedback:

• Fehlender Typ-Präfix — sollte mit feat:, fix: oder einem anderen gültigen Typ beginnen
• Verwendet Vergangenheitsform ("Updated") — die Konvention empfiehlt Imperativ ("update")
• Korrekturvorschlag: fix(auth): update login page layout

3. Letzte Commits im Batch validieren

Sie: „Validiere die letzten 10 Commit-Nachrichten auf diesem Branch."

Der Agent geht Ihre kürzliche Historie durch und markiert Commits, die nicht der Konvention folgen, mit korrigierten Alternativen für jeden. Dies ist nützlich vor dem Mergen eines Feature-Branches in main.

4. Breaking-Change-Commit generieren

Sie: „Committe das als Breaking Change — wir haben die v1 API entfernt."

Der Agent formatiert einen korrekten Breaking-Change-Commit:

feat(api)!: remove deprecated v1 endpoints

BREAKING CHANGE: All /api/v1/* routes have been removed.
Consumers must migrate to /api/v2/* before upgrading.

Sowohl das !-Suffix als auch der BREAKING CHANGE-Footer sind enthalten, um die Kompatibilität mit Tools wie semantic-release und standard-version sicherzustellen.

Sicherheit und Best Practices

Der Conventional Commits Skill ist einer der sichersten Skills im OpenClaw-Ökosystem — er arbeitet rein mit Textformatierung und -validierung, ohne externe API-Aufrufe oder Schreiboperationen über Ihr lokales Git-Repository hinaus.

Befolgen Sie diese Richtlinien für die beste Erfahrung:

• Vor dem Commit prüfen. Lesen Sie immer die generierte Nachricht, bevor Sie sie akzeptieren. Der Agent leitet die Absicht aus Diffs ab, aber Sie kennen den Kontext am besten.
• Konsistente Scopes verwenden. Definieren Sie eine Liste erlaubter Scopes für Ihr Projekt und teilen Sie diese mit Ihrem Team, um Scope-Drift zu verhindern.
• Mit CI-Validierung kombinieren. Tools wie commitlint können Conventional Commits in Ihrer CI-Pipeline erzwingen und manuelle Commits abfangen, die den Skill umgehen.
• Pre-Commit-Hooks aktivieren. Verwenden Sie husky oder lefthook, um die Validierung von Commit-Nachrichten automatisch auszuführen.

Häufige Fehler beheben

"Not a git repository"

Der Skill erfordert, dass Sie sich in einem mit Git initialisierten Verzeichnis befinden.

# Neues Repository initialisieren
git init

# Oder zu Ihrem bestehenden Projekt navigieren
cd /path/to/your/project

"No staged changes found"

Der Skill benötigt gestagte Änderungen, um eine aussagekräftige Commit-Nachricht zu generieren.

# Bestimmte Dateien stagen
git add src/feature.ts

# Oder alle Änderungen stagen
git add -A

"Unable to determine commit type"

Dies kann auftreten, wenn der Diff sehr groß ist oder viele unzusammenhängende Dateien betrifft. Versuchen Sie, kleinere, fokussierte Changesets zu stagen, oder geben Sie den Typ manuell an:

Sie: „Schreib eine Refactor-Commit-Nachricht für diese Änderungen."