Batty Vibe 项目

项目简介

Batty 是一款面向软件开发场景的层级式 AI Agent 编排工具，核心定位是让多个 AI 编码 Agent 在终端中以团队形式协同工作。它将架构师（Architect）、经理（Manager）和多个工程师（Engineers）组织成分层团队，每个角色运行在独立的 tmux 窗格中，通过结构化 JSON 协议进行通信，并受到测试关卡（test-gated）的质量把控。

Batty 由 Rust 编写，发布为单一二进制文件，无需任何服务器端组件即可运行。用户只需一条 cargo install 命令完成安装，随后通过 YAML 定义团队角色，再由自然语言向架构师下达任务指令，整个开发流程即可自动推进。

核心功能

层级式团队编排

Batty 预设了三层角色结构：Architect（架构师）负责理解任务并规划方案，Manager（经理）负责将方案拆解为具体任务并分配给工程师，多个 Engineer（工程师）以并行方式各自在独立的 git worktree 中实现代码。所有角色均为可配置的 AI Agent，支持 Claude Code、Codex、Kiro 等主流编码 Agent。

tmux 原生运行

每个 AI Agent 运行在 tmux 的独立窗格中，用户可以随时切换窗格观察各 Agent 的工作状态。这种终端原生设计让 Batty 无需额外的 GUI 或 Web 界面，在纯命令行环境中即可高效运行。

隔离的 Git Worktree

每个工程师角色拥有独立的 git worktree，确保多 Agent 并行写代码时不会产生分支冲突。测试通过后，代码才会被合并到主分支，从机制上保证了代码质量。

测试门控机制

Batty 内置测试门控（test-gated）：代码提交前必须通过测试套件，失败则不允许合并。这一机制有效避免了 AI 生成低质量代码流入主干的问题。

Kanban 驱动的任务分发

任务通过 Markdown 格式的 Kanban 面板进行管理，Manager 角色自动创建并更新卡片状态。用户可以在面板上直观看到任务的进行中、待办和已完成状态。

Discord 集成

Batty 提供 Discord 集成，团队可以在频道中监督 Agent 的工作进度，获取任务状态更新通知，适合远程协作场景。

Agent 无锁定

Batty 不绑定特定 AI 提供商，支持 Claude Code、Codex、Kiro 等多种编码 Agent，用户可以根据项目需求灵活切换。

技术实现

Batty 由 Rust 语言编写，发布为静态二进制，依赖极低。核心通信协议基于类型化的 JSON 消息在各 Agent 之间路由，每个工程师角色启动时自动创建独立的 git worktree 分支，模拟真实团队开发环境。工作流程通过 YAML 配置文件定义角色属性和能力范围，初始化阶段通过 batty init 命令在项目中生成配置文件。持久化状态存储在本地的 Markdown/Kanban 文件中，无需数据库。Discord 集成通过 Webhook 实现事件推送。整体架构遵循"无服务器"原则，部署只需一台能运行 tmux 的 Linux/macOS 机器。

快速上手

步骤一：安装

在终端中执行以下命令安装 Batty CLI：

cargo install batty-cli

如需安装 Kanban 面板功能，可同时安装：

cargo install kanban-md --locked

步骤二：初始化项目

进入目标代码仓库，初始化 Batty 配置：

cd my-project && batty init

初始化后会生成默认的 YAML 角色配置文件。

步骤三：启动团队

执行以下命令启动整个 Agent 团队：

batty start --attach

各角色将自动在独立的 tmux 窗格中启动并就绪。

步骤四：下达任务

通过 batty send 命令向架构师发送任务指令：

batty send architect "Build a REST API with JWT auth"

架构师接收指令后自动规划方案，经理拆解任务并分配给各工程师，工程师并行实现代码并接受测试门控验证。

适用人群

Batty 适合以下用户群体：

• AI 编程爱好者：希望体验多个 AI Agent 协同工作的开发者
• 独立开发者：需要 AI 团队帮助提速编码全流程的个人开发者
• 小型团队：希望引入 AI 辅助开发但缺乏基础设施的中小团队
• 技术经理：需要可视化查看 AI 编码进度的技术负责人

需要注意的是，Batty 需要一台能够运行 tmux 的机器（Linux/macOS/WSL），并提前配置好目标 Agent（Claude Code、Codex 或 Kiro）的 API 访问凭证。