Commit atomique

VérifiéPrudence

Analyse les modifications non commitées et effectue des commits atomiques en suivant les conventions du projet.

Spar Skills Guide Bot
DeveloppementIntermédiaire
22/07/2026
Claude Code
#git#atomic-commits#conventional-commits#commit-workflow#code-review

Recommandé pour

Synthèse automatique

Analyse les modifications non commitées d'un dépôt et crée des commits atomiques conformes aux conventions du projet, après validation d'un plan par l'utilisateur.

Points forts

  • Découpe les changements en commits atomiques en s'appuyant sur des règles d'atomicité explicites plutôt que sur une simple liste de fichiers
  • Lit les conventions du projet et l'issue active pour rattacher les commits à un ticket via Closes #N ou Part of #N
  • Présente un plan détaillé et attend la confirmation avant d'exécuter le moindre git add ou git commit
  • Enchaîne de façon optionnelle sur /open-pr pour pousser la branche et ouvrir la pull request

Limites

  • Repose sur des fichiers de configuration propres au dépôt (.claude/rules/code-conventions.md, atomicity-rules.md, .claude/current-issue) qui doivent exister ou être adaptés
  • La lecture de l'issue active dépend de la CLI gh et échoue silencieusement si elle n'est pas authentifiée
  • Ne couvre pas les opérations git avancées comme le rebase, le revert ou la résolution de conflits
Quand l'utiliser

À utiliser quand un lot de modifications en cours doit être transformé en commits propres et bien découpés sans rédiger les messages à la main.

Quand l'éviter

À éviter sur un dépôt sans conventions définies ou pour des tâches git qui ne sont pas de la création de commits (rebase, revert, résolution de conflits).

Analyse de sécurité

Prudence
Score qualité82/100

The skill is a fairly conservative commit workflow: it diagnoses, groups changes into atomic commits, presents a plan and explicitly waits for confirmation before staging/committing, and it never pushes without an extra opt-in. It uses git and gh CLI for exactly their legitimate purposes: no destructive commands, no network exfiltration, no obfuscated payloads, no secret handling. The only real concerns are the inherent power of git commit plus the unquoted `$(cat .claude/current-issue)` substitution and reliance on repo-local rule files, which is why caution rather than safe is appropriate.

Points d'attention
  • •Runs shell commands (git status/diff/add/commit, gh issue view) that mutate the repository — intended purpose, but still powerful tooling that should be gated by the confirmation step
  • •Unquoted command substitution `gh issue view $(cat .claude/current-issue)` can misbehave if that file contains unexpected/whitespace content; minor injection/robustness concern
  • •Depends on external files not shipped here (./atomicity-rules.md, .claude/rules/code-conventions.md, .claude/current-issue) so behavior is partly determined by unreviewed content in the target repo
  • •Optional follow-on `/open-pr` performs push and PR creation — but only after explicitly asking the user
Comment cette analyse est faite

Exemples

Commit current work
Commit my current changes as atomic commits following the project conventions.
Plan before committing
Analisa as mudanças não-commitadas e propõe um plano de commits atômicos antes de executar qualquer coisa.
Link to active issue
Stage and commit this refactor, and link the commits to the current active issue.

name: commit description: Analisa mudanças não-commitadas e realiza commits atômicos seguindo as convenções do projeto. Use when the user wants to commit changes, stage files, or create a structured commit message. $ARGUMENTS

Commit

Workflow

1. Diagnosticar

git status
git diff --stat HEAD

Se a working tree estiver limpa, informe o usuário e pare.

2. Ler convenções

  • atomicity-rules.md — tipos, escopos, regras de atomicidade
  • .claude/rules/code-conventions.md — convenções de código do projeto

3. Identificar issue ativa

cat .claude/current-issue 2>/dev/null || echo "(nenhuma)"
gh issue view $(cat .claude/current-issue) --json number,title,body,labels 2>/dev/null

4. Inspecionar mudanças

git diff          # não-staged
git diff --cached # staged
git ls-files --others --exclude-standard  # untracked

Leia arquivos novos relevantes com Read para entender o que fazem.

5. Agrupar em commits atômicos

Aplique as regras de atomicidade. Regra de ouro: se precisar de mais de uma frase para descrever o que foi feito (não o porquê), divida o commit.

6. Propor plano — aguardar confirmação

Plano de commits (N commits):

1. tipo(escopo): descrição curta
   Arquivos: path/arquivo1.py, path/arquivo2.py
   Corpo: [porquê da mudança, se necessário]

Se houver issue ativa, o último commit relevante deve referenciar no rodapé (Closes #N ou Part of #N). Aguardar confirmação antes de executar.

7. Executar após confirmação

git add caminho/arquivo1 caminho/arquivo2
git commit -m "tipo(escopo): descrição

Corpo opcional (wrap a 72 chars).

Closes #N"
git log --oneline -1  # confirmar cada commit

8. Resumo final

git log --oneline -N

Perguntar se deseja abrir o PR agora via /open-pr (que faz o push, cria o PR e move as issues para In review). Se a resposta for não, parar aqui — sem push.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/atomic-commit-mrwakeqy/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/atomic-commit-mrwakeqy' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/atomic-commit-mrwakeqy/download' --output '.skill-downloads/atomic-commit-mrwakeqy/SKILL.md.part' && mv '.skill-downloads/atomic-commit-mrwakeqy/SKILL.md.part' '.skill-downloads/atomic-commit-mrwakeqy/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/atomic-commit-mrwakeqy/SKILL.md' && test -s '.skill-downloads/atomic-commit-mrwakeqy/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/commit' && cp -R '.skill-downloads/atomic-commit-mrwakeqy' '.claude/skills/commit'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/atomic-commit-mrwakeqy'

openskills read 'atomic-commit-mrwakeqy'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/atomic-commit-mrwakeqy/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires