SwarmForge Skill:Bob 大叔的多 Agent 兵团级开发编排框架
SwarmForge Skill:Bob 大叔的多 Agent 兵团级开发编排框架
SwarmForge 是”敏捷之父”Robert C. Martin(Bob 大叔)推出的一款基于 tmux 的多 AI Agent 编排平台,通过配置驱动将多个专业化 Agent 组建成”开发兵团”,分工执行从需求规范到测试上线的完整流水线。它不依赖任何云服务,本地运行,轻量但极其严谨——是当前开源社区里将工程纪律引入 Agent 协作的最激进实验。
功能与原则
SwarmForge 的核心抽象是”纪律化的 Agent 协调层”。它通过 tmux session 管理多个并行的 AI Agent 角色,每个角色有独立的工作目录(git worktree)、角色提示词(roles/.prompt)和宪法约束(constitution articles),所有协作通过结构化消息传递而非共享上下文实现。
三大核心原则:
– 配置驱动拓扑: swarm 形态由 swarmforge.conf 定义,而非硬编码——改配置即改架构。
– 宪法分层:constitution.prompt 指导 Agent 读取 articles/ 下的约束文件,确保行为底线一致。
– 项目本地状态:所有状态存在 .swarmforge/,不污染主项目,可随时重建。
认可度
- GitHub Star:约 1,929(截至 2026-08-08)
- 今日新增:约 81 stars(Trending 榜单当日增速)
- Fork:206
- 作者背景:Robert C. Martin(unclebob),《代码整洁之道》《敏捷软件开发》作者,敏捷宣言合署人,软件工程界教父级人物
- Trending:2026-08-08 出现在 GitHub Trending 日榜
链接
GitHub:https://github.com/unclebob/swarm-forge
原作者
Robert C. Martin(GitHub @unclebob),业界尊称”Bob 大叔”。其 Clean Code 理念深刻影响了全球数百万开发者,此次进军 Agent 协作领域,延续了他一贯的工程纪律路线——不是让 AI 随意协作,而是用结构化宪法约束让 Agent 团队真正”专业地”工作。
介绍
SwarmForge 的核心洞察是:当前 AI Agent 开发的普遍问题是”各自为战”——多个 Agent 操作同一代码库时容易产生冲突、无序覆盖、没有质量门禁。SwarmForge 用类似”软件过程”的方式为 Agent 协作建立秩序。
项目将 Agent 角色分为三种角色模板(branch):
– two-pack(2 Agent):coder + cleaner,适合快速后端任务,TDD 开发循环
– four-pack(4 Agent):specifier + coder + refactorer + architect,适合中等规模需要规范评审的项目
– six-pack(6 Agent):specifier + coder + cleaner + architect + hardener + QA,适合大型项目全流程质量门禁
每个角色的提示词存放在项目本地的 swarmforge/roles/ 目录,通过 constitution 分层约束,所有状态存在 .swarmforge/,Agent 之间通过 handoff 脚本传递消息,不共享同一个 LLM 会话。
特点
- 零云依赖:完全本地运行,不需要 API Key 的云服务,所有 Agent 通过本地 tmux session 通信
- 配置即架构:通过 swarmforge.conf 定义 Agent 数量、角色、backend(支持 claude/codex/copilot/grok),改配置即可改变团队结构
- git worktree 隔离:每个角色操作独立 worktree,解决多 Agent 同时修改同一代码库的冲突问题
- 宪法约束机制:constitution articles 定义行为底线(如”测试通过后才能提交”),不可被单个 Agent 绕过
- 多种复杂度档位:two/four/six 三档,覆盖从”快速原型”到”企业级生产”的不同需求
- 可观察性强:每个角色对应一个 tmux window,开发者可实时观察所有 Agent 的工作状态
使用方法
安装依赖(macOS/Linux):
# 确认系统有 zsh, git, tmux, Babashka
brew install tmux babashka
拉取 SwarmForge(four-pack 示例):
BRANCH=four-pack
curl -L "https://github.com/unclebob/swarm-forge/archive/refs/heads/${BRANCH}.tar.gz" | tar -xz --strip-components=1
启动 swarm:
./swarm
启动后会自动打开多个 tmux window,每个 window 对应一个 Agent 角色(specifier、coder、refactorer、architect),第一个 window 是控制窗口,用于观察和关闭 swarm。
停止 swarm:关闭 swarmforge.conf 中定义的控制窗口,cleanup 脚本会自动关闭所有 tmux session。
配置 backend(以 Claude Code 为例):
在 swarmforge.conf 中为每个角色指定 backend:
role.coder.backend=claude
role.refactorer.backend=claude
使用场景与人群
- 适用场景:需要多个专业 Agent 协同完成的复杂软件项目;需要 TDD、规范化评审、质量门禁的企业级开发流程;对 AI 编程有工程质量要求的团队
- 目标用户:软件工程纪律要求高的开发者;使用 Claude Code / Codex 等 Agent 工具但希望建立更结构化协作流程的团队;Bob 大叔方法论的信仰者
输入与输出案例
输入(在目标项目目录执行):
BRANCH=four-pack
curl -L "https://github.com/unclebob/swarm-forge/archive/refs/heads/${BRANCH}.tar.gz" | tar -xz --strip-components=1
./swarm
然后在 specifier 窗口描述需求:”实现一个用户登录 API,包含 JWT 认证”。
输出:
– specifier Agent 将需求转化为 Gherkin 格式验收规范,暂停等待人工确认
– 确认后,coder Agent 在独立 worktree 中 TDD 实现,每次 commit 前测试必须通过
– refactorer Agent 对每次 handoff 做代码质量检查(CRAP/DRY)
– architect Agent 审查模块结构和依赖方向
– 全流程在 tmux window 中实时可见,最终代码进入主分支
评论区
登录后可评论。