git-commit について
git-commitは、Conventional Commitsに沿ったGitコミットの自動化を支援するスキルです。変更の分類、選択的なステージング、メッセージ作成、履歴確認の手順を示します。
主な機能
- 01変更を論理的な範囲で分類
- 02Conventional Commitsに準拠
- 03ファイルを選択してステージング
- 04複雑な変更の本文を作成
- 05直近のコミット履歴を確認
活用シーン
- 01機能やモジュール単位でコミットを分割
- 02コード変更の規約に沿ったメッセージ作成
- 03意図したファイルだけをコミット
- 04コミット後にGit履歴を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dhruvanbhalara/ skills --skill git-commitインストール後、Claude Code で/git-commitを入力して読み込まれたか確認します。
詳細
自動化された Git コミット
このスキルは、Conventional Commits 仕様に従って、アトミックで構造化された Git コミットを実行するための手順を提供します。
1. 変更を分析する
- 変更されたファイルを特定する:
git status --shortを実行して、ステージ済みおよび未ステージのすべての変更を確認します。 - 無視ルールを尊重する: ユーザーが明示的に無視を求めたファイルや、
.gitignoreパターンに一致するファイルを含めないでください。 - スコープごとにグループ化する: 変更されたファイルを論理的な「スコープ」(例: 特定のモジュール、機能、または
data、domain、uiなどの層)ごとにグループ化します。
2. ブランチ運用
- フィーチャーブランチ: 常に
mainから説明的なフィーチャーブランチを作成します(例:feat/login-logic)。 - マージフロー: すべての品質チェックと PR 承認を通過した後にのみ、
mainにマージし直します。
3. コミットメッセージを生成する
- Conventional Commits: 各コミットは
<type>(<scope>): <message>というパターンに従わなければなりません(MUST)。- タイプ:
feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert。 - スコープ: 変更されるモジュールまたは領域(例:
auth、api)。 - メッセージ: 命令形による簡潔な説明。
- タイプ:
- サブメッセージ(コミット本文):
- 変更にロジック、破壊的変更、または複数のステップが含まれる場合は、常に詳細な本文を含めます。
- 変更の「What」「Why」「How」を説明します。
- 件名と本文を区切るために空行を使用します。
3. アトミックコミット
- 1 コミットにつき 1 スコープ: 異なるスコープに対しては別々のコミットを実行します。
- 選択的にステージングする: 現在のスコープに属するファイルのみをステージングします。
4. 実行フロー
- ステップ 1: ファイルをスコープごとにグループ化します。
- ステップ 2: 各グループについて:
- ファイルをステージングします。
- Conventional Commit メッセージ(件名 + 本文)を生成します。
- 実行します:
git commit -m "<subject>" -m "<body>"
- ステップ 3: 履歴を確認します(
git log -n 5)。
コメント
Markdown 対応