blog.dopana

戻る

プロジェクト開発において、コミット前にコードの品質やドキュメントの書式を担保することは重要です。サードパーティの重いツールを導入しなくても、Git ネイティブの Git Hooks と core.hooksPath を利用することで、ゼロ依存の自動検証パイプラインを構築できます。

対象ありなし対象ありなし対象ありなし構文エラーあり正常開発者が git commit -m '...' を実行.githooks/pre-commit が起動1. ステージ済み Markdown を確認(.md, .mdx)agent-md format を実行変更を git add2. ステージ済みソースコードを確認(.ts, .tsx, .astro...)bun lint (ESLint) を実行変更を git add3. ステージ済みドキュメント・図を確認bun lint:mermaid (maid) を実行コミット完了 ✅コミット中断 ❌エラー修正が必要

なぜ Husky ではなく Git Native Hook なのか?#

Git Native Hook (core.hooksPath)Husky を使う場合npm パッケージのインストールが必要node_modules の肥大化外部 Node.js ラッパーへの依存.githooks/ 配下のシェルスクリプト1つ依存関係ゼロ (ZeroDependencies)リポジトリ内でチーム共有可能
比較項目Husky / 外部ライブラリGit Native Hook (core.hooksPath)
依存関係npm パッケージの追加が必要ゼロ依存
実行速度Node ラッパーの起動オーバーヘッド即時実行されるシェルスクリプト (<10ms)
チーム共有可能可能(Git 管理下)

Pre-commit スクリプトの実装#

.githooks/pre-commit に以下の内容を記述します:

ロジックのポイント#

1. git diff --cached によるステージングファイルの絞り込み#

Git Index(ステージング領域)git diff --cached --name-only--diff-filter=dgrep -E '\\.(拡張子)$'対象ファイル一覧
  • --cached: git add されたステージング対象のみを抽出します。
  • --diff-filter=d: 削除されたファイルを除外し、存在しないファイルへのアクセスエラーを防ぎます。
  • set -e: エラー発生時にスクリプトを即時停止し、不正な状態でのコミットを防ぎます。

2. フォーマット後の自動ステージング#

agent-md や eslint --fix でコードが自動修正された場合、git add "$file" で修正内容をそのまま今回のコミットに自動反映します。

プロジェクトへの自動適用設定#

package.json に prepare スクリプトを追加します:

{
  "scripts": {
    "prepare": "git config core.hooksPath .githooks",
    "lint": "eslint --fix 'src/**/*.{js,ts,jsx,tsx,astro}'",
    "lint:mermaid": "maid docs/ src/"
  }
}
json

実行権限を付与:

chmod +x .githooks/pre-commit
bun run prepare
bash

まとめ#

シンプルなシェルスクリプトを1つ用意するだけで:

  • Markdown ドキュメントの自動整形
  • ソースコードの Lint チェック
  • Mermaid 図の構文検証

をコミット時に完全自動化できます。

参考文献#