コンテンツにスキップ

Git Commit ガイドライン

概要

このプロジェクトではConventional Commits形式に基づいた コミットメッセージを使用します。 commitlint.config.jsの設定に従い、一貫性のあるコミット履歴を維持します。

コミットメッセージの形式

commitlint.config.jsの設定では、コミットタイプ(type)のみが必須です。

形式

<type>
  • type: コミットの種類(必須)- 次の13種類から選択

コミットタイプ

commitlint.config.jsで許可されている次の13種類のタイプを使用します。

feat - 新機能

新機能の追加に使用します。

Terminal window
# ✅ Good
feat

fix - バグ修正

バグの修正に使用します。

Terminal window
# ✅ Good
fix

docs - ドキュメントのみの変更

ドキュメントの追加や修正に使用します。コードの変更を伴わない場合に使用します。

Terminal window
# ✅ Good
docs

style - コードの動作に影響しない変更

フォーマット、セミコロンの追加・削除、インデントの調整など、コードの動作に影響しない変更に使用します。

Terminal window
# ✅ Good
style

refactor - コードのリファクタリング

機能追加やバグ修正を伴わないコードの改善に使用します。

Terminal window
# ✅ Good
refactor

perf - パフォーマンス改善

パフォーマンスの改善に使用します。

Terminal window
# ✅ Good
perf

test - テストの追加や修正

テストコードの追加や修正に使用します。

Terminal window
# ✅ Good
test

build - ビルドシステムの変更

ビルドツールや依存関係の変更に使用します。

Terminal window
# ✅ Good
build

ci - CI設定の変更

CI/CDパイプラインの設定変更に使用します。

Terminal window
# ✅ Good
ci

chore - その他の変更

上記のいずれにも該当しない変更に使用します。設定ファイルの変更、ツールの設定変更など。

Terminal window
# ✅ Good
chore

revert - 以前のコミットの取り消し

以前のコミットを取り消す場合に使用します。

Terminal window
# ✅ Good
revert

improvement - 改善

既存機能の改善に使用します。新機能追加(feat)でもバグ修正(fix)でもない、機能の改善に使用します。

Terminal window
# ✅ Good
improvement

security - セキュリティ関連の修正

セキュリティ脆弱性の修正やセキュリティ強化に使用します。

Terminal window
# ✅ Good
security

コミットメッセージの書き方

重要なポイント

commitlint.config.jsの設定では、コミットタイプ(type)のみが必須です。

  • type: 必須。次の13種類から選択

必須事項

次の点は必須です:

Terminal window
# 有効なコミットメッセージ
feat
fix
docs

AI向けの特別なガイドライン

変更内容の正確な反映(必須)

  • 変更内容を確認: git diffgit statusで変更内容を確認してからコミット(必須)
  • 適切なタイプの選択: 変更内容にもっとも適したタイプを選択(必須)

複数の変更がある場合

  • 分割は必須: 1つのコミットに1つの変更を必須とする
  • タイプが異なる場合は分割: 異なるタイプの変更は必ず分割する(必須)
Terminal window
# ✅ Good: 異なるタイプは分割
feat
test
# ❌ Bad: 異なるタイプを1つにまとめる(不可能)

タイプの選択ガイド(必須)

変更内容に応じて適切なタイプを選択してください(必須)。

変更内容タイプ
新機能の追加feat
バグの修正fix
ドキュメントの変更docs
フォーマットやスタイルの変更style
コードのリファクタリングrefactor
パフォーマンスの改善perf
テストの追加・修正test
ビルドツールの変更build
CI設定の変更ci
その他の変更chore
コミットの取り消しrevert
既存機能の改善improvement
セキュリティ関連の修正security

コミット前の確認事項

  1. 変更内容の確認: git statusgit diffで変更内容を確認(必須)
  2. タイプの選択: 変更内容にもっとも適したタイプを選択(必須)
  3. テストの実行: 変更が既存のテストを壊していないか確認(必須)