企业官网建设流程全解析

Gas Town完全指南：从安装到精通的多智能体工作流管理终极教程

【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown

Gas Town是一款功能强大的多智能体工作流管理系统，专为Claude Code设计，提供持久化工作跟踪能力。本教程将帮助你从安装到精通，充分利用这个终极多智能体工作区管理器，轻松协调多个AI代理协同工作。

为什么选择Gas Town？

传统的AI代理工作流存在诸多挑战，而Gas Town提供了创新解决方案：

Gas Town核心概念解析 🧩

The Mayor 🎩

你的主要AI协调者。Mayor是一个Claude Code实例，掌握你的工作区、项目和代理的全部上下文。从这里开始——只需告诉Mayor你想要完成什么。

Town 🏘️

你的工作区目录（例如~/gt/）。包含所有项目、代理和配置。

Rigs 🏗️

项目容器。每个rig包装一个Git仓库并管理其关联的代理。相关代码实现可查看internal/rig/目录。

Crew Members 👤

你在rig中的个人工作区。这是你进行实际操作的地方。

Polecats 🦨

临时工作代理，完成任务后就会消失。其管理逻辑位于internal/polecat/。

Hooks 🪝

基于Git工作树的持久化存储，用于存储代理工作。可在internal/hooks/查看实现。

Convoys 🚚

工作跟踪单元。捆绑多个beads分配给代理。相关实现见internal/convoy/。

Beads Integration 📿

基于Git的问题跟踪系统，将工作状态存储为结构化数据。Bead ID（也称为issue ID）使用前缀+5字符字母数字格式（例如gt-abc12，hq-x7k2m）。前缀表示项目的来源或rig。

Gas Town新手？请参阅docs/glossary.md获取完整的术语和概念指南。

快速安装指南 ⚡

系统要求

• Go 1.23+- 用于编译源代码
• Git 2.25+- 支持工作树功能
• beads (bd) 0.44.0+- 用于自定义类型支持 internal/deps/beads.go
• sqlite3- 用于convoy数据库查询（通常在macOS/Linux上预装）
• tmux 3.0+- 推荐使用以获得完整体验
• Claude Code CLI（默认运行时）
• Codex CLI（可选运行时）

安装步骤

# 安装Gas Town (选择一种方式) # Homebrew (推荐) brew tap steveyegge/gastown && brew install gt # npm npm install -g @gastown/gt # 从源码安装 go install github.com/steveyegge/gastown/cmd/gt@latest # 如果使用go install，将Go二进制文件添加到PATH（添加到~/.zshrc或~/.bashrc） export PATH="$PATH:$HOME/go/bin" # 使用git初始化创建工作区 gt install ~/gt --git cd ~/gt # 添加你的第一个项目 gt rig add myproject https://gitcode.com/gh_mirrors/ga/gastown # 创建你的crew工作区 gt crew add yourname --rig myproject cd myproject/crew/yourname # 启动Mayor会话（你的主要界面） gt mayor attach

快速入门：3分钟上手工作流

基本工作流程

Gas Town的工作流程设计直观高效：

1. 告诉Mayor你想要构建什么
2. Mayor创建包含beads的convoy
3. Mayor将bead分配给代理
4. 代理将工作状态存储在Hook中
5. 代理完成工作并向Convoy报告
6. Mayor向你总结进度

功能开发示例

# 1. 启动Mayor gt mayor attach # 2. 在Mayor会话中，创建包含bead ID的convoy gt convoy create "Feature X" gt-abc12 gt-def34 --notify --human # 3. 将工作分配给代理 gt sling gt-abc12 myproject # 4. 跟踪进度 gt convoy list # 5. 监控代理 gt agents

常用工作流详解

Mayor工作流（推荐）

最适合：协调复杂的多任务工作

# 连接到Mayor gt mayor attach # 在Mayor中，创建convoy并让它编排工作 gt convoy create "Auth System" gt-x7k2m gt-p9n4q --notify # 跟踪进度 gt convoy list

最小模式（无Tmux）

手动运行单个运行时实例。Gas Town仅跟踪状态。

gt convoy create "Fix bugs" gt-abc12 # 创建convoy（如果跳过，sling会自动创建） gt sling gt-abc12 myproject # 分配给工作代理 claude --resume # 代理读取邮件，运行工作（Claude） # 或: codex # 在工作区启动Codex gt convoy list # 检查进度

Beads公式工作流

最适合：预定义的可重复流程

公式是存储在.beads/formulas/中的TOML定义工作流。例如formula/gastown-release.formula.toml。

执行公式：

# 列出可用公式 bd formula list # 使用变量运行公式 bd cook release --var version=1.2.0 # 创建用于跟踪的公式实例 bd mol pour release --var version=1.2.0

核心命令参考

工作区管理

gt install <path> # 初始化工作区 gt rig add <name> <repo> # 添加项目 gt rig list # 列出项目 gt crew add <name> --rig <rig> # 创建crew工作区

代理操作

gt agents # 列出活动代理 gt sling <bead-id> <rig> # 将工作分配给代理 gt mayor attach # 启动Mayor会话 gt prime # 上下文恢复（在现有会话中运行）

内置代理预设：claude,gemini,codex,cursor,auggie,amp

Convoy（工作跟踪）

gt convoy create <name> [issues...] # 创建包含问题的convoy gt convoy list # 列出所有convoy gt convoy show [id] # 显示convoy详情 gt convoy add <convoy-id> <issue-id...> # 向convoy添加问题

配置

# 设置自定义代理命令 gt config agent set claude-glm "claude-glm --model glm-4" # 设置默认代理 gt config default-agent claude-glm # 查看配置 gt config show

高级功能探索

仪表盘

Gas Town包含用于监控的Web仪表盘：

# 启动仪表盘 gt dashboard --port 8080 # 在浏览器中打开 open http://localhost:8080

仪表盘功能：

• 实时代理状态
• Convoy进度跟踪
• Hook状态可视化
• 配置管理

推进原理

Gas Town使用Git钩子作为推进机制。每个钩子是一个Git工作树，具有：

1. 持久状态- 工作在代理重启后仍然存在
2. 版本控制- 所有更改都在Git中跟踪
3. 回滚能力- 可恢复到任何先前状态
4. 多代理协调- 通过Git共享

MEOW（Mayor增强型编排工作流）

MEOW是推荐的工作模式：

1. 告诉Mayor- 描述你想要的内容
2. Mayor分析- 将其分解为任务
3. Convoy创建- Mayor创建包含beads的convoy
4. 代理生成- Mayor生成适当的代理
5. 工作分配- Beads通过钩子分配给代理
6. 进度监控- 通过convoy状态跟踪
7. 完成- Mayor总结结果

故障排除与常见问题

代理失去连接

检查钩子是否正确初始化：

gt hooks list gt hooks repair

Convoy卡住

强制刷新：

gt convoy refresh <convoy-id>

Mayor无响应

重启Mayor会话：

gt mayor detach gt mayor attach

Gas Town使用技巧

• 始终从Mayor开始- 它被设计为你的主要界面
• 使用convoy进行协调- 它们提供跨代理的可见性
• 利用钩子进行持久化- 你的工作不会消失
• 为重复任务创建公式- 使用Beads配方节省时间
• 监控仪表盘- 获取实时可见性
• 让Mayor编排- 它知道如何管理代理

通过本指南，你现在已经掌握了Gas Town的核心功能和高级用法。这个强大的多智能体工作流管理系统将帮助你更高效地协调AI代理，实现复杂项目的无缝协作。无论你是个人开发者还是团队负责人，Gas Town都能为你的工作流程带来革命性的改进。

【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown