SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场hooks automation

hooks automation

编程与开发

查看项目

更新于 10-16 14:35

技能介绍

用途

Hooks Automation 是一个智能自动化系统，用于协调、验证并从 Claude Code 的操作中学习。它通过集成 MCP 工具和神经网络模式训练的 hooks 实现，能够自动管理开发操作、协调 swarm 智能体、维护会话状态，并持续从编码模式中学习，支持自动化智能体分配、代码格式化、性能追踪和跨会话记忆持久化。

主要能力

  • 操作前 hooks（Pre-Operation Hooks）：在操作前进行验证、准备并自动分配智能体。
  • 操作后 hooks（Post-Operation Hooks）：在操作后进行格式化、分析并训练模式。
  • 会话管理：持久化状态、恢复上下文、生成摘要。
  • 记忆协调：在 swarm 智能体之间同步知识。
  • Git 集成：带质量校验的自动提交 hooks。
  • 神经网络训练：从成功模式中持续学习。
  • MCP 集成：与 swarm 工具无缝协调。

前置条件

必需：

  • 已安装 Claude Flow CLI（npm install -g claude-flow@alpha）
  • 启用 hooks 的 Claude Code
  • 带有 hook 配置的 .claude/settings.json

可选：

  • 已配置的 MCP 服务器（claude-flow、ruv-swarm、flow-nexus）
  • 用于版本控制的 Git 仓库
  • 用于质量验证的测试框架

使用方式

快速开始

初始化 hooks 系统（创建带预配置 hooks 的 .claude/settings.json、hook 命令文档及默认 hook 处理器）：

npx claude-flow init --hooks

基础 hook 用法：

# Pre-task hook（自动生成智能体）
npx claude-flow hook pre-task --description "Implement authentication"

# Post-edit hook（自动格式化并存入记忆）
npx claude-flow hook post-edit --file "src/auth.js" --memory-key "auth/login"

# Session end hook（保存状态与指标）
npx claude-flow hook session-end --session-id "dev-session" --export-metrics

可用 Hooks

操作前 Hooks（在操作前执行，用于准备和验证）：

  • pre-edit：在文件修改前验证并分配智能体。选项包括 --file/-f、--auto-assign-agent（默认 true）、--validate-syntax、--check-conflicts、--backup-file。特性：按文件类型自动分配智能体、语法验证、并发编辑冲突检测、自动文件备份。
  • pre-bash：检查命令安全性和资源需求。选项包括 --command/-c、--check-safety（默认 true）、--estimate-resources、--require-confirmation。特性：命令安全验证、资源需求估算、破坏性命令确认、权限检查。
  • pre-task：自动生成智能体并准备复杂任务。选项包括 --description/-d、--auto-spawn-agents（默认 true）、--load-memory、--optimize-topology、--estimate-complexity。特性：基于任务分析自动生成智能体、加载记忆保持上下文连续、拓扑优化、复杂度估算和时间预测。
  • pre-search：准备并优化搜索操作。选项包括 --query/-q、--check-cache（默认 true）、--optimize-query。特性：缓存检查、查询优化、搜索模式改进。

操作后 Hooks（在操作后执行，用于处理和学​​习）：

  • post-edit：自动格式化、验证并更新记忆。选项包括 --file/-f、--auto-format（默认 true）、--memory-key/-m、--train-patterns、--validate-output。特性：特定语言自动格式化（Prettier、Black、gofmt）、记忆存储编辑上下文与决策、神经网络模式训练、带 linting 的输出验证。
  • post-bash：记录执行并更新指标。选项包括 --command/-c、--log-output（默认 true）、--update-metrics、--store-result。特性：命令执行日志、性能指标追踪、结果存储、错误模式检测。
  • post-task：性能分析与决策存储。选项包括 --task-id/-t、--analyze-performance（默认 true）、--store-decisions、--export-learnings、--generate-report。特性：执行时间和 token 用量测量、决策记录、神经网络学习模式导出、完成报告生成。
  • post-search：缓存结果并改进模式。选项包括 --query/-q、--results/-r、--cache-results（默认 true）、--train-patterns。特性：结果缓存、搜索模式改进、相关性评分。

MCP 集成 Hooks

与 MCP swarm 工具协调的 hooks：

  • mcp-initialized：持久化 swarm 配置（保存拓扑与配置、存储智能体名册、初始化协调命名空间）。用法：npx claude-flow hook mcp-initialized --swarm-id <id>
  • agent-spawned：更新智能体名册与记忆。用法：npx claude-flow hook agent-spawned --agent-id <id> --type <type>
  • task-orchestrated：监控任务进度。用法：npx claude-flow hook task-orchestrated --task-id <id>
  • neural-trained：保存模式改进。用法：npx claude-flow hook neural-trained --pattern <name>

记忆协调 Hooks

  • memory-write：智能体写入协调记忆时触发（验证键格式、更新跨智能体索引、触发依赖 hooks、通知订阅智能体）。
  • memory-read：智能体读取协调记忆时触发（记录访问模式、更新热度指标、预加载相关数据、追踪使用统计）。
  • memory-sync：在 swarm 智能体间同步记忆。用法：npx claude-flow hook memory-sync --namespace <ns>

会话 Hooks

  • session-start：初始化新会话。选项包括 --session-id/-s、--load-context、--init-agents。用法：npx claude-flow hook session-start --session-id <id>
  • session-restore：加载先前的会话状态。选项包括 --session-id/-s、--restore-memory（默认 true）、--restore-agents。用法：npx claude-flow hook session-restore --session-id "swarm-20241019"
  • session-end：清理并持久化会话状态。选项包括 --session-id/-s、--save-state（默认 true）、--export-metrics、--generate-summary、--cleanup-temp。用法：npx claude-flow hook session-end --session-id "dev-session-2024"
  • notify：带 swarm 状态的自定义通知。选项包括 --message/-m、--level（info|warning|error）、--swarm-status（默认 true）、--broadcast。用法：npx claude-flow hook notify -m "Task completed" --level info

配置

基础配置：编辑 .claude/settings.json 配置 hooks，例如在 PreToolUse 中匹配 ^(Write|Edit|MultiEdit)$ 执行 pre-edit，在 PostToolUse 中匹配写入操作执行 post-edit 等。

高级配置：可设置 enabled、debug、timeout 等全局项，并为 PreToolUse、PostToolUse、SessionStart、SessionEnd 分别配置 matcher 与 hooks 命令，支持 timeout、continueOnError、async 等参数。

受保护文件模式：通过 check-protected hook 对敏感文件添加保护。

自动测试：在文件修改后自动运行测试，例如匹配 ^Write 后执行对应测试文件。

适用场景

适用于在 Claude Code 中进行自动化开发流程的场景，包括：自动格式化与质量校验代码、多智能体（swarm）协同开发、跨会话记忆与上下文恢复、命令安全验证、持续学习编码模式等。

限制

资料未提供具体的平台兼容性范围、性能上限、收费信息或已知限制。使用前需满足前置条件（安装 Claude Flow CLI、启用 hooks、配置 settings.json）。