核心用法
Gastown 是一个基于 Gas Town (gt) CLI 和 Claude Code 的多智能体代码编排系统，专门用于处理非平凡的编程任务。用户通过 Mayor 智能体作为统一入口，以自然语言或邮件形式提交任务描述，Mayor 自动将任务拆解为 beads（工作项），创建 convoy（工作组）进行跟踪，并派遣 polecats（并行 Claude Code 代理）执行具体开发工作。
工作流程遵循严格的 9 步生命周期（mol-polecat-work formula）：加载上下文→分支设置→预检测试→功能实现→自我审查→运行测试→清理工作区→准备评审→提交退出。Refinery 智能体负责从合并队列自动合并代码，用户无需直接操作 git。
显著优点
- 真正的并行开发：多个 polecats 可同时处理不同 beads，大幅加速大型重构和功能开发
- 状态持久化：基于 git 的 beads 系统和 convoy 跟踪，任务中断后可完整恢复
- 自动化质量门禁：内置预检测试、自我审查、覆盖率验证等步骤，减少人工 review 负担
- 声明式工作流：mol-polecat-work formula 定义标准化开发流程，避免代理"遗忘"后续步骤
- 优雅的故障隔离：单个 polecat 失败不影响整体 convoy，Mayor 可重新调度
潜在缺点与局限性
- 基础设施复杂度高：需要 tmux、Go 1.23+、gt/bd CLI 等多重依赖，首次 setup 涉及符号链接等易错配置
- formula 解析陷阱：bd 与 gt 的 formula 搜索路径不一致，若未正确创建符号链接，polecats 会陷入"idle/frozen"状态且报错信息隐晦
- 调试门槛高：需要熟悉 tmux 会话管理、beads 状态查询、convoy 跟踪等多层抽象才能定位问题
- 资源消耗：每个 polecat 独立 tmux 会话，大规模并行时内存和 API 调用成本显著
- Claude Code 依赖：功能完全绑定 Anthropic 的 claude CLI，无法迁移至其他模型
适合人群
- 需要频繁进行跨文件重构、大型功能开发的资深工程师
- 具备 DevOps 经验、能自主排查 tmux/Go 环境问题的技术团队
- 愿意投入前期配置成本以换取长期并行开发效率的 AI-native 开发团队
常规风险
- 配置漂移导致静默失败：formula symlink 缺失时系统仅警告而非报错，polecats 会假死造成工作丢失
- Mayor 单点瓶颈：所有任务协调通过 Mayor，若 Mayor 服务异常整个系统停滞
- 合并冲突放大：多 polecat 并行修改相邻代码时，Refinery 的自动合并可能产生语义冲突而非文本冲突
- API 成本失控：长时间运行的多代理会话可能产生意外的 Claude API 调用费用