Communitygithub.com

sous-titres-flashcards

Crée des commits git en respectant la spécification Conventional Commits, avec option de pousser. À utiliser lorsque l'utilisateur demande de valider des changements ou exécute /commit.

Qu'est-ce que sous-titres-flashcards ?

Cette compétence automatise la création de commits git conformes à la spécification Conventional Commits, une convention largement adoptée pour standardiser les messages de commit. Idéale pour les développeurs utilisant des agents IA (Claude Code, Cursor, Codex) dans leurs flux de travail git, elle analyse l'état du dépôt, prépare les changements et génère un message structuré. La compétence inspecte soigneusement les fichiers modifiés, ne stagified que les fichiers pertinents, et peut diviser les changements non liés en plusieurs commits. Le format du message inclut un type, une portée optionnelle, une description en impératif, un corps expliquant le pourquoi, et des pieds de page pour les changements cassants. Elle valide le succès du commit et, si demandé explicitement avec l'option `--push`, pousse les modifications vers le dépôt distant. Des règles strictes empêchent la réécriture de l'historique, le contournement des hooks, ou le commit sans changements, assurant ainsi des pratiques git fiables et prévisibles.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/josepdecid/subtitle-flashcards/tree/HEAD/.agents/skills/conventional-commit

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Flux de travail

  1. Inspectez l'état du dépôt : git status --short, git diff --cached et git diff. Vérifiez aussi git log --oneline -10 pour correspondre au style existant.
  2. Si rien n'est stagifié, stagifiez les changements pertinents par chemin explicite (évitez git add -A si des fichiers non liés ou sensibles sont présents). Ne stagifiez jamais .env, les secrets, ou .venv.
  3. Si les changements contiennent des préoccupations clairement non liées, divisez-les en commits séparés.
  4. Écrivez le message en respectant le format ci-dessous, puis committez avec git commit.
  5. Exécutez git status pour vérifier que le commit a réussi.
  6. Ne poussez que si l'utilisateur a passé --push : exécutez git push (utilisez git push -u origin <branche> si aucune amont n'est configurée). Ne forcez jamais le push.

Format du message

<type>(<portée optionnelle>): <description>

<corps optionnel>

<pied de page optionnel>
  • Types : feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
  • Description : mode impératif, minuscule, pas de point final, ~72 caractères max.
  • Portée : nom court pour la zone affectée (ex. cli, serveur, traduire) ; omettez si peu clair.
  • Corps : expliquez le pourquoi, enveloppé à ~72 caractères ; omettez pour les modifications triviales.
  • Changements cassants : ajoutez ! après le type/portée et un pied de page BREAKING CHANGE:.

Règles

  • Ne modifiez pas, ne rebasifiez pas et ne réécrivez pas l'historique sauf demande explicite.
  • Ne sautez pas les hooks (--no-verify).
  • Si un hook échoue, corrigez le problème et créez un nouveau commit.
  • Ne committez pas en l'absence de changements ; dites-le plutôt.

Skills associés