PostToolUse Hooks 設定スキル Skill

PostToolUse Hooks 設定スキル

プロジェクトごとに適切なPostToolUseフックを .claude/settings.json に設定する。

前提条件チェック（必須）

設定前に必ず以下を確認すること：

1. フォーマッタ・リンターの検出

プロジェクトルートで以下を確認し、存在するツールだけをフックに追加する。

| ツール | 検出方法 | |--------|---------| | prettier | package.json の devDependencies、または .prettierrc* の存在 | | eslint | package.json の devDependencies、または eslint.config.* / .eslintrc* の存在 | | biome | package.json の devDependencies、または biome.json の存在 | | ruff | pyproject.toml の [tool.ruff]、または ruff.toml の存在 | | black | pyproject.toml の [tool.black] | | gofmt | go.mod の存在 |

2. 既存設定の確認

.claude/settings.json が既に存在する場合は、既存の設定を壊さないようにマージする。

設定テンプレート

JavaScript/TypeScript プロジェクト（prettier）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

JavaScript/TypeScript プロジェクト（eslint + prettier）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx eslint --fix \"$CLAUDE_FILE_PATH\" 2>/dev/null; npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

JavaScript/TypeScript プロジェクト（biome）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx biome check --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

Python プロジェクト（ruff）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "ruff format \"$CLAUDE_FILE_PATH\" 2>/dev/null; ruff check --fix \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

Python プロジェクト（black）

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "black \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

Go プロジェクト

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "gofmt -w \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

ワークフロー

プロジェクトルートの package.json、pyproject.toml、go.mod 等を読み取る
使用しているフォーマッタ・リンターを特定する
適切なテンプレートを選択する
.claude/settings.json に書き込む（既存設定があればマージ）
設定内容をユーザーに報告する

注意事項

検出できたツールだけを設定する。推測で追加しない
2>/dev/null || true を必ず付けて、エラーでClaudeの作業が止まらないようにする
既存の .claude/settings.json の他の設定（permissions等）を消さない

Agent Skills: PostToolUse Hooks 設定スキル

Install this agent skill to your local

Skill Files