用途
Hooks Automation 是一套面向 Claude Code 的智能钩子(hooks)自动化系统,目标是在开发操作前后自动完成协调、校验、格式化和学习。它通过接入 MCP 工具与神经模式训练,自动管理开发操作、协调群体(swarm)智能体、维护会话状态,并持续从编码模式中积累经验。
主要能力
- 操作前钩子(Pre-Operation Hooks):在校验、准备和自动分配智能体之后才执行操作。
pre-edit:文件修改前校验并分配智能体,支持按文件类型自动分配、语法预校验、冲突检测、自动备份。pre-bash:命令安全检查、资源占用估算、危险命令确认、权限检查。pre-task:根据任务分析自动生成智能体、加载历史记忆、优化群体拓扑、估算复杂度与时间。pre-search:缓存检查、查询优化、搜索模式改进。
- 操作后钩子(Post-Operation Hooks):在操作完成后处理和学习。
post-edit:按语言自动格式化(Prettier、Black、gofmt)、将编辑上下文存入记忆、训练神经模式、用 lint 校验输出。post-bash:记录命令执行、跟踪性能指标、存储结果、检测错误模式。post-task:统计执行时间与 token 消耗、记录决策、导出学习模式、生成完成报告。post-search:缓存结果、改进搜索模式、相关性评分。
- MCP 集成钩子:
mcp-initialized持久化群体配置、agent-spawned更新智能体名册、task-orchestrated监控任务进度、neural-trained保存模式改进并在智能体间共享。 - 记忆协调钩子:
memory-write、memory-read、memory-sync,用于校验记忆键格式、更新跨智能体索引、记录访问模式、在群体智能体间同步记忆并解决冲突。 - 会话钩子:
session-start、session-restore、session-end、notify,用于创建会话目录、加载上下文、恢复记忆与智能体配置、保存状态、导出指标、生成总结、清理临时文件,以及向协调系统广播通知。
使用方式
- 前置要求:安装 Claude Flow CLI(
npm install -g claude-flow@alpha);使用启用了钩子的 Claude Code;准备.claude/settings.json钩子配置。可选:配置 MCP 服务器(claude-flow、ruv-swarm、flow-nexus)、Git 仓库、测试框架。 - 初始化:运行
npx claude-flow init --hooks,生成预配置钩子的.claude/settings.json、.claude/commands/hooks/下的钩子命令文档以及常见操作的默认钩子处理器。 - 调用钩子:例如
npx claude-flow hook pre-task --description "Implement authentication"npx claude-flow hook post-edit --file "src/auth.js" --memory-key "auth/login"npx claude-flow hook session-end --session-id "dev-session" --export-metrics
- 配置:在
.claude/settings.json中通过PreToolUse、PostToolUse、SessionStart、SessionEnd等匹配器绑定钩子命令,可设置timeout、continueOnError、async、debug等选项。文档还给出受保护文件模式(check-protected)和文件修改后自动运行测试的配置示例。
适用场景
- 在 Claude Code 中实现编辑前后自动校验、格式化与备份;
- 对 Bash 命令做安全检查和资源估算;
- 多智能体(swarm)协作时同步记忆、分配智能体、跟踪任务进度;
- 跨会话保留上下文与决策记录,生成会话总结与指标;
- 在 Git 提交前做质量验证;
- 通过神经模式训练从成功编码模式中持续学习。
限制
资料未提供收费、价格、平台支持范围、性能数据或效果承诺等信息。使用效果依赖 Claude Flow CLI、Claude Code 钩子配置及可选 MCP 服务器的正确安装与配置。