核心用法
Gastown 是一个基于 Gas Town (gt) CLI 和 Claude Code 的多智能体编码编排系统,通过 Mayor 统一入口协调并行开发。
工作流程:
1. 任务委托:通过 gt mayor attach(交互式)或 gt mayor mail "任务描述"(非交互式)向 Mayor 描述需求
2. 自动拆分:Mayor 将任务拆分为 beads(工作项),创建 convoy(工作队列),并 sling(分配)给 polecats(子智能体)
3. 并行执行:每个 polecat 遵循 mol-polecat-work 9 步生命周期:加载上下文→创建分支→预检测试→实现→自审→运行测试→清理→准备评审→提交销毁
4. 自动合并:Refinery 代理负责将分支合并回 main,用户禁止直接推送
关键 CLI:
gt convoy list/status— 监控工作队列gt agents list --all— 查看所有智能体bd show <bead-id>— 检查具体任务状态
显著优点
- 真正的并行开发:多 polecats 同时处理不同 beads,大幅提升复杂任务效率
- 状态持久化:基于 git 的状态管理,支持断点续传
- 标准化生命周期:9 步强制流程确保代码质量(测试、自审、清理)
- 防冲突设计:分支隔离 + Refinery 统一合并,避免直接操作 main 的风险
- 自然语言接口:无需学习复杂 CLI,直接描述需求即可
潜在局限
- 环境门槛高:需预装 gt、bd、claude、tmux 3.0+、Go 1.23+ 五类组件
- 学习曲线陡峭:概念繁多(Mayor/Rig/Polecat/Convoy/Bead/Refinery/Witness)
- 调试复杂:多 tmux 会话并行,问题定位需熟悉
tmux capture-pane等命令 - 单点依赖:Mayor 故障时需
--hook-raw-bead紧急绕过,但会跳过生命周期保护 - 资源占用:多智能体并行对机器性能有要求
适合人群
- 需要同时修改多文件的中大型功能开发
- 涉及重构、bug 修复等需编译/测试的代码任务
- 团队协作场景下需标准化流程的代码审查
- 不适合:单文件快速编辑、纯研究任务、无需运行的脚本
常规风险
| 风险项 | 说明 |
|--------|------|
| 生命周期绕过 | `--hook-raw-bead` 会跳过测试/自审步骤,仅应急使用 |
| 直接推送 main | 文档明确禁止,会导致 Refinery 合并冲突 |
| ICU 构建失败 | Go 安装时需 `CGO_ENABLED=0` 规避 |
| 会话僵死 | Claude Code 完成后可能冻结,需手动 kill tmux |
| 权限问题 | 无 sudo 时需改安装到 `~/local/go/` |