Inceptarium

CommitGuard

概要

CommitGuardはローカルのgitフックとして動作する小さな開発ツールで、オンデバイスのAIでコミットメッセージや簡単なコードコメント、PR説明をリアルタイムに校正します。すべてオフラインで処理するため、プライバシーを重視するエンジニアがコードを外部に送ることなく即時かつ文脈に沿った提案を受けられます。CLIに親和性があり、既存ワークフローに簡単に組み込めます。

解決する課題

開発者は時間に追われて、曖昧なコミットメッセージやコメントを残しがちです。クラウドの校正サービスは遅いことがあり、ネットワークやプライバシーの問題で使用しにくい場合があります。ローカルで素早く、プライベートにフィードバックを得たいというニーズがあります。

解決策

CommitGuardはプリコミットフックとして導入され、オンデバイスのモデルでコミット内容を校正し、範囲の明確化、付け漏れのチェック項目、チケットIDの形式などを提案します。オフラインで動作し、bash/zsh/fishに対応、CI無効化フラグを用意。小規模チームが運用・カスタム設定を管理できるように設計しています。

ユーザーストーリー

夕方6時、バックエンドエンジニアのマヤはホットフィックスを出そうとしていた。git add .、git commit -m "fix stuff"と入力すると、ターミナルに短いレビューが出た。「CommitGuard: 範囲を明確に — 'fix cache miss in session handler'に変更を推奨 — [a]ccept [e]dit [s]kip」。マヤはeを押し、エディタが開いて提案メッセージとマイグレーション注記のワンラインチェックリストが表示される。メッセージを直してコミット、プッシュするとレビュー担当が「コミットメッセージでデバッグが楽になった」とコメント。マヤはリポジトリの内容が自分のマシンを出なかったことを安心材料にし、ツールが150msで動作してCIを阻害しなかった点を気に入る。昼休みに本番ブランチ用にチケットID必須のプリセットを微調整した。ツールはリポジトリの単一ファイルで済み、チーム内でプライベートに共有している。

パースペクティブ: Turning collection into insight

作成日時: 2025/11/23 11:20:43