Claude Code Hooks 深度实战：5 个真实案例教你用自动化消灭重复工作

# .claude/hooks/post-write.yaml

hooks:
  - name: "Hook 名称（描述性）"
    trigger: post_write          # 触发时机
    match: "*.ts,*.tsx"          # 匹配文件（支持 glob）
    command: "命令 {file}"        # 执行的命令（{file} 替换为实际文件路径）
    timeout: 30                  # 超时秒数（默认 30）
    on_error: "warn"             # 错误处理：warn | fail | ignore

# .claude/hooks/post-write.yaml

hooks:
  - name: "TypeScript 自动 lint"
    trigger: post_write
    match: "*.ts,*.tsx"
    command: "npx eslint --fix {file}"
    timeout: 15
    on_error: "warn"  # lint 失败只警告，不中断工作流

  - name: "自动格式化"
    trigger: post_write
    match: "*.ts,*.tsx,*.js,*.jsx,*.css,*.json"
    command: "npx prettier --write {file}"
    timeout: 10
    on_error: "warn"

# .claude/hooks/post-write.yaml

hooks:
  - name: "修改后自动运行相关测试"
    trigger: post_write
    match: "src/**/*.ts"
    # 把文件路径转换为测试文件路径
    command: |
      TEST_FILE=$(echo {file} | sed 's/src\//src\//;s/\.ts/.test.ts/')
      if [ -f "$TEST_FILE" ]; then
        npx vitest run "$TEST_FILE" --reporter=verbose
      fi
    timeout: 60
    on_error: "warn"

hooks:
  - name: "自动运行相关测试"
    trigger: post_write
    match: "src/**/*.ts"
    command: "npx jest --testPathPattern={file} --passWithNoTests"
    timeout: 60
    on_error: "warn"

# .claude/hooks/post-write.yaml

hooks:
  - name: "TypeScript 类型检查"
    trigger: post_write
    match: "src/**/*.ts,src/**/*.tsx"
    command: "npx tsc --noEmit --skipLibCheck 2>&1 | head -20"
    timeout: 30
    on_error: "warn"

# .claude/hooks/session-end.yaml

hooks:
  - name: "Session 结束全量类型检查"
    trigger: session_end
    command: "npx tsc --noEmit"
    timeout: 120
    on_error: "fail"  # 有类型错误时明确报告

# .claude/hooks/pre-commit.yaml

hooks:
  - name: "提交前安全扫描"
    trigger: pre_commit
    command: |
      # 检查常见敏感信息模式
      if git diff --cached | grep -E '(api_key|secret|password|token)\s*=\s*["\x27][^"\x27]{8,}'; then
        echo "⚠️  发现疑似敏感信息，请检查后再提交"
        exit 1
      fi
      echo "✓ 安全扫描通过"
    timeout: 10
    on_error: "fail"  # 发现问题时阻止提交

  - name: "提交前运行测试"
    trigger: pre_commit
    command: "npm run test:unit -- --passWithNoTests"
    timeout: 120
    on_error: "fail"

# .claude/hooks/session-start.yaml

hooks:
  - name: "加载工作状态"
    trigger: session_start
    command: |
      echo "=== 当前工作状态 ==="
      echo "分支: $(git branch --show-current)"
      echo ""
      echo "最近改动:"
      git log --oneline -5
      echo ""
      echo "未暂存文件:"
      git status --short
      echo ""
      if [ -f ".claude/session-notes.md" ]; then
        echo "=== 会话笔记 ==="
        cat .claude/session-notes.md
      fi
    timeout: 10
    on_error: "ignore"

# .claude/hooks/session-end.yaml

hooks:
  - name: "保存会话状态"
    trigger: session_end
    command: |
      cat > .claude/session-notes.md << EOF
      # 上次会话笔记（$(date '+%Y-%m-%d %H:%M')）
      
      分支: $(git branch --show-current)
      最后改动: $(git log --oneline -1)
      未提交文件: $(git status --short | head -5)
      EOF
    timeout: 10
    on_error: "ignore"

on_error: "warn"    # 命令失败 → 在 Claude Code 里显示警告，继续工作流
on_error: "fail"    # 命令失败 → 中断当前操作，让 Claude Code 知道出了问题
on_error: "ignore"  # 命令失败 → 静默忽略，继续（适合辅助性操作）