diegosouzapw 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
- 変更の主目的を1文で定義
- 「何を直した/追加したか」ではなく「なぜ必要か」を明確化
- prefix判定
- 判定表に従い最も影響の大きい変更を採用
- 複数目的が混在する場合はコミット分割を優先
- ステージング整理
git add <file>
# または
git add -p
- コミット実行
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でコミットして」