Openclaw Skill Gastown

核心概述

Gastown是一个基于gt（Gas Town）CLI和Claude Code构建的多智能体代码编排框架，专为非琐碎开发任务设计。系统通过"Mayor"主代理协调多个"Polecat"工作代理并行执行多文件修改、功能开发、重构和Bug修复等任务。

核心用法

用户通过自然语言与Mayor交互（gt mayor attach交互式或gt mayor mail非交互式），Mayor自动将任务拆分为Beads（工作项），创建Convoy（任务队列），并派遣Polecat代理执行。每个Polecat遵循mol-polecat-work公式的9步标准化生命周期：加载上下文→分支设置→预检测试→实现→自审→运行测试→清理工作区→准备评审→提交退出。Refinery代理负责合并回主分支，用户无需直接操作Git。

显著优点

• 并行化效率：多代理同时处理不同任务模块，突破单会话瓶颈
• 标准化流程：9步强制工作流确保代码质量、测试覆盖和自审机制
• 状态持久化：基于Git的Beads系统和tmux会话保证工作可恢复、可追踪
• 自然语言驱动：无需编写复杂脚本，描述需求即可启动完整工作流

潜在局限

• 环境依赖复杂：需同时配置gt、bd、claude三个CLI、tmux 3.0+、Go 1.23+及复杂符号链接设置
• 学习曲线陡峭：Rig、Bead、Convoy、Polecat、Formula等概念体系需时间理解
• 调试不透明：代理在tmux后台运行，问题定位依赖tmux capture-pane等间接手段
• 公式解析脆弱：gt sling与bd cook的搜索路径不一致，需手动符号链接修复
• Claude Code锁定：深度绑定Anthropic生态，无法迁移至其他模型

适合人群

• 中大型代码库维护者（需频繁跨文件修改）
• 追求CI/CD式本地开发标准的团队
• 熟悉tmux/Go生态、愿意投入基础设施建设的资深开发者
• 需要将复杂任务分解为可并行子任务的项目

常规风险

• 代理失控风险：Polecat拥有分支创建、代码提交、推送权限，错误指令可能导致仓库污染
• 状态同步问题：多个代理并行修改可能引发合并冲突，依赖Refinery的仲裁机制
• tmux会话残留：Claude Code会话可能冻结，需手动清理僵尸进程
• 配置漂移：符号链接或公式路径配置错误会导致代理跳过标准工作流进入"raw bead"模式，丧失质量门禁
• 成本累积：多代理并行调用Claude Code API可能产生较高Token消耗

Gastown — 多代理代码编排系统

核心用法

Gastown 是一个基于 gt（Gas Town）CLI 和 Claude Code 的多代理编排系统，专为复杂代码任务设计。用户通过 Mayor（市长） 作为统一入口，以自然语言描述需求，Mayor 自动将任务拆分为可追踪的工作单元（beads），协调多个并行代理（polecats）执行，并通过 Refinery 完成合并。

典型工作流：
1. gt mayor attach 进入交互式会话或 gt mayor mail "任务描述" 异步提交
2. Mayor 创建 convoy（工作集）和 beads（工作项）
3. 自动分配 polecats 执行 mol-polecat-work 九步生命周期：加载上下文→分支设置→预检测试→实现→自审→运行测试→清理→准备评审→提交销毁
4. Refinery 代理从合并队列自动合并到主分支

显著优点

• 真正的并行开发：多 polecats 同时工作，突破单代理瓶颈
• Git 持久化状态：所有工作基于分支，天然具备版本控制和回滚能力
• 标准化生命周期：9 步强制流程确保代码质量和测试覆盖
• Mayor 中心化调度：避免手动管理 beads、hooks、convoys 的复杂性
• 非侵入式集成：通过 tmux 会话隔离代理，不污染主工作环境

潜在缺点与局限性

• 环境门槛高：需预装 Go 1.23+、tmux 3.0+、gt/bd/claude 三个 CLI 工具，首次配置繁琐
• 公式解析陷阱：必须手动为每个 rig 创建 symlinks 指向 town-level formulas，否则 polecats 退化为 raw-bead 模式，跳过生命周期
• 调试不透明性：polecats 运行在 tmux 会话中，需 tmux capture-pane 查看实时输出，日志分散
• T3 来源风险：社区/个人项目，依赖 Steve Yegge 维护的上游 Gastown/Beads，更新持续性存疑
• 单点故障：Mayor 是协调核心，若 Mayor 崩溃需紧急 --hook-raw-bead 手动介入

适合人群

• 需频繁处理跨文件重构、新功能开发的中大型代码库维护者
• 追求并行开发效率、愿为复杂流程支付学习成本的团队
• 已熟悉 tmux、Go 生态，具备 CLI 工具链调试经验的开发者

不适合：单文件快速编辑、无 Go 环境、偏好简单直接工作流的场景。

常规风险

• setup.sh 修改 shell 配置：脚本向 ~/.bashrc 追加 PATH，虽检查重复但仍属敏感操作
• 远程代码下载：从 go.dev 下载 Go 编译器，当前无 SHA256 校验，建议用户审查后运行
• tmux 会话残留：polecats 完成后可能冻结，需手动清理
• T3 维护状态：建议定期审查上游安全公告，关注 gastown/beads 仓库更新