Rédiger un commit au format Sentry

Ce que ça fait

• Interdit d’inclure noms de clients ou d’organisations, e-mails, tickets de support, secrets ou données personnelles : on décrit le symptôme technique.
• Ajoute Fixes pour clore une issue à la fusion, Refs pour un simple lien, et un pied BREAKING CHANGE en cas de rupture.
• Passe le message par des arguments -m séparés pour le corps et les pieds ; n’écrit jamais de séquences d’échappement de saut de ligne, n’ouvre pas d’éditeur interactif.
• S’arrête plutôt que de committer à l’aveugle sur main ou master.

Pour qui, et un exemple

Contributeurs aux dépôts Sentry, ou équipes qui adoptent les mêmes conventions de message et de pied d’issue.

À chaque demande de commit ou de brouillon de message de commit, pour obtenir un message conventionnel Sentry avec références d’issues. Exemple rédigé par iadujour.fr à partir du SKILL.md, non testé.

Installer

npx skills add getsentry/skills ou, dans Claude Code, claude plugin marketplace add getsentry/skills puis claude plugin install sentry-skills@sentry-skills.

Fonctionne avec

• Claude Code
• Cursor
• Cline
• GitHub Copilot

Source : README : installation Claude Code, et skills.sh « Works with Claude Code, Cursor, Cline, GitHub Copilot, and other compatible agents ».

Niveau : Intermédiaire

À savoir

Extrait du SKILL.md

La description d’origine, celle que l’agent lit pour décider de charger la skill (en anglais) :

Use for every request to commit changes or draft a commit message. Creates Sentry-style conventional commits with issue references.

Citée depuis le SKILL.md au commit 412f236 .

Le SKILL.md compte 57 lignes et 4 sections principales :

• Before Committing
• Message Rules
• Footers
• Creating the Commit

Licence : Apache 2.0

Vérifiée le 10 novembre 2026 sur : fichier LICENSE du dépôt .

La licence autorise la reprise : le texte intégral du SKILL.md est reproduit ci-dessous, sans modification, avec sa mention de licence.

Texte intégral du SKILL.md

Reproduit sans modification depuis getsentry/skills (commit 412f236) , © Sentry, sous licence Apache 2.0 (fichier de licence d’origine ).

---
name: commit
description: Use for every request to commit changes or draft a commit message. Creates Sentry-style conventional commits with issue references.
---

# Sentry Commit Messages

## Before Committing

```bash
git branch --show-current
```

If the branch is `main` or `master`, create a feature branch unless the user
explicitly requested a direct commit. Re-check the branch and stop if it is
still `main` or `master`.

Commit one coherent, independently reviewable change at a time.

## Message Rules

Use:

```text
<type>(<scope>): <subject>

<optional body>

<optional footer>
```

- Scope is optional. Add `!` before `:` for a breaking change.
- Write the subject in imperative, present tense; capitalize it, omit the
  trailing period, and keep it at 70 characters or fewer.
- Keep every line under 100 characters.
- Use the body only when useful. Explain what changed and why, including
  previous behavior or motivation when it helps.
- Never include customer or organization names, user emails, support ticket
  contents, secrets, or PII. Describe the technical symptom instead.

Allowed types: `feat`, `fix`, `ref`, `perf`, `docs`, `test`, `build`,
`ci`, `chore`, `style`, `meta`, `license`, and `revert`.

Use `ref` for refactoring without behavior changes, `style` for formatting
without logic changes, and `meta` for repository metadata.

## Footers

- `Fixes <issue>` closes an issue when merged.
- `Refs <issue>` links an issue without closing it.
- For breaking changes, add `BREAKING CHANGE: <impact>`.

## Creating the Commit

Use separate `-m` arguments for paragraphs and footers. Never put literal
`\n` sequences in a commit message or open an interactive editor.

```bash
git commit -m "fix(api): Handle null response in user endpoint" \
  -m "Return 404 when the user API finds a deleted account." \
  -m "Fixes SENTRY-5678"
```