Git Commit スキル

変更差分を根拠に、適切な prefix を決定して高品質なコミットを作るためのスキルです。

このスキルで採用するprefix

• add: ユーザー価値が増える機能追加・仕様追加
• fix: バグ修正・不具合是正
• docs: ドキュメントのみ変更
• refactor: 振る舞いを変えない内部改善
• test: テスト追加・修正
• chore: 雑務的変更（設定、依存更新、軽微保守）
• perf: パフォーマンス改善
• build: ビルドシステムや依存解決の変更
• ci: CI/CD設定の変更
• revert: 既存コミットの取り消し
• style: フォーマットやlintのみ（意味的変更なし）

基本方針

• 1コミット1目的を守る
• コミット前に差分を確認する
• コミットメッセージは日本語で記述する
• prefix は「変更の主目的」で決める
• 迷う場合の優先順位は fix > add > refactor > chore

メッセージ形式

<prefix>: <summary>

<detail>
- <file path 1>
- <file path 2>

• summary は 30〜60 文字目安
• detail は 1〜3 行で要点のみ記載
• 修正ファイル名は本文に含めてよい（簡潔に列挙）

例:

add: 記事選定ロジックに重複除外ルールを追加

候補記事の重複判定を導入し、配信品質を安定化。
- src/newsletter/selector.py
- tests/test_selector.py

fix: タイムアウト時に再試行回数が増えない不具合を修正

リトライカウンタ更新条件の分岐漏れを修正。
- src/lambda/handler.py

```text` docs: ローカル実行手順と環境変数の説明を更新

READMEの手順を最新構成に合わせて整理。

• README.md

## 実行フロー

1. 変更確認

```bash
git status --short
git diff --staged
git diff

2. 変更の主目的を1文で定義

• 「何を直した/追加したか」ではなく「なぜ必要か」を明確化

3. prefix判定

• 判定表に従い最も影響の大きい変更を採用
• 複数目的が混在する場合はコミット分割を優先

4. ステージング整理

git add <file>
# または

git add -p

5. コミット実行

git commit -m "<prefix>: <summary>" -m "<detail>\n- <file path>"

prefix判定ルール（実務用）

• バグを直しているなら fix（新規機能を含んでも原則 fix）
• 新しい振る舞いを導入するなら add
• 外部仕様に影響せず内部構造のみ整理なら refactor
• テストだけなら test
• ドキュメントだけなら docs
• CI定義だけなら ci
• 依存解決・ビルド定義中心なら build
• 速度改善が主目的なら perf
• どれにも当てはまらない保守作業は chore

NG例

• update, misc, changes のような曖昧なsummary
• 無関係な変更を1コミットに混在
• fix なのに本文が「機能追加」中心
• 巨大コミットを分割せずにそのまま記録
• 詳細が長すぎて差分を読まないと要点が分からない本文

実行前チェックリスト

• 差分を確認した
• prefixの根拠を説明できる
• 1コミット1目的になっている
• summary と detail が重複せず簡潔
• 本文に主要な修正ファイル名を記載した
• テストまたは最低限の動作確認を実施した

クイックコマンド

このスキルを呼び出すコマンドprefixは以下を推奨:

/git-commit

実行例:

/git-commit 「変更差分を見て適切なprefixでコミットして」