name	.claude/skills/commit-hooks/SKILL.md
description	Git commit hooksとプレコミット品質ゲートの専門知識。 Husky、lint-staged統合による自動lint/format実行を設計します。 📚 リソース参照: このスキルには以下のリソースが含まれています。必要に応じて該当するリソースを参照してください: - `.claude/skills/commit-hooks/resources/husky-configuration.md`: Huskyによるコミットフック設定 - `.claude/skills/commit-hooks/resources/lint-staged-patterns.md`: lint-stagedパターンと設定例 - `.claude/skills/commit-hooks/resources/performance-optimization.md`: コミットフックのパフォーマンス最適化 - `.claude/skills/commit-hooks/templates/pre-commit-basic.sh`: 基本的なpre-commitフックシェルスクリプト - `.claude/skills/commit-hooks/templates/lint-staged-advanced.js`: 高度なlint-staged設定 - `.claude/skills/commit-hooks/scripts/test-hooks.mjs`: コミットフックテストスクリプト使用タイミング: - コミット時の自動品質チェックを設定する時 - Husky、lint-stagedを導入する時 - ステージングファイルのみを処理する設定を行う時 - pre-commit、commit-msg、pre-pushフックを設計する時 - コミットフローの自動化を計画する時
version	1.0.0

Commit Hooks Skill

概要

このスキルは、Linus Torvalds（Git作者）のGit Hooksコンセプトを、品質自動化に応用したコミットフック設定を支援します。

Husky設定

1. インストールと初期化

pnpm add -D husky
pnpm exec husky init

2. フックファイル作成

pre-commit (.husky/pre-commit):

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

pnpm lint-staged

commit-msg (.husky/commit-msg):

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

pnpm commitlint --edit $1

pre-push (.husky/pre-push):

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

pnpm test

3. 実行権限

chmod +x .husky/pre-commit
chmod +x .husky/commit-msg
chmod +x .husky/pre-push

lint-staged設定

基本設定

package.json:

{
  "lint-staged": {
    "*.{ts,tsx,js,jsx}": ["eslint --fix", "prettier --write"],
    "*.{json,md,yml,yaml}": ["prettier --write"]
  }
}

高度な設定

関数形式 (.lintstagedrc.js):

module.exports = {
  "*.{ts,tsx}": (filenames) => [
    `eslint --fix ${filenames.join(" ")}`,
    `prettier --write ${filenames.join(" ")}`,
    `vitest related --run ${filenames.join(" ")}`, // 関連テスト実行
  ],
  "*.{json,md}": (filenames) => [`prettier --write ${filenames.join(" ")}`],
};

フックタイプ別戦略

pre-commit

目的: コード品質保証

実行内容:

lint実行（eslint --fix）
format実行（prettier --write）
型チェック（tsc --noEmit）オプション

パフォーマンス考慮:

ステージングファイルのみ処理
並列実行活用
キャッシュ活用

commit-msg

目的: コミットメッセージ規約強制

ツール: commitlint

設定例:

{
  "extends": ["@commitlint/config-conventional"],
  "rules": {
    "type-enum": [
      2,
      "always",
      [
        "feat",
        "fix",
        "docs",
        "style",
        "refactor",
        "test",
        "chore",
        "perf",
        "ci"
      ]
    ]
  }
}

pre-push

目的: テスト実行、ビルド検証

実行内容:

全テスト実行
ビルド成功確認
カバレッジ閾値チェック

パフォーマンス最適化

1. 並列実行

lint-stagedデフォルト: 並列実行

カスタマイズ:

{
  concurrent: true,  // 並列実行有効
  chunkSize: 10      // ファイルチャンクサイズ
}

2. 対象ファイル制限

glob pattern活用:

{
  "lint-staged": {
    "src/**/*.{ts,tsx}": ["eslint --fix"], // src配下のみ
    "!**/*.test.ts": ["eslint --fix"] // テスト除外
  }
}

3. ESLintキャッシュ

eslint --cache --fix

統合フロー

git add
  ↓
pre-commit hook
  ↓
lint-staged
  ├─ ESLint --fix
  ├─ Prettier --write
  └─ 型チェック（オプション）
  ↓
成功? → commit続行
失敗? → commit中止、エラー表示

トラブルシューティング

フック実行されない

# Huskyインストール確認
ls -la .husky

# Git hooksパス確認
git config core.hooksPath

パフォーマンス問題

キャッシュ有効化
対象ファイル絞り込み
並列実行確認

詳細リソース

# Husky設定ガイド
cat .claude/skills/commit-hooks/resources/husky-configuration.md

# lint-stagedパターン
cat .claude/skills/commit-hooks/resources/lint-staged-patterns.md

# パフォーマンス最適化
cat .claude/skills/commit-hooks/resources/performance-optimization.md

テンプレート

# 基本pre-commitフック
cat .claude/skills/commit-hooks/templates/pre-commit-basic.sh

# 高度なlint-staged設定
cat .claude/skills/commit-hooks/templates/lint-staged-advanced.js

スクリプト

# コミットフック動作テスト
node .claude/skills/commit-hooks/scripts/test-hooks.mjs

参考文献

Husky公式ドキュメント: https://typicode.github.io/husky/
lint-staged: https://github.com/okonet/lint-staged
『Pro Git』 Scott Chacon著

.claude/skills/commit-hooks/SKILL.md

Install Skill

SKILL.md