kairyou/agent-tooling

Codex、Claude Code、opencode 向けの再利用可能なエージェントスキル、フック、ステータスラインツール、インストールヘルパー。

agent-tooling とは?

このスキルは、Claude Code、Codex、opencode などの AI エージェントが Git コミットメッセージを自動生成するための統一ルールとフローを提供します。`git diff --staged` から変更内容を分析し、Conventional Commits 形式に従った日本語のタイトル行のみのコミットメッセージを生成します。ユーザー確認後にのみコミットを実行する安全な設計で、モノレポ対応のスコープ指定やブレイキングチェンジの自動検出も行います。staged diff を唯一の情報源とし、コードの意図を推測せず、実際の変更のみを客観的に記述することを重視しています。

対応✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add kairyou/agent-tooling

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Commit Message 生成器

本ファイルは唯一の信頼できる情報源 (source of truth) です。各エージェント(Claude / opencode / codex)は、それぞれの薄い shim を介してこれを参照します。

フロー

  1. git diff --staged を実行し、ステージングされた変更を確認します。空の場合は「先に git add してください」と促して停止します。
  2. 以下のルールに従ってメッセージを生成し、ユーザーに確認のために出力します。直接コミットしないでください。ユーザーが選択肢を必要とする場合は、単に質問するだけでなく、選択可能なメッセージを提示します。
  3. ユーザーが確認した場合(例:「コミット」「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 ビルドシステムまたは外部依存関係の変更 · ci CI 設定とスクリプト
    • chore src/test に影響を与えないその他の雑務 · revert 以前のコミットの巻き戻し
  • scope(任意)影響を受けるモジュール名。このリポジトリの規約に従って選択します。monorepo の場合は app/package ディレクトリ名を使用。複数にまたがる場合や判断が難しい場合は省略します
  • 説明は必ず日本語で記述: 一言で「何をしたか」を動詞句で明確に記述します。「いくつかのファイルを修正」「今回のコミット」「この修正」などの空疎な表現は避けます。識別子(関数/ファイル/パッケージ名)は英語のままにします
  • 1行のみ: いかなる場合でもコミットメッセージはタイトルのみの1行とし、本文/footer は記述しません。必要な WHY はこの1行に収めます
  • Breaking change: type(scope)!: 説明 のように ! でマークし、1行を維持します。BREAKING CHANGE footer は使用しません
  • 句読点: 英語の半角句読点を使用し、全角の ,。:() は使用しません

生成戦略

書き始める前に「この変更の集合が解決する問題 / 主軸は何か」を明確にしてから、上記のフォーマットに従って記述します:

  • 主軸を捉える: このコミットを理解するために必要な情報だけを書き、ファイル名/関数名/設定名を並べないでください(それ自体が鍵となる場合を除く)。
  • 顕著な変更をスキャンする: ロジック、契約、ビルド、品質ゲート、ユーザーに見える動作の変更があるかどうかを確認し、それに基づいて適切な type を選択し、! で breaking change を示すかどうかを判断します。

内容の規律(WHAT はどこから来るか)

以上はフォーマットです。以下は内容の信頼性に関するものです。メッセージは確認されたコードの事実のみを述べ、意図を推測したり、ドキュメントから想像したりしないでください:

  • src/test の動作変更を主とする: docs は補助的な背景としてのみ使用し、docs から WHAT を推測してはいけません(ドキュメントはコードより先行/遅延することがよくあります)。
  • 会話コンテキストはドキュメントより優先: 直近のユーザープロンプトで明示された目標は、WHY を決定したり、より適切な表現を選択するために使用できます(例:「フルチェック/タイプチェックを修正」)。ただし WHAT/scope は staging diff を基準とします。コンテキストで言及されているが diff に反映されていないものはメッセージに書かず、両者に矛盾がある場合は diff を優先し、確認を促します。
  • 削除/リネーム系 diff: コードの呼び出し関係から目的が確認できない場合は、客観的に事実のみを述べます(X を削除 / X を Y に名称変更)。「代替/移行/変更」などの強い因果関係は記述しません。
  • 複数の変更点が同一目標に属する場合(例:1回のコード品質/ビルド修正)→ 1つの要約メッセージを直接提示します。分割は、レビュー/ロールバックを著しく改善できる場合に限り、オプションの提案として後付けし、デフォルトでは妨げません。
  • 明らかに複数の独立した機能/修正目標が混在する場合 → 一度に全てを提示します:各ユニットの分割メッセージ + 1つの保守的な要約メッセージ。ユーザーが分割か要約かを直接選択できるようにし、要約を次のターンに回さないでください。WHAT 全体を客観的に要約できない場合のみ、ユニットを列挙し、無理にまとめないでください。
  • 帰属や意図が不明確な変更が混入している場合(並行して混入しており、なぜ変更されたかわからない)→ 「これらのファイルは帰属/意図の確認が必要です」 と出力し、無理にメッセージを作成しないでください。不確かな場合、「整理」「調整」などのあいまいな言葉は控え、優先的にユーザーに確認または分割を依頼してください。

関連スキル