gh_mirrors/cl/claude-code-flow文档大全：从入门到高级功能全指南-优快云博客

gh_mirrors/cl/claude-code-flow文档大全：从入门到高级功能全指南

【免费下载链接】claude-code-flow This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles. 项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-flow

🌟 概述

Claude-Flow v2.7 是企业级AI编排平台，结合蜂群智能（hive-mind swarm intelligence）、持久化内存（persistent memory） 和100+高级MCP工具，彻底革新AI驱动的开发工作流。作为代码优先的编排层，它使Claude能够在递归智能体周期中自主编写、编辑、测试和优化代码。

核心特性

25个Claude技能：用于开发、GitHub、内存和自动化的自然语言激活技能
ReasoningBank内存：具有语义搜索功能的持久化SQLite存储（2-3ms延迟）
语义搜索（Semantic Search）：基于哈希的嵌入技术，无需API密钥即可工作
蜂群智能（Hive-Mind Intelligence）：由女王智能体领导的AI协作，配有专门的工作智能体
100个MCP工具：用于蜂群编排和自动化的综合工具包
动态智能体架构（Dynamic Agent Architecture, DAA）：具有容错能力的自组织智能体
持久化内存：.swarm/memory.db 包含30+种专门模式
高级钩子系统：具有操作前后钩子的自动化工作流
GitHub集成：6种专门的仓库管理模式
Flow Nexus Cloud：E2B沙箱、AI蜂群、挑战和市场

⚡ 快速入门

先决条件

Node.js 18+（推荐LTS版本）
npm 9+ 或同等包管理器
Windows用户：参见Windows安装指南获取特殊说明

⚠️ 重要：必须先安装Claude Code：

# 1. 全局安装Claude Code
npm install -g @anthropic-ai/claude-code

# 2.（可选）跳过权限检查以加快设置
claude --dangerously-skip-permissions

安装最新Alpha版本

# NPX（推荐 - 始终获取最新版本）
npx claude-flow@alpha init --force
npx claude-flow@alpha --help

# 或全局安装
npm install -g claude-flow@alpha
claude-flow --version
# v2.7.0-alpha.10

🎨 技能系统

Claude-Flow包含25种专门技能，可通过自然语言自动激活 - 无需记忆命令：

# 只需描述您想要的内容 - 技能会自动激活
"Let's pair program on this feature"        → 结对编程技能
"Review this PR for security issues"       → GitHub代码审查技能
"Use vector search to find similar code"   → agentdb-vector-search技能
"Create a swarm to build this API"         → 蜂群编排技能

技能类别

开发与方法学（3种）- SPARC、结对编程、技能构建器
智能与内存（6种）- AgentDB集成，性能提升150x-12,500x
蜂群协调（3种）- 多智能体编排和蜂群思维
GitHub集成（5种）- PR审查、工作流、发布、多仓库
自动化与质量（4种）- 钩子、验证、性能分析
Flow Nexus平台（3种）- 云沙箱和神经训练

📚 完整技能教程 - 包含使用示例的完整指南

从斜线命令到技能的转变

之前，claude-flow使用存储在.claude/commands/中的斜线命令：

# 旧方法
/.claude/commands/sparc-tdd.md
/.claude/commands/github-review.md
/.claude/commands/swarm-init.md

当输入/sparc-tdd时，Claude会加载该markdown文件作为提示并执行。这种方式虽然有效，但存在局限性：

发现的问题：

命令每次都加载，即使不需要（上下文污染）
缺乏元数据用于发现 - Claude无法判断命令何时相关
扁平结构 - 所有命令混合在一起
需要手动调用 - 无法自动激活
可组合性有限 - 命令不能很好地协同工作

新的技能系统解决了这些问题，具有：

自动发现：Claude在启动时扫描技能，读取元数据，仅在相关时加载完整内容
渐进式披露：技能使用分层结构（概述→详细信息→高级），保持上下文清洁
可组合性：技能可以引用其他技能，无需用户干预
组织性：技能按类别目录组织（development/、github/、memory/等）
标准化：符合Anthropic设计，适用于Claude.ai、Claude Code CLI等

🧠 内存系统命令

ReasoningBank（持久化SQLite内存）

# 使用语义搜索存储内存
npx claude-flow@alpha memory store api_key "REST API配置" \
  --namespace backend --reasoningbank

# 使用语义搜索查询（2-3ms延迟）
npx claude-flow@alpha memory query "API配置" \
  --namespace backend --reasoningbank
# ✅ 在2ms内找到3个结果（语义搜索）

# 列出所有内存
npx claude-flow@alpha memory list --namespace backend --reasoningbank

# 检查状态和统计信息
npx claude-flow@alpha memory status --reasoningbank
# ✅ 总内存数：30
#    嵌入向量：30
#    存储位置：.swarm/memory.db

特性

✅ 无需API密钥：基于哈希的嵌入（1024维度）
✅ 持久化存储：SQLite数据库在重启后保留
✅ 语义搜索：带相似度评分的MMR排序
✅ 命名空间隔离：按域组织内存
✅ 快速查询：平均延迟2-3ms
✅ 进程清理：自动数据库关闭

可选：增强嵌入

