Claude Code Hook 食譜：每次編輯後自動格式化＋lint（PostToolUse）

# 目標：Claude Code 每次編輯檔案後，自動格式化＋lint
# 放到 .claude/settings.json（專案層級）或 ~/.claude/settings.json（全域）。
# 機制：PostToolUse hook 在 Edit / Write / MultiEdit 完成「之後」觸發，
#       hook 從 stdin 收到 JSON，裡面 tool_input.file_path 是剛被改的檔案。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "bash {{PROJECT_DIR}}/.claude/hooks/format-after-edit.sh"
          }
        ]
      }
    ]
  }
}

# ---- .claude/hooks/format-after-edit.sh ----
# chmod +x 後使用。依副檔名挑工具，找不到工具就安靜跳過（不要讓 hook 把流程弄爆）。
#!/usr/bin/env bash
set -euo pipefail

# 從 stdin 的 JSON 取出剛被編輯的檔案路徑
file=$(jq -r '.tool_input.file_path // empty')
[ -z "$file" ] && exit 0
[ ! -f "$file" ] && exit 0

case "$file" in
  *.ts|*.tsx|*.js|*.jsx|*.mjs|*.json|*.css|*.md)
    # JS/TS 系：先 format 再 lint --fix（工具不存在就略過）
    command -v {{PRETTIER_CMD}} >/dev/null 2>&1 && {{PRETTIER_CMD}} --write "$file" >/dev/null 2>&1 || true
    command -v {{ESLINT_CMD}}  >/dev/null 2>&1 && {{ESLINT_CMD}}  --fix "$file" >/dev/null 2>&1 || true
    ;;
  *.py)
    command -v {{PY_FORMATTER}} >/dev/null 2>&1 && {{PY_FORMATTER}} "$file" >/dev/null 2>&1 || true   # 例：black / ruff format
    command -v ruff >/dev/null 2>&1 && ruff check --fix "$file" >/dev/null 2>&1 || true
    ;;
  *.go)
    command -v gofmt >/dev/null 2>&1 && gofmt -w "$file" >/dev/null 2>&1 || true
    ;;
  *.rs)
    command -v rustfmt >/dev/null 2>&1 && rustfmt "$file" >/dev/null 2>&1 || true
    ;;
esac
exit 0
# 注意：PostToolUse 在工具已執行「之後」才跑，無法阻止編輯；
# 它的用途是「事後自動修好」，不是「事前攔截」。要攔截請用 PreToolUse。

把方括號 [ ] 內的變數換成你的內容，丟進 Claude Code。

# 目標：Claude Code 每次編輯檔案後，自動格式化＋lint
# 放到 .claude/settings.json（專案層級）或 ~/.claude/settings.json（全域）。
# 機制：PostToolUse hook 在 Edit / Write / MultiEdit 完成「之後」觸發，
#       hook 從 stdin 收到 JSON，裡面 tool_input.file_path 是剛被改的檔案。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "bash {{PROJECT_DIR}}/.claude/hooks/format-after-edit.sh"
          }
        ]
      }
    ]
  }
}

# ---- .claude/hooks/format-after-edit.sh ----
# chmod +x 後使用。依副檔名挑工具，找不到工具就安靜跳過（不要讓 hook 把流程弄爆）。
#!/usr/bin/env bash
set -euo pipefail

# 從 stdin 的 JSON 取出剛被編輯的檔案路徑
file=$(jq -r '.tool_input.file_path // empty')
[ -z "$file" ] && exit 0
[ ! -f "$file" ] && exit 0

case "$file" in
  *.ts|*.tsx|*.js|*.jsx|*.mjs|*.json|*.css|*.md)
    # JS/TS 系：先 format 再 lint --fix（工具不存在就略過）
    command -v {{PRETTIER_CMD}} >/dev/null 2>&1 && {{PRETTIER_CMD}} --write "$file" >/dev/null 2>&1 || true
    command -v {{ESLINT_CMD}}  >/dev/null 2>&1 && {{ESLINT_CMD}}  --fix "$file" >/dev/null 2>&1 || true
    ;;
  *.py)
    command -v {{PY_FORMATTER}} >/dev/null 2>&1 && {{PY_FORMATTER}} "$file" >/dev/null 2>&1 || true   # 例：black / ruff format
    command -v ruff >/dev/null 2>&1 && ruff check --fix "$file" >/dev/null 2>&1 || true
    ;;
  *.go)
    command -v gofmt >/dev/null 2>&1 && gofmt -w "$file" >/dev/null 2>&1 || true
    ;;
  *.rs)
    command -v rustfmt >/dev/null 2>&1 && rustfmt "$file" >/dev/null 2>&1 || true
    ;;
esac
exit 0
# 注意：PostToolUse 在工具已執行「之後」才跑，無法阻止編輯；
# 它的用途是「事後自動修好」，不是「事前攔截」。要攔截請用 PreToolUse。