Claude-Flow 昨天发布了 v2.0.0 Alpha,这标志着 AI 驱动开发编排领域的革命性飞跃,Claude code 搭配Claude-Flow食用,你就超越了 80% 的牛马! 什么?你看不懂它的 readme ?那么今天就让我把它的 readme 翻译成人话。
介绍部分我就不复制粘贴了,英文不好的朋友直接看下图
📋 环境要求
⚠️ 重要提示:需先安装 Claude Code:
# 1. Install Claude Code globally
npm install -g @anthropic-ai/claude-code
# 2. Activate Claude Code with permissions
claude --dangerously-skip-permissions
接下来我会逐行介绍 readme 中的命令
🚀 模式一:单一功能开发
1. npx claude-flow@alpha init --force
-
作用:初始化工作目录,生成运行所需的基础结构和配置。包括
.claude/或.hive-mind/等文件夹,以及模板文档如CLAUDE.md、memory-bank.md、coordination.md。 -
参数:
@alpha:指定使用 alpha 版本。--force:如果目标位置已有文件,会强制覆盖(覆盖已有配置)。- 可选
--minimal/-m:仅生成最小配置,而不包含模板文档。
2. npx claude-flow@alpha hive-mind spawn "Implement user authentication" --claude
-
作用:在 Hive‑Mind 模式下启动一个“蜂巢”式多 agent 会话,并创建会话以实现“Implement user authentication”这个任务。
-
参数:
"Implement user authentication":这是轻量任务或会话名称/描述。--claude:显式告诉系统要用 Claude AI 实例来作为 agent 而非默认模式(可能启用额外工具权限)。- 常见可选参数还包括
--namespace(指定命名空间),--agents <types>(指定 agent 类型,如 researcher, implementer 等),--temp(临时会话)等。
👩🔬
researcherAgent:研究员角色职责:
- 分析任务要求、背景上下文。
- 查找资料、提出解决方案思路。
- 提取相关上下文记忆或从 prompt 中生成规范。
- 为 implementer 提供明确的技术或架构建议。
适用场景:
- 用户任务不明确,需“澄清需求”或进行问题拆解。
- 新项目启动,尚无明确设计方案。
- 扩展原有系统,需预调研。
3.
npx claude-flow@alpha hive-mind status
- 作用:查看当前活跃的 hive‑mind 会话状态信息。
- 功能:会显示当前会话信息:Session ID、Agent 列表及状态、活跃任务数等
4.
npx claude-flow@alpha memory query "authentication" --recent
作用:查询 memory 数据库,搜索包含关键词
authentication的条目。参数:
--recent:只返回最近(默认时间范围内)的匹配记录,通常是与当前会话或任务相关的最新记忆。- 还有其他过滤参数如
--namespace,--since,--until,--limit,--format等。- 示例输出:
Based on the memory and your request to support password reset, here are three implementation strategies...
👩💻
implementerAgent:执行者角色职责:
- 将 researcher 提出的方案转换为实际代码或技术实现。
- 完成指定代码模块、API 接口、测试用例等。
- 直接操作源代码或生成代码 diff。
适用场景:
需求明确,进入开发阶段。
用户希望生成具体代码或文档内容。
辅助生成 Pull Request、修复 bug。
5.
npx claude-flow@alpha swarm "Add password reset functionality" --continue-session
作用:在 Swarm 模式中继续最近的会话,添加新任务“Add password reset functionality”。
Swarm vs Hive-Mind 模式差异:
- Swarm:轻量、一次性任务,会话临时存在,适合快速、高频任务GitHub+4GitHub+4GitHub+4。
- Hive‑Mind:多任务、持久化、有状态,会储存上下文,可在之后继续使用。
参数:
"Add password reset functionality":当前任务描述。
--continue-session:表示复用已存在的 swarm 会话(上一步同一 hive 或 swarm),而不是启动新会话示例输出:
export async function sendPasswordResetEmail(userEmail: string): Promise<void> { // implementation here }
🔧 参数用法
你可以在命令中通过 --agents 参数显式指定要使用的 agent 类型:
npx claude-flow hive-mind spawn "Add email verification" --agents researcher implementer
🧩 多 agent 工作流示意
User Input: "Add email verification"
│
▼
researcher (生成思路与方案)
│
▼
implementer (编写代码 + 测试)
如果需要更多 agent(如 reviewer、tester 等),也可以扩展,例如:
--agents researcher implementer reviewer
🧩 工作流程总结
以上命令形成一个典型的开发流程:
- 初始化项目环境:
init --force创建配置与存储结构。 - 开启会话:用
hive-mind spawn进入多 Agent 持久化模式。 - 查看会话状态:
hive-mind status获取当前 hive 信息。 - 查询当前记忆:
memory query检索相关上下文记忆。 - 继续开发任务:
swarm ... --continue-session增加子任务,复用上下文并自动调度 agent
🔧 参数总结表
| 命令 | 参数 | 含义 |
|---|---|---|
init | --force | 强制覆盖已有文件 |
hive-mind spawn | "task desc" | 会话/任务描述 |
--claude | 使用 CLAUDE AI 实例 | |
hive-mind status | — | 查看当前 hive‑mind 状态 |
memory query | "text" | 查询相关内容 |
--recent | 仅获取最近记忆 | |
swarm | "task desc" | 子任务描述 |
--continue-session | 复用当前会话上下文 |