SwarmForge：AI 智能体协同编程框架，让多个 Agent 在隔离工作区并行协作

一个协调 AI 智能体的框架：每个 Agent 在独立的 git worktree 和 tmux session 中运行，通过持久化交接协议交换已提交的工作，操作员通过本地仪表板监督、审批和干预。
📦 项目源码备份下载（夸克网盘）

完整项目已同步备份到夸克网盘，永久有效、无需提取码 ：

👉 https://pan.quark.cn/s/a7f943c63eb2

项目简介

SwarmForge （unclebob/swarm-forge）是 Uncle Bob（Robert C. Martin）开源的一款AI 智能体协同编程框架 。它的定位非常直接：让多个 AI Agent 在隔离的 git worktree 和 tmux session 中并行工作，通过持久化的交接协议（handoff protocol）交换已提交的工作，操作员通过本地仪表板监督整个过程。

它瞄准的是现有工具的痛点：大多数 AI 编程工具（Cursor、Claude Code 等）都只有一个 Agent 在操作，无法并行处理多个任务；而多 Agent 框架又往往缺乏有效的协调机制和人工监督能力。SwarmForge 从架构层面解决了这个问题------每个 Agent 有自己独立的工作区、自己的提交历史、自己的职责边界，通过标准化的 handoff 协议交接工作，操作员可以随时介入审批、回答澄清、或中止整个 swarm。

为什么选 SwarmForge

🤖 多 Agent 并行协作：支持两个、四个、六个甚至更多 Agent 同时工作，每个在独立的 git worktree 中。
📦 持久化交接协议 ：Agent 通过 swarm_handoff.sh 发送工作、通过 ready_for_next.sh 接收、通过 done_with_current.sh 完成------所有交接都有审计日志。
👁️ 本地仪表板监督 ：操作员通过 pack_board.* 和 pack_dashboard.html 实时监控 Agent 状态、审批门控、澄清请求。
🔧 灵活的 Agent 后端：支持 Claude、Codex、Grok、Copilot 等多种 AI 后端，可混合使用。
📚 可配置的角色体系 ：通过 swarmforge.conf 配置角色（coder、cleaner、refactorer、architect 等）和运行模式。
🏗️ 两种部署模式：Pack 模式（安装到现有项目）和 Forge 模式（多项目管理）。

核心特性

Pack 产品系列

SwarmForge 提供多种预配置的 Pack，每种对应不同的 Agent 协作模式：

Pack	分支	角色链
two-pack	`two-pack`	`specifier` → `coder`
four-pack	`four-pack`	`specifier` → `coder` → `refactorer` → `architect`
six-pack	`six-pack`	六个独立角色：spec、impl、cleanup、arch、hardening、QA
project-manager	`project-manager`	多项目 forge，可切换两/四/六 Pack 模板 + 主机中尉
lieutenant	`lieutenant`	多项目 forge，一个可配置项目模板 + 规划中尉

Forge 模式

Forge 安装到空目录，运行 ./swarm 启动主机仪表板和中尉（lieutenant）；操作者在 projects/ 下创建或打开项目时，项目 swarm 自动启动。

Constitution 系统

SwarmForge 使用基于文件的 Constitution（宪法）系统：

共享规则 （main 分支）：engineering.prompt、workflow.prompt、handoffs.prompt------定义工程规范、工作区纪律、交接协议。
本地扩展 （Pack 分支）：project.prompt、local-engineering.prompt 等------为特定 Pack 定制规则。
角色提示 （roles/ 目录）：每个角色有专属的 .prompt 文件，定义其职责边界、验证要求、交接目标。

运行时架构

复制代码

swarmforge.sh / swarmforge.bb  → 解析配置、创建工作区、启动 Agent
swarm_handoff.* / ready_for_next.* → 持久化交接创建、接收、合并、审计
handoffd.* → 投递排队交接、通知接收会话
pack_board.* / pack_web.* → 持久化和呈现卡片、审批、澄清、Agent 窗格
forge.* → 在 Forge 产品中创建、打开、刷新、停止项目

安装

方式一：安装 Helper（推荐）

bash 复制代码

mkdir -p ~/cmds
curl -L -o ~/cmds/get-swarm-forge \
  https://raw.githubusercontent.com/unclebob/swarm-forge/main/get-swarm-forge
chmod +x ~/cmds/get-swarm-forge

将 ~/cmds 加入 PATH。Helper 是支持入口，因为它从多个分支组合文件。

方式二：安装 Pack 到现有项目

bash 复制代码

get-swarm-forge six-pack  # 或 two-pack / four-pack
./swarm

方式三：安装 Forge（多项目管理）

bash 复制代码

get-swarm-forge lieutenant  # 或 project-manager
./swarm

前置要求：

zsh
git
tmux
Babashka (bb)
至少一个配置的 Agent 后端：grok、codex、claude 或 copilot

上手：运行第一个示例

第一步：安装 Helper

bash 复制代码

mkdir -p ~/cmds
curl -L -o ~/cmds/get-swarm-forge \
  https://raw.githubusercontent.com/unclebob/swarm-forge/main/get-swarm-forge
chmod +x ~/cmds/get-swarm-forge
export PATH="$HOME/cmds:$PATH"

第二步：在现有项目中安装 Pack

bash 复制代码

cd /path/to/your/project
get-swarm-forge six-pack
./swarm

第三步：在空目录安装 Forge

bash 复制代码

mkdir my-factory && cd my-factory
get-swarm-forge lieutenant
./swarm

运行后，本地仪表板会在浏览器中打开，你可以：

创建新项目
查看每个 Agent 的工作状态
审批交接（approve handoffs）
回答 Agent 的澄清请求
中止整个 Swarm

Configuration 示例：

text 复制代码

# swarmforge.conf
window coder           claude   master   task    forward-only
window cleaner         codex    cleaner  task    forward-only
window architect       claude   architect batch   back-all

适用场景

复杂项目协作：需要多个 Agent 并行处理不同职责（编码、重构、架构、测试）。
Code Review 自动化：让 Architect Agent 在 Code Review 阶段介入，自动提出改进建议。
批量任务处理：通过 Forge 模式管理多个项目，每个项目有自己的 Agent Swarm。
AI 编程实验：研究多 Agent 协作模式、交接协议、人工监督机制。

结语

SwarmForge 解决的不是"又一个 AI 编程工具"的问题，而是"如何让多个 AI Agent 真正协作而不是各自为战"。它用 git worktree 隔离工作区、用持久化交接协议保证工作可追溯、用本地仪表板让人类操作员保持监督------这套设计让 AI 编程从"单兵作战"进化到"团队协作"。如果你对多 Agent 系统感兴趣，SwarmForge 值得 clone 下来跑一跑，感受一下从 get-swarm-forge 到 ./swarm 的完整工作流。

资源备份（夸克网盘）

完整源代码已同步备份到夸克网盘，可直接下载：

夸克网盘分享链接：https://pan.quark.cn/s/a7f943c63eb2（永久有效，无需提取码）

参考链接

仓库地址：https://github.com/unclebob/swarm-forge
官方文档：https://github.com/unclebob/swarm-forge/blob/main/README.md
许可证：见仓库 LICENSE