Hooks案例

全面介绍Claude Code Hooks系统的核心概念、设计目的与工作原理，涵盖Hook的定义、before/after两种触发类型、Hook的配置方式（settings.json）、Hook的生命周期、Hooks与Skills/MCP/

系统学习Claude Code Hooks的配置方法，涵盖settings.json中hooks配置的完整语法、before_hook/after_hook的配置方式、Hook参数的传递（$EVENT_TYPE/$TOOL_NAME等）、H

深入讲解Claude Code的before和after两种Hook类型的核心机制，涵盖before Hook的执行时序（在事件前触发/可阻断后续执行）、after Hook的执行时序（在事件后触发/不可阻断）、Hook返回值与状态码处理、

深入解析Claude Code Hooks的触发时机和完整生命周期，涵盖所有支持的触发事件（user-prompt-submit/tool/before:tool/after:tool/after:user-prompt-submit等）、

全面学习Hook脚本的开发基础，涵盖Shell脚本开发技巧（bash/zsh）、Python脚本开发（读取环境变量/处理事件数据）、脚本输入输出处理（stdout/stderr/退出码）、环境变量使用指南（$EVENT_TYPE/$TOOL

全面学习如何创建和使用user-prompt-submit Hook，在用户提交提示词给Claude前/后执行自定义脚本，涵盖内容长度检查（超出令牌限制时提醒）、关键词过滤和替换、提示词增强（自动添加上下文/规则）、多轮对话的提示历史管理以

全面学习如何创建和使用before:tool Hook，在Claude调用工具前执行自定义验证和预处理，涵盖文件读写权限检查、命令执行审批、参数有效性验证、调用频率限制（Rate Limiting）、敏感操作确认提示以及不同工具的差异化前置

全面学习如何创建和使用after:tool Hook，在Claude调用工具后执行自定义处理，涵盖调用结果验证和记录、执行耗时监控和告警、错误调用自动重试、调用统计和趋势分析、调用审计日志生成以及不同工具的后置差异化处理策略。

全面学习如何创建和使用提示词注入检测Hook，保护Claude Code免受提示词注入攻击，涵盖常见注入模式检测（系统提示覆盖/角色扮演诱导/命令注入/越狱提示）、注入检测策略（正则/关键词/AI检测）、不同注入级别的响应策略、误报管理和调

全面学习如何创建和使用工具调用审批Hook，为高风险工具调用添加人工审批流程，涵盖工具分类和风险等级划分（高风险/中风险/低风险）、审批提示生成和用户确认请求、审批超时处理、审批历史记录和审计、以及基于上下文的自适应审批策略。

全面学习如何创建和使用敏感信息过滤Hook，保护敏感数据不被泄露到AI对话中，涵盖API Key/Token/密码检测、个人信息（PII）检测和脱敏、代码中的敏感配置过滤、Git提交中密钥泄露预防、以及多层过滤策略（前置过滤和后置审查）。

全面学习如何创建和使用代码质量预检Hook，在Claude Code修改代码前/后进行自动质量检查，涵盖语法错误检测（在保存前检查代码语法）、代码风格自动修正（运行formatter/linter）、编译错误预检（运行编译命令检查）、测试自

全面学习如何创建自动格式化Hook，在Claude Code编辑代码后自动统一代码风格，涵盖多语言格式化器支持（Prettier/Black/rustfmt/go fmt）、格式化配置自动检测、格式化前后差异对比、格式化失败的处理策略、以及

全面学习如何创建自动测试运行Hook，在Claude Code修改代码后自动运行测试验证正确性，涵盖测试框架自动检测（pytest/jest/unittest）、增量测试（只运行受影响测试）、测试超时控制、测试失败自动通知、测试报告生成和趋

全面学习如何创建自动提交消息生成Hook，在Git提交时自动生成规范化的commit message，涵盖Git diff自动获取和解析、Conventional Commits规范生成、变更类型检测（feat/fix/refactor/d

全面学习如何创建自动PR更新Hook，在代码提交后自动更新Pull Request信息，涵盖PR描述自动生成（从commit消息汇总）、PR标签自动分类（类型/优先级/模块）、PR Reviewers自动分配（根据文件修改历史）、PR Si

