commit

par sentry

Créer des messages de commit suivant les conventions Sentry. Utiliser lors de la validation de modifications de code, de la rédaction de messages de commit ou du formatage de l'historique git. Suit les conventions…

npx skills add https://github.com/getsentry/webvitals.com --skill commit
Télécharger ZIPGitHub
12

Sentry Commit Messages

Follow these conventions when creating commits for Sentry projects.

Prerequisites

Before committing, ensure you're working on a feature branch, not the main branch.

# Check current branch
git branch --show-current

If you're on main or master, create a new branch first:

# Create and switch to a new branch
git checkout -b <type>/<short-description>

Branch naming should follow the pattern: <type>/<short-description> where type matches the commit type (e.g., feat/add-user-auth, fix/null-pointer-error, ref/extract-validation).

Format

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

<body>

<footer>

The header is required. Scope is optional. All lines must stay under 100 characters.

Commit Types

TypePurpose
featNew feature
fixBug fix
refRefactoring (no behavior change)
perfPerformance improvement
docsDocumentation only
testTest additions or corrections
buildBuild system or dependencies
ciCI configuration
choreMaintenance tasks
styleCode formatting (no logic change)
metaRepository metadata
licenseLicense changes

Subject Line Rules

  • Use imperative, present tense: "Add feature" not "Added feature"
  • Capitalize the first letter
  • No period at the end
  • Maximum 70 characters

Body Guidelines

  • Explain what and why, not how
  • Use imperative mood and present tense
  • Include motivation for the change
  • Contrast with previous behavior when relevant

Footer: Issue References

Reference issues in the footer using these patterns:

Fixes GH-1234
Fixes #1234
Fixes SENTRY-1234
Refs LINEAR-ABC-123
  • Fixes closes the issue when merged
  • Refs links without closing

AI-Generated Changes

When changes were primarily generated by a coding agent (like Claude Code), include the Co-Authored-By attribution in the commit footer:

Co-Authored-By: Claude <noreply@anthropic.com>

This is the only indicator of AI involvement that should appear in commits. Do not add phrases like "Generated by AI", "Written with Claude", or similar markers in the subject, body, or anywhere else in the commit message.

Examples

Simple fix

fix(api): Handle null response in user endpoint

The user API could return null for deleted accounts, causing a crash
in the dashboard. Add null check before accessing user properties.

Fixes SENTRY-5678
Co-Authored-By: Claude <noreply@anthropic.com>

Feature with scope

feat(alerts): Add Slack thread replies for alert updates

When an alert is updated or resolved, post a reply to the original
Slack thread instead of creating a new message. This keeps related
notifications grouped together.

Refs GH-1234

Refactor

ref: Extract common validation logic to shared module

Move duplicate validation code from three endpoints into a shared
validator class. No behavior change.

Breaking change

feat(api)!: Remove deprecated v1 endpoints

Remove all v1 API endpoints that were deprecated in version 23.1.
Clients should migrate to v2 endpoints.

BREAKING CHANGE: v1 endpoints no longer available
Fixes SENTRY-9999

Revert Format

revert: feat(api): Add new endpoint

This reverts commit abc123def456.

Reason: Caused performance regression in production.

Principles

  • Each commit should be a single, stable change
  • Commits should be independently reviewable
  • The repository should be in a working state after each commit

References

Plus de skills de sentry

generate-frontend-forms
sentry
Guide pour créer des formulaires à l'aide du nouveau système de formulaires de Sentry. À utiliser lors de l'implémentation de formulaires, de champs de formulaire, de validation ou de fonctionnalité de sauvegarde automatique.
official
sentry-snapshots-cocoa
sentry
Configuration complète de Sentry Snapshots pour les projets Apple/Cocoa. Utiliser lorsqu’on demande de « configurer SnapshotPreviews », « configurer les tests de snapshots Apple », « télécharger les snapshots Apple vers…
official
architecture-review
sentry
Revue de la santé du codebase au niveau de l'équipe. Détecte les modules monolithiques, les échecs silencieux, les lacunes de sécurité de type, les trous de couverture de test et les problèmes de convivialité pour les LLM.
official
linear-type-labeler
sentry
Classe les tickets Linear et applique un label de type issu de la taxonomie de labels de l'espace de travail Sentry, en fonction du contenu du titre et de la description de chaque ticket.
official
sentry-flutter-sdk
sentry
Configuration complète du SDK Sentry pour Flutter et Dart. Utiliser lorsqu'il est demandé d'« ajouter Sentry à Flutter », d'« installer sentry_flutter », de « configurer Sentry dans Dart » ou de paramétrer la gestion des erreurs…
official
sentry-svelte-sdk
sentry
Configuration complète du SDK Sentry pour Svelte et SvelteKit. Utiliser lorsqu'il est demandé d'« ajouter Sentry à Svelte », d'« ajouter Sentry à SvelteKit », d'« installer @sentry/sveltekit », ou de configurer…
official
vercel-react-best-practices
sentry
Directives d'optimisation des performances React et Next.js de l'équipe Vercel Engineering. Cette compétence doit être utilisée lors de l'écriture, de la révision ou du refactoring de code React/Next.js…
official
sentry-tanstack-start-sdk
sentry
Configuration complète du SDK Sentry pour TanStack Start React. À utiliser lorsqu'on vous demande "ajouter Sentry à TanStack Start", "installer @sentry/tanstackstart-react", ou configurer la gestion des erreurs…
official