当前位置：首页 > news >正文

SwarmForge实战教程：使用two-pack快速完成后端开发

news 2026/8/9 19:49:42

SwarmForge实战教程：使用two-pack快速完成后端开发

【免费下载链接】swarm-forgeA simple tool for coordinating several AI agents.项目地址: https://gitcode.com/GitHub_Trending/sw/swarm-forge

SwarmForge是一款基于tmux的AI代理协调工具，能够将多个AI代理转变为可靠的专业软件工程师。其中，two-pack作为快速后端工作流，特别适合小型任务，可在无需Gherkin和验收测试的情况下实现快速编码，同时保留后端重构和强化功能。

一、two-pack工作流简介

two-pack是SwarmForge提供的轻量级后端开发方案，它包含两个核心角色：

coder：通过TDD和单元测试实现所需功能
cleaner：批处理coder的交付成果，执行代码清理、CRAP和DRY审查、架构审查、封装和关注点分离修复，以及语言变异强化

正常工作流程为：coder→cleaner→coder，形成一个紧密的实现/改进循环，无需规范、QA、属性测试或验收测试角色。

二、环境准备

在开始使用two-pack工作流之前，确保目标机器已安装以下依赖：

zsh
git
tmux
Babashka (bb)
至少一个配置的代理后端，如codex、claude、copilot或grok

三、快速开始two-pack工作流

1. 获取SwarmForge代码

BRANCH=two-pack curl -L "https://github.com/unclebob/swarm-forge/archive/refs/heads/${BRANCH}.tar.gz" | tar -xz --strip-components=1

2. 启动swarm

在目标项目目录中执行：

./swarm

首次使用时，./swarm包装器会下载main分支存档，复制swarmforge/scripts/中的共享操作脚本，从swarmforge/constitution/articles/暂存共享章程文章，然后启动swarmforge/scripts/swarmforge.sh。后续运行将重用现有的本地脚本目录，而不是覆盖它。

四、two-pack工作流程详解

1. 角色协作流程

two-pack采用简洁的双角色协作模式：

coder负责实现功能并编写单元测试
cleaner接收coder的工作成果，进行代码质量提升
改进后的代码返回给coder，形成持续迭代

当cleaner向coder发送返回交付时，coder会继续基于改进后的代码进行开发，这种循环模式确保代码质量在开发过程中不断提升。

2. 工作树结构

SwarmForge会在.worktrees/下为每个角色创建git工作树，two-pack的工作树结构如下：

swarmforge/ swarmforge.conf constitution.prompt constitution/ articles/ engineering.prompt handoffs.prompt workflow.prompt project.prompt local-engineering.prompt local-workflow.prompt roles/ coder.prompt cleaner.prompt

3. 交付协议

two-pack使用SwarmForge的标准交付协议，代理通过三个辅助脚本与交付进行交互：

swarm_handoff.sh <draft-file>：验证并排队出站交付
ready_for_next.sh：使用角色配置的接收模式接受工作
done_with_current.sh：使用角色配置的接收模式完成当前任务或批处理

五、配置与自定义

1. swarmforge.conf配置

two-pack的swarmforge/swarmforge.conf定义了swarm窗口结构，示例配置如下：

window coordinator codex master window coder codex coder window cleaner codex cleaner

每个窗口定义格式为：

window <role> <agent> <worktree> [task|batch] [extra-cli-args...]

2. 终端后端选择

SwarmForge支持多种终端后端，可通过环境变量SWARMFORGE_TERMINAL指定：

SWARMFORGE_TERMINAL=ghostty ./swarm SWARMFORGE_TERMINAL=terminal-app ./swarm SWARMFORGE_TERMINAL=windows-terminal ./swarm SWARMFORGE_TERMINAL=none ./swarm