全面学习如何创建依赖检查Hook，在依赖文件变更时自动审计项目依赖，涵盖依赖变更自动检测、安全漏洞（CVE）扫描、过时依赖版本警告、许可证合规检查、传递依赖变化分析以及依赖变更影响的自动评估。

全面学习如何创建自动文档同步Hook，在代码变更后自动同步相关文档，涵盖API文档自动更新（从代码注解生成/更新）、README自动维护（功能列表/使用示例更新）、CHANGELOG自动更新、代码注释与文档一致性检查、以及文档变更的审查和确

全面学习如何创建构建部署触发Hook，在代码就绪时自动触发构建和部署流程，涵盖构建命令自动执行（编译/打包/镜像构建）、部署前检查清单验证（测试/审查/安全扫描）、多环境部署触发（开发/测试/生产）、部署状态回传和通知、以及部署失败自动回滚

全面学习如何创建Slack通知Hook，在Claude Code的关键事件发生后自动推送消息到Slack频道，涵盖构建/部署状态通知、代码审查请求推送、错误和告警通知、定时报告推送、以及消息格式定制（Block Kit/Rich Text）

全面学习如何创建邮件通知Hook，在Claude Code的特定事件后自动发送邮件通知，涵盖部署/构建状态邮件、代码审查请求邮件、定时报告邮件（周报/月报）、配置SMTP参数和使用mail/sendmail命令发送、邮件模板管理以及多收件人

全面学习如何创建Webhook回调Hook，在Claude Code事件发生后自动调用外部系统的Webhook接口，涵盖HTTP请求发送（curl/wget）、JSON/XML数据格式封装、认证方式（Bearer Token/Basic A

全面学习如何创建企业微信和钉钉通知Hook，在Claude Code事件发生后自动推送消息到企业微信或钉钉，涵盖机器人Webhook配置、消息类型（文本/Markdown/图文）、@指定成员通知、安全设置（密钥签名）、以及构建/部署/告警等

全面学习如何创建日志记录Hook，自动记录Claude Code的所有操作日志，涵盖工具调用日志（时间/工具/参数/结果）、用户提示日志（内容摘要/时间/会话ID）、日志文件格式（JSON/CSV/结构化文本）、日志轮转和归档（按大小/时间

全面学习如何创建审计追踪Hook，满足合规要求的操作审计记录，涵盖谁在什么时间做了什么操作、文件变更追踪（修改前/修改后对照）、不可篡改的审计日志（防篡改/数字签名）、审计报告自动生成、以及审计日志的存储和查询策略。

全面学习如何创建密钥扫描Hook，防止API Key和敏感信息通过Claude Code泄露，涵盖常见密钥模式检测（AWS/GitHub/SSH/数据库连接串）、Git提交中密钥扫描和阻止、文件写入时密钥检测、预提交Hook集成以及密钥扫描

全面学习如何创建安全策略执行Hook，在Claude Code中自动执行安全策略，涵盖命令执行白名单/黑名单、文件操作范围限制（仅允许在项目目录内操作）、网络请求限制（禁止访问内网/仅允许特定域名）、敏感配置保护（禁止修改安全配置文件）、以

全面学习如何创建合规检查Hook，在代码修改后自动验证合规要求，涵盖编码规范合规检查（PEP8/ESLint/Google Style）、许可证合规检查（依赖许可证/版权声明）、法律法规合规（GDPR/PCI-DSS相关代码模式检测）、合规

全面学习如何创建命令白名单Hook，对Claude Code可执行的Shell命令进行安全管控，涵盖白名单/黑名单配置、命令参数模式检测（阻止危险参数组合）、命令调用频率限制、命令执行超时控制、危险的Shell操作符检测（|/;/&&）、以

全面学习如何创建数据脱敏Hook，在数据发送给AI模型前自动脱敏处理，涵盖个人身份信息（PII）检测和脱敏、API Key/密码自动替换、IP地址和邮箱脱敏、自定义敏感数据模式配置、以及脱敏后的数据恢复策略。

全面学习如何创建访问控制Hook，对Claude Code的文件和命令操作进行精细化权限管控，涵盖文件访问控制（读/写/执行权限）、目录范围限制（仅允许项目目录）、命令执行权限分级（管理员/开发者/只读者）、基于Git分支的权限控制（mai

