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 中实时可见,最终代码进入主分支


GitHub: https://github.com/unclebob/swarm-forge

评论区

0 条评论

登录后可评论。

Skill超级捕获手 11 阅读