Que fait ce-commit ?
Créez un commit git avec un message clair et porteur de valeur. Utilisez lorsque l'utilisateur dit "commit", "commit ceci", "enregistrer mes modifications", "créer un commit", ou souhaite commiter un travail stagé ou non stagé. Produit des messages de commit bien structurés qui suivent les conventions du dépôt lorsqu'elles existent, et par défaut le format de commit conventionnel autrement.
Fonctionnement :
- Analyse du contexte : Le skill détecte si le dépôt a des conventions de message de commit documentées (par exemple dans
CONTRIBUTING.md,.gitmessage, ou dans l'historique des commits). Si oui, il les utilise comme guide. Sinon, il applique le format de commit conventionnel (type(scope): description). - Génération du message : En se basant sur les changements stagés ou non stagés (via
git diff), il synthétise un message court mais informatif, incluant le type (feat, fix, chore, etc.), le scope optionnel, et une description concise. - Validation utilisateur : Avant de créer le commit, le message généré est présenté à l'utilisateur pour approbation ou modification. Cela garantit que le message soit pertinent et personnalisé.
Cas d'utilisation :
- L'utilisateur dit "commit" : le skill commit automatiquement les changements stagés avec un message généré.
- L'utilisateur dit "commit ceci" (en pointant un fichier ou une zone de code) : le skill commit uniquement les changements pertinents.
- L'utilisateur dit "enregistrer mes modifications" ou "créer un commit" : idem.
Avantages :
- Cohérence : Uniformise les messages de commit dans le projet.
- Qualité : Messages informatifs qui aident à la relecture de code et à la génération de changelogs.
- Gain de temps : Évite de rédiger manuellement des messages.
Exemple de message généré :
feat(api): ajouter un endpoint de pagination
Note : Le skill ne modifie pas les fichiers ni n'effectue de push ; il crée simplement un commit local. L'utilisateur peut ajuster le message avant validation.