option
MaisonMaison Skill Révision du code commit-standards

Formater les messages de commit conformément à la norme « Conventional Commits ». À utiliser dans les cas suivants : rédaction de messages de commit, commande `git commit`, consultation de l'historique des commits. Mots-clés : commit, git, message, conventional, 提交, 訊息, feat, fix, refactor.

...Développer tout
49
Heure mise à jour 29 juin 2026

À propos de « commit-standards »

La compétence « commit-standards » garantit un formatage cohérent des messages de commit en respectant la norme « conventional commits ». Cela permet de s’assurer que les messages de commit sont clairs, concis et informatifs. Elle résout le problème des messages de commit incohérents ou vagues en proposant une approche structurée de la rédaction des messages, favorisant ainsi un historique des commits plus organisé et plus compréhensible. Cette norme est particulièrement utile pour la collaboration dans le cadre de projets de développement logiciel, où une gestion claire des versions et une documentation des modifications sont essentielles tant pour les équipes que pour les systèmes automatisés.

Cette fonctionnalité est conçue pour offrir un moyen simple et intuitif de formater les messages de commit. Elle utilise un ensemble de types de commit prédéfinis, tels que « feat », « fix », « refactor » et d’autres, afin de classer efficacement les modifications. Les utilisateurs peuvent suivre un format strict comprenant un objet, un corps et un pied de page, avec des règles spécifiques concernant la longueur de l’objet, l’emploi des majuscules et la ponctuation. La compétence prend également en charge des formats de messages de commit multilingues, notamment en anglais, en chinois traditionnel et des options bilingues, afin de s’adapter à divers environnements de développement.

Cette compétence est idéale pour les développeurs, les équipes et les contributeurs open source qui souhaitent adopter une approche cohérente et professionnelle en matière de messages de commit. Elle est particulièrement utile pour les relecteurs de code, les responsables du contrôle de version et toutes les parties prenantes qui s’appuient sur l’historique des commits pour comprendre les modifications apportées au code. Le système de configuration de cette fonctionnalité permet une personnalisation flexible en fonction des préférences du projet, ce qui la rend adaptable à divers flux de travail et aux besoins des équipes.

FAQ

Comment configurer la langue des messages de commit ?

Vous pouvez configurer la langue des messages de commit dans le fichier « CONTRIBUTING.md » de votre projet. Si aucune configuration n’est détectée, le système utilisera l’anglais par défaut. Les options disponibles sont l’anglais, le chinois traditionnel et le mode bilingue.

Que se passe-t-il si mon message de commit ne respecte pas la norme ?

La compétence ne signalera pas automatiquement d’erreurs, mais encourage les bonnes pratiques en matière de cohérence et de clarté. Il appartient à votre équipe de s’assurer que les messages respectent le format.

Puis-je utiliser cette fonctionnalité pour des projets autres que le développement logiciel ?

Oui, bien qu’elle soit principalement conçue pour les projets logiciels, tout projet nécessitant un versionnage clair et une documentation des modifications peut tirer parti de cette fonctionnalité.

Cette fonctionnalité prend-elle en charge plusieurs langues dans les messages de commit ?

Oui, cette fonctionnalité prend en charge les messages de commit en anglais, en chinois traditionnel et bilingues. Vous pouvez choisir votre configuration linguistique préférée dans le fichier « CONTRIBUTING.md ».

Quels types de commits cette compétence prend-elle en charge ?

Cette fonctionnalité prend en charge divers types de commits, notamment « feat », « fix », « refactor », « docs », « style », « test », « perf », « build », « ci », « chore », « revert » et « security ».

Voir sur GitHub

Commit Message Standards

This skill ensures consistent, meaningful commit messages following conventional commits.

Quick Reference

Basic Format

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

Commit Types

English中文When to Use
feat新增New feature
fix修正Bug fix
refactor重構Code refactoring (no functional change)
docs文件Documentation only
style樣式Formatting (no code logic change)
test測試Adding or updating tests
perf效能Performance improvement
build建置Build system or dependencies
ci整合CI/CD pipeline changes
chore維護Maintenance tasks
revert回退Revert previous commit
security安全Security vulnerability fix

Subject Line Rules

  1. Length: ≤72 characters (50 ideal)
  2. Tense: Imperative mood ("Add feature" not "Added feature")
  3. Capitalization: First letter capitalized
  4. No period: Don't end with a period

Detailed Guidelines

For complete standards, see:

  • Conventional Commits Guide
  • Language Options

Examples

✅ Good Examples (English)

feat(auth): Add OAuth2 Google login supportfix(api): Resolve memory leak in user session cacherefactor(database): Extract query builder to separate classdocs(readme): Update installation instructions for Node 20

✅ Good Examples (中文)

新增(認證): 實作 OAuth2 Google 登入支援修正(API): 解決使用者 session 快取記憶體洩漏重構(資料庫): 提取查詢建構器為獨立類別

✅ Good Example (Bilingual)

feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援。Implement Google OAuth2 authentication flow for user login.實作 Google OAuth2 認證流程供使用者登入。Closes #123

❌ Bad Examples

fixed bug                    # Too vague, no scopefeat(auth): added google login  # Past tenseUpdate stuff.                # Period, vagueWIP                          # Not descriptive

Body Guidelines

Use the body to explain WHY the change was made:

fix(api): Resolve race condition in concurrent user updatesWhy this occurred:- Two simultaneous PUT requests could overwrite each other- No optimistic locking implementedWhat this fix does:- Add version field to User model- Return 409 Conflict if version mismatchFixes #789

Breaking Changes

Always document breaking changes in footer:

feat(api): Change user endpoint response formatBREAKING CHANGE: User API response format changedMigration guide:1. Update API clients to remove .data wrapper2. Use created_at instead of createdAt

Issue References

Closes #123    # Automatically closes issueFixes #456     # Automatically closes issueRefs #789      # Links without closing

Configuration Detection

This skill supports project-specific language configuration.

Detection Order

  1. Check CONTRIBUTING.md for "Commit Message Language" section
  2. If found, use the specified option (English / Traditional Chinese / Bilingual)
  3. If not found, default to English for maximum tool compatibility

First-Time Setup

If no configuration found and context is unclear:

  1. Ask the user: "This project hasn't configured commit message language preference. Which option would you like to use? (English / 中文 / Bilingual)"
  2. After user selection, suggest documenting in CONTRIBUTING.md:
## Commit Message LanguageThis project uses **[chosen option]** commit types.<!-- Options: English | Traditional Chinese | Bilingual -->

Configuration Example

In project's CONTRIBUTING.md:

## Commit Message LanguageThis project uses **English** commit types.### Allowed Typesfeat, fix, refactor, docs, style, test, perf, build, ci, chore, revert, security

License: CC BY 4.0 | Source: universal-dev-standards

Tous les fichiers

3 fichiers
SKILL.md 4.3k
Voir

Installer commit-standards

Téléchargez et décompressez les fichiers de compétences dans votre répertoire .claude/skills/.

Télécharger le ZIP

Clonez le dépôt et copiez les fichiers de compétence dans votre projet.

git clone https://github.com/AsiaOstrich/universal-dev-skills/blob/main/skills/commit-standards/SKILL.md # Copy SKILL.md to your .claude/skills/ directory

Copier Copier
Configuration rapide: Copiez le dossier de la compétence dans .claude/skills/ ; Claude la détectera automatiquement et l'utilisera.

Compétences similaires

code-simplify
Heure mise à jour 2 juillet 2026
requesting-code-review
Heure mise à jour 29 juin 2026
Git Commit Helper
Heure mise à jour 29 juin 2026
fetch-pr-review-comments
Heure mise à jour 29 juin 2026
OR