全面学习如何创建环境变量检查Hook，在Claude Code操作前验证运行环境的正确性，涵盖必需环境变量检查（PATH/HOME等）、项目特定环境变量验证（API_KEY/DB_URL等）、环境变量值格式校验、缺失环境变量的友好提示和自动

全面学习如何创建网络连通性检查Hook，在执行网络相关操作前验证网络连通性，涵盖ping/traceroute/nc等连通性测试工具使用、关键服务可达性检查（GitHub/npm/PyPI/docker hub等）、网络延迟检测和告警、DN

全面学习如何创建工具版本检查Hook，确保开发工具链满足项目要求，涵盖编程语言版本检查（node/python/java/go版本）、构建工具版本检查（npm/maven/gradle）、项目配置文件版本约束读取（engines字段/nvm

全面学习如何创建虚拟环境自动激活Hook，在Claude Code操作前自动激活正确的虚拟环境，涵盖Python虚拟环境检测（venv/conda/poetry/pdm）、Node.js环境自动切换（nvm/nodenv）、环境文件（.en

深入讲解多步骤复合Hook的设计和编排方法，涵盖多个Hook的串联执行模式、状态传递和数据共享、条件分支和循环编排、超时和错误恢复机制、以及实用复合Hook案例（提交前检查链/部署审批流程）。

全面学习如何创建条件执行Hook，根据特定条件决定是否执行Hook逻辑，涵盖文件变更条件（仅特定文件变更时触发）、分支条件（仅特定分支触发）、时间条件（仅在工作时间触发）、状态条件（仅成功/失败时触发）、以及复合条件组合（AND/OR/NO

全面学习如何编写跨平台兼容的Hook脚本，确保在Windows/macOS/Linux上都能正常工作，涵盖跨平台Shell差异（路径分隔符/换行符/环境变量）、条件判断检测当前平台、使用Node.js/Python实现跨平台兼容、不同She

全面学习如何在Hook之间共享状态和数据，涵盖临时文件存储（JSON/YAML/Key-Value）、环境变量传递机制、持久化存储（SQLite/Redis）、状态文件格式设计、共享状态的并发和冲突处理、以及状态清理和生命周期管理。

全面学习如何编排多个Hook实现复杂的自动化工作流，涵盖Hook链的设计模式（串行/并行/混合）、步骤依赖关系管理、数据传递和共享机制、错误传递和阻断策略、链的执行状态监控、以及完整的Hook链配置案例。

全面学习Hook的调试方法和日志技巧，快速定位和解决Hook问题，涵盖Hook执行日志查看、调试输出技巧（echo/printf/stderr）、常见Hook错误类型（退出码/超时/路径/权限）、Hook模拟测试工具、逐步调试方法以及错误通

全面学习Hook的性能优化方法，确保Hook执行不会显著影响Claude Code的响应速度，涵盖Hook执行耗时分析、缓存策略（结果缓存避免重复执行）、懒加载（按需执行而非每次都执行）、异步处理（后台执行不阻塞主流程）、以及性能基准测试和

全面总结Hook开发中的安全最佳实践，涵盖输入验证（防止命令注入/路径注入）、权限最小化（仅申请必要权限）、敏感信息保护（不在Hook中硬编码密钥）、沙箱执行（限制Hook可访问的资源）、Hook脚本的安全审查和审计、以及安全事件的应急响应

全面学习如何创建可复用的Hook模板，标准化团队Hook开发流程，涵盖Hook模板结构设计、参数化配置（允许不同项目定制行为）、常用Hook模板库（检查类/通知类/安全类）、Hook模板的版本管理和分发、以及在多项目间共享Hook模板的策略

全面学习Hook的错误处理策略，确保Hook失败时不会影响Claude Code的正常使用，涵盖错误分类和分级（可恢复/不可恢复）、优雅降级策略（Hook失败→跳过→继续执行）、错误重试机制（指数退避/最大重试次数）、错误通知和告警、以及错

全面学习Hook的测试方法和质量保障策略，涵盖单元测试（测试Hook脚本函数）、集成测试（测试Hook与Claude Code的交互）、模拟测试（模拟Hook触发事件和环境）、边界情况测试（超时/错误/异常输入）、以及自动化测试和CI集成。