Git Pre-commit Hook — Stagedファイルの自動Lint&Format
Husky不要の軽量Gitフック構築:ステージされたファイルのMarkdown自動フォーマット、コードLint、Mermaid構文チェック。
プロジェクト開発において、コミット前にコードの品質やドキュメントの書式を担保することは重要です。サードパーティの重いツールを導入しなくても、Git ネイティブの Git Hooks と core.hooksPath を利用することで、ゼロ依存の自動検証パイプラインを構築できます。
なぜ Husky ではなく Git Native Hook なのか?#
| 比較項目 | Husky / 外部ライブラリ | Git Native Hook (core.hooksPath) |
|---|---|---|
| 依存関係 | npm パッケージの追加が必要 | ゼロ依存 |
| 実行速度 | Node ラッパーの起動オーバーヘッド | 即時実行されるシェルスクリプト (<10ms) |
| チーム共有 | 可能 | 可能(Git 管理下) |
Pre-commit スクリプトの実装#
.githooks/pre-commit に以下の内容を記述します:
#!/usr/bin/env bash
set -e
# 1. Format staged markdown files with agent-md if available
if command -v agent-md >/dev/null 2>&1; then
STAGED_MD_FILES=$(git diff --cached --name-only --diff-filter=d | grep -E '\.(md|mdx)$' || true)
if [ -n "$STAGED_MD_FILES" ]; then
echo "[git-hook] Running agent-md format on staged markdown files..."
for file in $STAGED_MD_FILES; do
if [ -f "$file" ]; then
agent-md "$file"
git add "$file"
fi
done
fi
fi
# 2. Lint changed code files with bun lint
STAGED_CODE_FILES=$(git diff --cached --name-only --diff-filter=d | grep -E '\.(js|jsx|ts|tsx|astro)$' || true)
if [ -n "$STAGED_CODE_FILES" ]; then
echo "[git-hook] Running bun lint on staged code files..."
bun lint
for file in $STAGED_CODE_FILES; do
if [ -f "$file" ]; then
git add "$file"
fi
done
fi
# 3. Lint mermaid diagrams with bun lint:mermaid
STAGED_DOC_FILES=$(git diff --cached --name-only --diff-filter=d | grep -E '\.(md|mdx|html|astro)$' || true)
if [ -n "$STAGED_DOC_FILES" ]; then
echo "[git-hook] Running bun lint:mermaid on diagrams..."
bun lint:mermaid
fibashロジックのポイント#
1. git diff --cached によるステージングファイルの絞り込み#
--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 preparebashまとめ#
シンプルなシェルスクリプトを1つ用意するだけで:
- Markdown ドキュメントの自動整形
- ソースコードの Lint チェック
- Mermaid 図の構文検証
をコミット時に完全自動化できます。