# 为获得更好的语义准确性（需要API密钥）
export OPENAI_API_KEY=$YOUR_API_KEY
# 使用text-embedding-3-small（1536维度）

🐝 蜂群编排

快速蜂群命令

# 快速任务执行（推荐）
npx claude-flow@alpha swarm "构建带身份验证的REST API" --claude

# 多智能体协调
npx claude-flow@alpha swarm init --topology mesh --max-agents 5
npx claude-flow@alpha swarm spawn researcher "分析API模式"
npx claude-flow@alpha swarm spawn coder "实现端点"
npx claude-flow@alpha swarm status

复杂项目的Hive-Mind

# 初始化hive-mind系统
npx claude-flow@alpha hive-mind wizard
npx claude-flow@alpha hive-mind spawn "构建企业系统" --claude

# 会话管理
npx claude-flow@alpha hive-mind status
npx claude-flow@alpha hive-mind resume session-xxxxx

蜂群与Hive-Mind的比较：

特性	`swarm`	`hive-mind`
最佳用途	快速任务	复杂项目
设置	即时	交互式向导
内存	任务范围	项目级SQLite
会话	临时	持久化+恢复

🔧 MCP工具集成

设置MCP服务器

# 添加Claude Flow MCP服务器（必需）
claude mcp add claude-flow npx claude-flow@alpha mcp start

# 可选：增强协调
claude mcp add ruv-swarm npx ruv-swarm mcp start

# 可选：云功能（需要注册）
claude mcp add flow-nexus npx flow-nexus@latest mcp start

可用MCP工具（共100种）

核心工具：

swarm_init、agent_spawn、task_orchestrate
memory_usage、memory_search
neural_status、neural_train、neural_patterns

内存工具：

mcp__claude-flow__memory_usage - 存储/检索持久化内存
mcp__claude-flow__memory_search - 基于模式的搜索

GitHub工具：

github_repo_analyze、github_pr_manage、github_issue_track

性能工具：

benchmark_run、performance_report、bottleneck_analyze

🪝 高级钩子系统

Claude-Flow自动配置钩子以增强操作：

# 在初始化期间自动配置钩子
npx claude-flow@alpha init --force

可用钩子

操作前：

pre-task：按复杂度自动分配智能体
pre-edit：验证文件并准备资源
pre-command：安全验证

操作后：

post-edit：自动格式化代码
post-task：训练神经模式
post-command：更新内存

会话管理：

session-start：恢复先前上下文
session-end：生成摘要
session-restore：加载内存

🎯 常见工作流

模式1：单一功能开发

# 每个功能初始化一次
npx claude-flow@alpha init --force
npx claude-flow@alpha hive-mind spawn "实现身份验证" --claude

# 继续相同功能（重用hive）
npx claude-flow@alpha memory query "auth" --recent
npx claude-flow@alpha swarm "添加密码重置" --continue-session

模式2：多功能项目

# 项目初始化
npx claude-flow@alpha init --force --project-name "my-app"

# 功能1：身份验证
npx claude-flow@alpha hive-mind spawn "auth-system" --namespace auth --claude

# 功能2：用户管理
npx claude-flow@alpha hive-mind spawn "user-mgmt" --namespace users --claude

模式3：研究与分析

# 开始研究会话
npx claude-flow@alpha hive-mind spawn "研究微服务" \
  --agents researcher,analyst --claude

# 检查所学知识
npx claude-flow@alpha memory stats
npx claude-flow@alpha memory query "微服务模式" --reasoningbank

📊 性能与统计

84.8% SWE-Bench解决率 - 行业领先的问题解决能力
32.3%令牌减少 - 高效的上下文管理
2.8-4.4x速度提升 - 并行协调
2-3ms查询延迟 - ReasoningBank语义搜索
64个专业智能体 - 完整的开发生态系统
100个MCP工具 - 全面的自动化工具包

📚 文档资源

核心文档

技能教程 - 25个Claude Flow技能的完整指南，包含自然语言调用示例
安装指南 - 设置说明
内存系统指南 - ReasoningBank使用方法
MCP工具参考 - 完整工具目录
智能体系统 - 所有64个智能体

发布说明

v2.7.0-alpha.10 - 语义搜索修复
v2.7.0-alpha.9 - 进程清理
变更日志 - 完整版本历史

高级主题

神经模块 - SAFLA自学习
目标模块 - GOAP智能规划
蜂群思维 - 女王领导的协调
GitHub集成 - 仓库自动化

🔄 版本更新

v2.7.0-alpha.10中的新功能

语义搜索修复

语义搜索返回0结果的关键错误修复：

✅ 修复了过时的编译代码（dist-cjs/现在使用Node.js后端）
✅ 修复了retrieveMemories()扁平结构的结果映射
✅ 修复了参数不匹配（命名空间vs域）
✅ 2-3ms查询延迟与哈希嵌入
✅ 无需API密钥即可工作（确定性1024维嵌入）

ReasoningBank集成（agentic-flow@1.5.13）

Node.js后端：用SQLite + better-sqlite3替换WASM
持久化存储：所有内存保存到.swarm/memory.db
语义搜索：带四因素评分的MMR排序
数据库表：patterns、embeddings、trajectories、links
性能：2ms查询，每个模式400KB含嵌入

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考