用 Hooks 自动化检查

使用 Claude Code 进行软件开发

Dani Zysman

AI Curriculum Manager @ DataCamp

手动的痛点

recraft: half: 一位开发者坐在桌前,疲惫地反复手动运行同一条命令

  • 当 Claude 执行特定动作时触发 hooks
  • 自动运行:适合可重复任务
  • hooks 可防止流程中跳步
使用 Claude Code 进行软件开发

什么是 Hooks?

  • 工具:
    • 读/写文件
    • 运行命令
  • Hooks:

    • 用户自定义的 shell 命令,自动运行
    • 配置于 .claude/settings.json
    • 把它当作 Claude Code 的 "if this, then that"

    使用 /hooks 列出当前激活项

使用 Claude Code 进行软件开发

当前项目结构

music-analytics-api/
  app.py
  routes.py
  test_routes.py    
  CLAUDE.md
  .claude/
    agents/
    skills/
    settings.json    # <- Hook configuration
使用 Claude Code 进行软件开发

Hook 类型与流程

Hook 工作流图

PreToolUse:在工具运行前触发 → 用于检查或拦截危险操作

PostToolUse:在工具完成后触发 → 用于运行测试、代码规范检查或记录结果

使用 Claude Code 进行软件开发

配置一个 Hook

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "cd $CLAUDE_PROJECT_DIR && python -m pytest --tb=short -q"
          }
        ]
      }
    ]
  }
}
使用 Claude Code 进行软件开发

捕获 Hook 输出

def pytest_terminal_summary(terminalreporter, exitstatus, config):
    passed = len(terminalreporter.stats.get('passed', []))
    failed = len(terminalreporter.stats.get('failed', []))

    if failed:
        title = "pytest FAILED"
        message = f"{failed} failed {passed} passed"
    else:
        title = "pytest PASSED"
        message = f"All {passed} tests passed!"

    with open("/tmp/pytest_results.log", "a") as f:
        f.write(f"{title}: {message}\n")
使用 Claude Code 进行软件开发

Hook 输出日志

[23:07:35] pytest FAILED: ❌; 2 failed, 15 passed

[23:07:38] pytest PASSED: ✅ All 17 tests passed!

[23:08:09] pytest PASSED: ✅ All 17 tests passed!

[23:08:12] pytest PASSED: ✅ All 17 tests passed!

使用 Claude Code 进行软件开发

何时使用 Hooks

何时使用 hooks 的决策流程图

  • 适用场景:
    • 文件编辑后的测试
    • 代码规范检查
    • 安全拦截
使用 Claude Code 进行软件开发

第 2 章小结

功能 调用 列表 配置路径
Agents @agent-name /agents .claude/agents/name.md
Skills /skill-name /skills .claude/skills/name/SKILL.md
Hooks (自动) /hooks .claude/settings.json
使用 Claude Code 进行软件开发

让我们一起练习吧!

使用 Claude Code 进行软件开发

Preparing Video For Download...