Commit Message 生成器
本ファイルは唯一の信頼できる情報源 (source of truth) です。各エージェント(Claude / opencode / codex)は、それぞれの薄い shim を介してこれを参照します。
フロー
git diff --stagedを実行し、ステージングされた変更を確認します。空の場合は「先にgit addしてください」と促して停止します。- 以下のルールに従ってメッセージを生成し、ユーザーに確認のために出力します。直接コミットしないでください。ユーザーが選択肢を必要とする場合は、単に質問するだけでなく、選択可能なメッセージを提示します。
- ユーザーが確認した場合(例:「コミット」「ok」)にのみ
git commit -mを実行します。ユーザーから明示的に指示がない限り、git pushは実行しないでください。
ルール
git diff --staged を読み、Conventional Commits に従って WHAT(何を)と WHY(なぜ)を明確にしたメッセージを生成します。
- タイトル
type(scope): 説明、全長 74 文字以内、末尾に句点は付けず、プレフィックス/引用符/コードブロックは一切付けません - type は最も適切なものを一つ選択:
feat新機能 ·fixバグ修正refactor外部動作を変更しないリファクタリング(新機能でもバグ修正でもない)·perfパフォーマンス最適化docsドキュメントのみ ·styleセマンティクスに影響しないフォーマット調整(空白/整形/セミコロン等)testテストの追加または修正 ·buildビルドシステムまたは外部依存関係の変更 ·ciCI 設定とスクリプトchoresrc/test に影響を与えないその他の雑務 ·revert以前のコミットの巻き戻し
- scope(任意)影響を受けるモジュール名。このリポジトリの規約に従って選択します。monorepo の場合は app/package ディレクトリ名を使用。複数にまたがる場合や判断が難しい場合は省略します
- 説明は必ず日本語で記述: 一言で「何をしたか」を動詞句で明確に記述します。「いくつかのファイルを修正」「今回のコミット」「この修正」などの空疎な表現は避けます。識別子(関数/ファイル/パッケージ名)は英語のままにします
- 1行のみ: いかなる場合でもコミットメッセージはタイトルのみの1行とし、本文/footer は記述しません。必要な WHY はこの1行に収めます
- Breaking change:
type(scope)!: 説明のように!でマークし、1行を維持します。BREAKING CHANGEfooter は使用しません - 句読点: 英語の半角句読点を使用し、全角の
,。:()は使用しません
生成戦略
書き始める前に「この変更の集合が解決する問題 / 主軸は何か」を明確にしてから、上記のフォーマットに従って記述します:
- 主軸を捉える: このコミットを理解するために必要な情報だけを書き、ファイル名/関数名/設定名を並べないでください(それ自体が鍵となる場合を除く)。
- 顕著な変更をスキャンする: ロジック、契約、ビルド、品質ゲート、ユーザーに見える動作の変更があるかどうかを確認し、それに基づいて適切な type を選択し、
!で breaking change を示すかどうかを判断します。
内容の規律(WHAT はどこから来るか)
以上はフォーマットです。以下は内容の信頼性に関するものです。メッセージは確認されたコードの事実のみを述べ、意図を推測したり、ドキュメントから想像したりしないでください:
src/testの動作変更を主とする: docs は補助的な背景としてのみ使用し、docs から WHAT を推測してはいけません(ドキュメントはコードより先行/遅延することがよくあります)。- 会話コンテキストはドキュメントより優先: 直近のユーザープロンプトで明示された目標は、WHY を決定したり、より適切な表現を選択するために使用できます(例:「フルチェック/タイプチェックを修正」)。ただし WHAT/scope は staging diff を基準とします。コンテキストで言及されているが diff に反映されていないものはメッセージに書かず、両者に矛盾がある場合は diff を優先し、確認を促します。
- 削除/リネーム系 diff: コードの呼び出し関係から目的が確認できない場合は、客観的に事実のみを述べます(
X を削除/X を Y に名称変更)。「代替/移行/変更」などの強い因果関係は記述しません。 - 複数の変更点が同一目標に属する場合(例:1回のコード品質/ビルド修正)→ 1つの要約メッセージを直接提示します。分割は、レビュー/ロールバックを著しく改善できる場合に限り、オプションの提案として後付けし、デフォルトでは妨げません。
- 明らかに複数の独立した機能/修正目標が混在する場合 → 一度に全てを提示します:各ユニットの分割メッセージ + 1つの保守的な要約メッセージ。ユーザーが分割か要約かを直接選択できるようにし、要約を次のターンに回さないでください。WHAT 全体を客観的に要約できない場合のみ、ユニットを列挙し、無理にまとめないでください。
- 帰属や意図が不明確な変更が混入している場合(並行して混入しており、なぜ変更されたかわからない)→ 「これらのファイルは帰属/意図の確認が必要です」 と出力し、無理にメッセージを作成しないでください。不確かな場合、「整理」「調整」などのあいまいな言葉は控え、優先的にユーザーに確認または分割を依頼してください。