commit について
Git のコミット手順を整理する開発スキルです。変更を論理単位に分け、リポジトリ既存のメッセージ形式に合わせ、作業ツリーの状態を確認します。指定パスに範囲を限定でき、push は行いません。
主な機能
- 01変更を論理単位のコミットに分割
- 02直近のコミットメッセージ形式に準拠
- 03指定パスへのコミット範囲限定
- 04明示的なステージングと状態確認
- 05フック失敗後の新規コミット
活用シーン
- 01複数の変更内容を分けてコミット
- 02指定パス内の変更だけをコミット
- 03プロジェクトの形式に沿った短いメッセージ作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ helderberto/ agent-skills --skill commitインストール後、Claude Code で/commitを入力して読み込まれたか確認します。
詳細
Git コミット
ステージされていない変更と追跡対象外の変更を、独立したコミットにまとめます。論理的なまとまりごとに1つのコミットを作成します。1つのまとまりしかない場合は、コミットも1つです。プッシュは絶対にしないでください。プッシュは /hb:to-pr の役割です。
$ARGUMENTS のパスで実行対象を指定します。指定されたファイルだけをコミットし、ツリー内のその他の部分はそのままにします。
メッセージのスタイル
git log を確認し、リポジトリ既存のコミットパターンに合わせます。極めて簡潔にします。文法より短さを優先します。「何を」ではなく「なぜ」に焦点を当てます。命令形を使います。リポジトリで Conventional Commits(feat/fix/refactor/docs/chore + スコープ)を使っている場合は、それに従います。
ワークフロー
- 差分とステータスをすべて確認し、スタイルを把握するため最近のログを読みます。
- 論理的なまとまりを特定します。機能/修正、そのテスト、設定、整形のみ、ドキュメント、アセットなどです。
- まとまりごとに、対象ファイルを名前で明示してステージし、HEREDOC メッセージでコミットします。次のまとまりに進む前に
git statusを確認します。 - 作業ツリーをクリーンな状態にして終了します(対象を指定して実行した場合は、指定したすべてのファイルをコミットします)。ファイルのまとめ方が不明な場合は、質問してください。
グループ化のルール
- 整形のみの変更(空白、引用符、インデント)は、ロジックとは別のコミットにします。
- ロジックと整形の両方を変更したファイルは、ロジックのコミットに含めます。
- テストとテスト対象のコードは、同じコミットに含めてもかまいません。
- pre-commit フックが失敗した場合は、修正して再度ステージし、新しいコミットを作成します。
--amendは絶対に使わず、フックもスキップしないでください。
コメント
Markdown 対応