Hooksでワークフローを自動化する

#!/bin/bash
# .claude/hooks/pre-commit-check.sh
#
# git commitの直前にlintとテストを実行し、失敗時はコミットをブロックする
 
command=$(jq -r '.tool_input.command // empty')
 
# git commit を含むコマンドのときだけチェックする
if [[ "$command" != *"git commit"* ]]; then
  exit 0
fi
 
# lintを実行
if ! npm run lint --silent > /tmp/lint-result.log 2>&1; then
  reason=$(tail -n 20 /tmp/lint-result.log)
  jq -n --arg reason "lintエラーのためコミットを中止しました:\n${reason}" '{
    hookSpecificOutput: {
      hookEventName: "PreToolUse",
      permissionDecision: "deny",
      permissionDecisionReason: $reason
    }
  }'
  exit 0
fi
 
# テストを実行
if ! npm test --silent > /tmp/test-result.log 2>&1; then
  reason=$(tail -n 20 /tmp/test-result.log)
  jq -n --arg reason "テスト失敗のためコミットを中止しました:\n${reason}" '{
    hookSpecificOutput: {
      hookEventName: "PreToolUse",
      permissionDecision: "deny",
      permissionDecisionReason: $reason
    }
  }'
  exit 0
fi
 
exit 0

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-commit-check.sh",
            "timeout": 120
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx",
            "args": ["prettier", "--write", "${tool_input.file_path}"],
            "timeout": 10
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/notify-on-stop.sh
#
# 応答完了時にSlackへ通知を送る
 
# stdinからセッション情報を受け取る（必要なら活用する）
input=$(cat)
session_id=$(echo "$input" | jq -r '.session_id')
 
# Slack Webhook URLは環境変数で管理し、ハードコードしない
if [ -z "$SLACK_WEBHOOK_URL" ]; then
  exit 0
fi
 
curl -s -X POST "$SLACK_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d "{\"text\": \"Claude Codeのタスクが完了しました (session: ${session_id})\"}" \
  > /dev/null
 
exit 0

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/notify-on-stop.sh",
            "timeout": 10,
            "async": true
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(*prod*)",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/confirm-prod-operation.sh",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/confirm-prod-operation.sh
#
# "prod"という文字列を含むコマンドの実行を一律でブロックし、
# 人間による確認を促す
 
command=$(jq -r '.tool_input.command // empty')
 
jq -n --arg cmd "$command" '{
  hookSpecificOutput: {
    hookEventName: "PreToolUse",
    permissionDecision: "ask",
    permissionDecisionReason: ("本番環境に関連するコマンドです。内容を確認してください: " + $cmd)
  }
}'
exit 0

#!/bin/bash
# .claude/hooks/format-if-src.sh
 
file_path=$(jq -r '.tool_input.file_path // empty')
 
# src/ 配下のファイルのみフォーマットする
if [[ "$file_path" == */src/* ]]; then
  npx prettier --write "$file_path"
fi
 
exit 0

flowchart TD
    A["ファイル編集"] -->|"PostToolUse: Edit/Write"| B["自動フォーマット"]
    B --> C["git commit実行を指示"]
    C -->|"PreToolUse: Bash(git commit)"| D{"lint/test<br/>パス?"}
    D -->|No| E["コミットをブロック"]
    D -->|Yes| F["コミット実行"]
    F -->|"PostToolUse: Bash(git commit)"| G["コミット内容をログに記録"]
    G --> H["応答完了"]
    H -->|"Stop"| I["Slack通知"]
 
    style B fill:#e8f4fd,stroke:#1a73e8
    style E fill:#fde8e8,stroke:#c0392b
    style I fill:#fff3e0,stroke:#e65100

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx",
            "args": ["prettier", "--write", "${tool_input.file_path}"],
            "timeout": 10
          }
        ]
      },
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(git commit *)",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/log-commit.sh",
            "timeout": 10
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(git commit *)",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-commit-check.sh",
            "timeout": 120
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/notify-on-stop.sh",
            "timeout": 10,
            "async": true
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "if": "Bash(git push --force*)",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/confirm-force-push.sh",
            "timeout": 10
          }
        ]
      }
    ]
  }
}