用途:为 Claude Code 生成可直接使用的 hooks,实现编辑后自动格式化、自动 git 暂存、代理完成后跑测试、会话开始时加载上下文等自动化。
主要能力:三种生成模式——交互模式(python3 hook_factory.py -i,7 问引导)、自然语言模式(python3 hook_factory.py -r "auto-format Python files after editing")、模板模式(python3 hook_factory.py -t post_tool_use_format -l python)。内置 10 个模板,覆盖 PostToolUse、SubagentStop、SessionStart、PreToolUse、UserPromptSubmit、Stop、PrePush 七类事件,支持 Python、JavaScript、TypeScript、Rust、Go。生成结果包含 hook.json 与 README.md,并经过结构、安全、匹配器、事件专属四层校验,含密钥检测与命令校验。
使用方式:生成后可用 installer.py 或 install-hook.sh 安装到用户级或项目级设置,支持备份、回滚与列表查看;也可手动复制 hook.json 到 .claude/settings.json。
适用场景:代码格式化、git 自动暂存、测试运行、上下文加载、桌面通知、安全扫描等。
限制:仅支持 macOS/Linux,不支持 Windows;仅 CLI,无 GUI;交互模式深度定制有限;自定义模板需手动加入 templates.json,暂不支持模板组合。依赖 Python 3.7+,仅用标准库。