openclaw-skill-gastown

🧠 AI智能体持久化协同工作流引擎

面向Claude Code的工业级多Agent编排系统,通过Git持久化工作流状态,支持20-30个Agent规模化协作,解决上下文丢失与任务协调难题。

收藏
3.1k
安装
1.1k
版本
v0.1.4
CLS 安全性认证2026-05-04
点击查看完整报告 >

使用说明

核心用法

Gas Town(The Cognition Engine)是专为Claude Code设计的多Agent编排层,采用独特的蒸汽朋克隐喻系统(Mayor、Witness、Refinery、Polecat等角色)管理工作流。用户通过Mayor(主协调Agent)发起任务,系统自动将工作分解为Beads(原子工作单元)并组织成Convoy(工作车队)进行跟踪。支持两种操作模式:Minimal Mode(手动控制单个Agent)和Full Stack Mode(通过tmux守护进程管理20-30个并发Agent)。核心工作流遵循MEOW(分子化工作表达)和GUPP(通用推进原则),确保Agent发现Hook上的任务立即执行,通过gt sling分配工作,bd close --continue自动推进步骤,实现无人值守的自治化流水线。

显著优点

1. 持久化状态管理:使用Git-backed Hooks存储工作状态,彻底解决Agent重启后上下文丢失的行业痛点,支持任意时刻的断点续作。
2. 企业级可观测性:完整的归因系统(BD_ACTOR)记录每个Agent的操作历史,支持能力评估和A/B测试,满足合规审计需求。

3. 弹性伸缩架构:从单Agent到30+Agent的线性扩展能力,Witness自动监控Polecat健康状态,自动回收僵死进程并重新调度。

4. 复杂工作流编排:Molecule系统支持多步骤依赖工作流,Formulas提供可复用的TOML模板,实现跨项目标准化操作。

5. 多运行时支持:兼容Claude Code、Codex、OpenCode等多种AI CLI工具,支持混合部署不同模型(Sonnet/GPT-4等)对比效果。

潜在缺点与局限性

1. 陡峭的学习曲线:独特的隐喻体系(Rig、Polecat、Beads等)和复杂的角色拓扑(Mayor→Witness→Refinery)需要较高的认知成本,文档虽详尽但概念密集。
2. 环境依赖较重:强制依赖Go 1.24+、Git 2.20+、tmux 3.0+,且Full Stack Mode需要常驻守护进程,对轻量级场景过于沉重。

3. Git中心化限制:所有状态持久化依赖Git仓库,对非Git项目或极大规模二进制资产场景支持有限。

4. T3来源风险:由个人开发者维护(steveyegge),虽代码质量高但长期维护稳定性低于企业级产品,社区生态尚处早期(如Mol Mall仅为规划功能)。

适合的目标群体

  • 中大型企业研发团队:需要协调10+ AI Agent处理跨仓库项目,要求完整的操作审计链和质量门禁(Refinery合并队列)。
  • AI工程化团队:需要对比不同模型(Claude vs GPT-4)在相同工作流下的表现,依赖内置的归因统计系统。
  • 复杂多步骤任务场景:如大规模重构、跨服务API迁移、多模块依赖升级等需要数小时/数天持续执行且不能丢失上下文的任务。
  • DevOps/SRE团队:需要自动化处理监控告警、批量创建MR、跨仓库配置同步等运维流水线。

使用风险

1. 安装风险:setup.sh脚本需网络下载Go编译器(官方源)和GitHub工具,离线环境无法使用;会修改~/.bashrc添加PATH,存在配置污染风险。
2. 版本漂移:默认使用@latest安装gt/bd工具,虽Go 1.23.6版本已锁定,但主工具链可能引入破坏性更新,建议生产环境锁定具体版本号。

3. 权限风险:需要文件系统写入权限($HOME/gt目录)和网络访问权限,虽无系统破坏性操作,但错误的gt stop --all可能中断正在进行的任务。

4. 数据一致性:虽Git提供持久化,但多Agent并发操作同一仓库时依赖Refinery的合并队列解决冲突,极端情况下可能出现分支状态不一致需手动干预。

安全解读

核心定位

Gas Town("认知引擎")是专为 Claude Code 设计的多智能体编排系统,解决大规模 AI Agent 协作中的关键痛点:上下文丢失、手动协调混乱、工作状态不可追踪。

核心机制

Git-Backed 持久化:每个 Agent 拥有独立的 Git worktree 作为 Hook,工作状态持久化存储,Agent 重启后可无缝恢复。这是 Gas Town 区别于其他多 Agent 系统的核心创新。

GUPP 推进原则:"If there is work on your Hook, YOU MUST RUN IT" —— 自主执行引擎,无监督轮询,Agent 发现 Hook 上的任务立即执行,避免系统停滞。

分层角色架构

  • Mayor:全局协调器,人类主要交互界面
  • Deacon:守护进程,系统健康监控
  • Witness:单项目生命周期管理
  • Refinery:合并队列处理器
  • Polecat:瞬态工作 Agent(Witness 管理)
  • Crew:持久化工作空间(人类管理)

MEOW 工作分解:将大目标拆解为可追踪的原子单元(Beads),通过 Molecules 实现多步骤工作流,支持 --continue 自动推进保持动量。

关键特性

| 特性 | 说明 |
|------|------|

Convoy 追踪 | 跨项目批量工作追踪单元,自动状态通知 |

| **完整归因** | BD_ACTOR 环境变量 + Git 提交者 + Beads 记录,三维溯源 |
| **跨项目依赖** | beads:// 协议支持跨仓库工作引用 |
| **自主恢复** | Witness 检测停滞 Agent,自动 respawn |
| **能力路由** | 基于历史工作数据自动匹配 Agent 与任务 |

优势与局限

显著优点

  • 真正解决 Agent 重启上下文丢失问题(Git worktree 持久化)
  • 支持 20-30 Agent 规模,远超手动协调的 4-10 Agent 上限
  • 完整的审计追踪与性能数据(Agent CV 概念)
  • 声明式工作流(Formula/Molecule)可复用

潜在局限

  • 学习曲线陡峭:大量使用隐喻术语(Mayor、Rig、Hook、Polecat 等)
  • 依赖 tmux 和 Git,Windows 支持受限
  • T3 来源(个人开发者),长期维护不确定性
  • 需要预装 Go 环境,基础设施要求较高

适用场景

  • 多仓库企业级项目需协调 10+ AI Agent
  • 长时间运行任务需断点续作能力
  • 需要严格审计合规的 AI 辅助开发
  • 团队希望客观评估不同 Agent/模型的实际表现

常规风险

  • Zombie/Stalled Agent:需 Witness 监控自动回收
  • Git worktree 冲突:需正确配置 BEADS_NO_DAEMON
  • 网络依赖:动态下载 Go 工具链,需官方源可用
  • 版本漂移:默认 @latest 安装,建议锁定版本

openclaw-skill-gastown 内容

references文件夹
scripts文件夹
手动下载zip · 27.9 kB
architecture.mdtext/markdown
请选择文件