SuperAPI AI 工具集

hooks automation

编程与开发

查看项目

更新于 11-10 16:24

技能介绍

用途

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,用于创建会话目录、加载上下文、恢复记忆与智能体配置、保存状态、导出指标、生成总结、清理临时文件,以及向协调系统广播通知。

使用方式

  1. 前置要求:安装 Claude Flow CLI(npm install -g claude-flow@alpha);使用启用了钩子的 Claude Code;准备 .claude/settings.json 钩子配置。可选:配置 MCP 服务器(claude-flow、ruv-swarm、flow-nexus)、Git 仓库、测试框架。
  2. 初始化:运行 npx claude-flow init --hooks,生成预配置钩子的 .claude/settings.json、.claude/commands/hooks/ 下的钩子命令文档以及常见操作的默认钩子处理器。
  3. 调用钩子:例如
    • 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
  4. 配置:在 .claude/settings.json 中通过 PreToolUse、PostToolUse、SessionStart、SessionEnd 等匹配器绑定钩子命令,可设置 timeout、continueOnError、async、debug 等选项。文档还给出受保护文件模式(check-protected)和文件修改后自动运行测试的配置示例。

适用场景

  • 在 Claude Code 中实现编辑前后自动校验、格式化与备份;
  • 对 Bash 命令做安全检查和资源估算;
  • 多智能体(swarm)协作时同步记忆、分配智能体、跟踪任务进度;
  • 跨会话保留上下文与决策记录,生成会话总结与指标;
  • 在 Git 提交前做质量验证;
  • 通过神经模式训练从成功编码模式中持续学习。

限制

资料未提供收费、价格、平台支持范围、性能数据或效果承诺等信息。使用效果依赖 Claude Flow CLI、Claude Code 钩子配置及可选 MCP 服务器的正确安装与配置。