Conventional Commits Skill pour OpenClaw

OpenClaw Conventional Commits Skill — Présentation

Le skill Conventional Commits apporte des messages de commit structurés et conformes à la spécification dans votre workflow OpenClaw. Au lieu d'écrire des messages de commit depuis zéro ou d'essayer de mémoriser la spécification Conventional Commits, demandez simplement à votre agent OpenClaw de générer ou valider des messages basés sur vos changements indexés.

Conventional Commits est une convention légère au-dessus des messages de commit qui fournit un historique clair et lisible par les machines. Elle alimente les changelogs automatiques, le versionnage sémantique et les outils de publication dans des milliers de projets open source et d'entreprise. Avec ce skill OpenClaw, vous obtenez tous ces avantages sans charge cognitive supplémentaire.

Workflow typique :

1. Indexez vos changements avec git add.
2. Demandez à OpenClaw d'écrire un message de commit.
3. L'agent analyse le diff, détermine le type correct (feat, fix, docs, etc.) et propose un message correctement formaté — prêt à être commité.

Prérequis pour le Conventional Commits Skill

Avant d'installer le skill Conventional Commits, assurez-vous d'avoir :

• OpenClaw installé et en fonctionnement (v1.0+)
• Git installé (v2.20+) — téléchargement officiel
• Un dépôt de projet initialisé avec git init
• clawhub CLI installé pour la gestion des skills

Vérifiez votre configuration :

# Vérifier la version d'OpenClaw
openclaw --version

# Vérifier la version de Git
git --version

# Confirmer que vous êtes dans un dépôt Git
git status

Comment Installer le Conventional Commits Skill

Installez le skill Conventional Commits avec une seule commande :

npx clawhub@latest install conventional-commits

Pour vérifier l'installation :

clawhub list

Vous devriez voir conventional-commits dans la liste des skills installés. Le skill fonctionne immédiatement — aucune clé API ni service externe requis.

Configuration du Conventional Commits Skill

Ce skill nécessite une configuration minimale. Il lit vos changements Git indexés et formate les messages selon la spécification Conventional Commits. Cependant, vous pouvez personnaliser son comportement pour correspondre aux conventions de votre équipe.

Types de Commit

Le skill reconnaît les types standard Conventional Commits :

| Type | Quand l'Utiliser | |------|-----------------| | feat | Une nouvelle fonctionnalité pour l'utilisateur | | fix | Une correction de bug | | docs | Changements de documentation uniquement | | style | Formatage, point-virgules manquants (pas de changement logique) | | refactor | Restructuration du code sans fonctionnalité ni correction | | perf | Améliorations de performance | | test | Ajout ou mise à jour de tests | | chore | Processus de build, mises à jour de dépendances, outillage | | ci | Changements de configuration CI/CD |

Commits avec Portée

Le skill prend en charge les messages de commit avec portée pour les monorepos et les projets importants :

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

Vous pouvez définir les portées autorisées dans la configuration de votre projet pour maintenir la cohérence entre les contributeurs.

Exemples d'Utilisation du Conventional Commits Skill

1. Générer un Message de Commit depuis les Changements Indexés

Vous : « Écris un message de commit pour mes changements indexés. »

L'agent inspecte git diff --staged, identifie que vous avez ajouté un nouveau endpoint API et retourne :

feat(api): add user profile endpoint

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

Vous pouvez accepter, modifier ou demander à l'agent de régénérer avec un ton ou une portée différente.

2. Valider un Message de Commit Existant

Vous : « Vérifie si ce message de commit suit la convention : 'Updated the login page' »

L'agent analyse le message et répond avec un retour spécifique :

• Préfixe de type manquant — devrait commencer par feat:, fix: ou un autre type valide
• Utilise le passé ("Updated") — la convention recommande l'impératif ("update")
• Correction suggérée : fix(auth): update login page layout

3. Valider les Commits Récents en Lot

Vous : « Valide les 10 derniers messages de commit sur cette branche. »

L'agent parcourt votre historique récent et signale les commits qui ne suivent pas la convention, fournissant des alternatives corrigées pour chacun. C'est utile avant de fusionner une branche de fonctionnalité dans main.

4. Générer un Commit de Changement Majeur

Vous : « Commite ceci comme un changement majeur — nous avons supprimé l'API v1. »

L'agent formate un commit de changement majeur approprié :

feat(api)!: remove deprecated v1 endpoints

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

Le suffixe ! et le footer BREAKING CHANGE sont tous deux inclus, assurant la compatibilité avec des outils comme semantic-release et standard-version.

Sécurité et Bonnes Pratiques

Le skill Conventional Commits est l'un des skills les plus sûrs de l'écosystème OpenClaw — il opère uniquement sur le formatage et la validation de texte, sans appels API externes ni opérations d'écriture au-delà de votre dépôt Git local.

Suivez ces recommandations pour la meilleure expérience :

• Révisez avant de commiter. Lisez toujours le message généré avant de l'accepter. L'agent déduit l'intention des diffs, mais vous connaissez mieux le contexte.
• Utilisez des portées cohérentes. Définissez une liste de portées autorisées pour votre projet et partagez-la avec votre équipe pour éviter la dérive des portées.
• Combinez avec la validation CI. Des outils comme commitlint peuvent imposer Conventional Commits dans votre pipeline CI, capturant les commits manuels qui contournent le skill.
• Activez les hooks pre-commit. Utilisez husky ou lefthook pour exécuter automatiquement la validation des messages de commit.

Résolution des Erreurs Courantes

"Not a git repository"

Le skill nécessite que vous soyez dans un répertoire initialisé avec Git.

# Initialiser un nouveau dépôt
git init

# Ou naviguer vers votre projet existant
cd /path/to/your/project

"No staged changes found"

Le skill a besoin de changements indexés pour générer un message de commit significatif.

# Indexer des fichiers spécifiques
git add src/feature.ts

# Ou indexer tous les changements
git add -A

"Unable to determine commit type"

Cela peut survenir quand le diff est très volumineux ou touche beaucoup de fichiers non liés. Essayez d'indexer des ensembles de changements plus petits et ciblés, ou spécifiez le type manuellement :

Vous : « Écris un message de commit de type refactor pour ces changements. »