# agent-team

**Repository Path**: jsonlee_lee/agent-team

## Basic Information

- **Project Name**: agent-team
- **Description**: No description available
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# agent-team

[English](./README.md) | 中文

**以手术般的精度编排你的 AI 劳动力。** 🚀

`agent-team` 是一个多智能体开发管理器，采用 **Role + Worker** 模型，在隔离的 Git worktree 和专用终端会话中运行 AI 智能体。

- **🎭 Role (角色)**: 可复用的技能包 (`.agents/teams/`)，定义目标、提示词和工具。
- **🛠️ Worker (工作者)**: 隔离的运行实例 (`.worktrees/`)，拥有独立的逻辑分支和会话。

---

## 目录

- [安装](#️-安装)
  - [AI 自助安装（推荐）](#-ai-自助安装推荐)
  - [手动安装](#-手动安装)
- [升级](#-升级)
- [快速开始](#-快速开始)
- [工具箱](#-工具箱)
- [支持的 Provider](#-支持的-provider)
- [高级用法](#️-高级用法)
  - [CLI 命令参考](#cli-命令参考)
  - [目录结构](#目录结构)
  - [环境变量](#环境变量)
- [License](#-license)

---

## 🛠️ 安装

### 🤖 AI 自助安装（推荐）
让你的 AI 智能体自行完成安装，只需两步：

1. **安装 Skill**:
   ```bash
   npx skills add JsonLee12138/agent-team -a <platform> -y
   ```
   将 `<platform>` 替换为你的 Provider：`claude`、`gemini`、`opencode` 或 `codex`。
2. **对智能体说**:
   > "安装 agent-team 并初始化项目。"

---

### 📦 手动安装

| 方式 | 命令 |
| :--- | :--- |
| **Homebrew** | `brew tap JsonLee12138/agent-team && brew install agent-team` |
| **Go Install** | `go install github.com/JsonLee12138/agent-team@latest` |
| **Claude Plugin** | `/plugin marketplace add JsonLee12138/agent-team` |
| **Gemini Ext** | `gemini extensions install https://github.com/JsonLee12138/agent-team` |
| **OpenCode Plugin** | `{ "plugin": ["opencode-agent-team"] }` in `~/.config/opencode/opencode.json` |

---

## 🔄 升级

| 方式 | 命令 |
| :--- | :--- |
| **Claude Plugin** | `/plugin marketplace update agent-team` |
| **Skill** | `npx skills add JsonLee12138/agent-team -a '*' -y` |
| **Homebrew** | `brew update && brew upgrade agent-team` |
| **Go Install** | `go install github.com/JsonLee12138/agent-team@latest` |

---

## 🚀 快速开始

完全通过自然语言管理你的团队。你的 AI 智能体会为你处理底层命令。

### 1. 定义团队
> "创建一个 **frontend-architect** 角色，负责管理我们的 UI 架构。"

### 2. 安装精选角色 (可选)
从本仓库拉取专家预设的角色：
```bash
agent-team role-repo add JsonLee12138/agent-team
```

### 3. 启动 Worker
> "使用 Claude 为 **frontend-architect** 创建一个 worker。"
*这会打开一个新的终端窗口，并进入隔离的 worktree。*

### 4. 分配任务 & 头脑风暴
> "分配 **frontend-architect-001** 负责设计新的登录流程。"
*在改动代码前，智能体会先通过对话产出设计文档。*

### 5. 合并与清理
> "合并 **frontend-architect-001** 并删除该 worker。"

---

## 🧰 工具箱

### 内置角色
位于 `.agents/teams/`:
- `pm`: 产品经理，负责需求梳理。
- `frontend-architect`: 前端架构，负责 UI/UX 顶层设计。
- `vite-react-dev`: 专为 Vite + React 开发优化。
- `pencil-designer`: Pencil UI 设计工具专家。

### 内置 Skills
- `role-creator`: 交互式构建新的智能体角色。
- `brainstorming`: 在实现前通过对话验证想法。

---

## 🤖 支持的 Provider

| Provider | CLI 值 | Hook 支持 |
| :--- | :--- | :--- |
| **Claude Code** | `claude` | ✅ 完整 (Plugin) |
| **Gemini CLI** | `gemini` | ✅ 完整 (Extension) |
| **OpenCode** | `opencode` | ✅ 完整 (NPM Plugin) |
| **OpenAI Codex** | `codex` | ⚠️ 仅 Prompt |

---

## ⚙️ 高级用法

<details>
<summary><b>📖 CLI 命令参考</b></summary>

### 角色管理
- `agent-team role list`: 列出本地角色。
- `agent-team role create <name>`: 创建新的角色包。
- `agent-team role-repo add <owner/repo>`: 从 GitHub 安装角色。

### Worker 操作
- `agent-team worker create <role>`: 启动新的 worker。
- `agent-team worker status`: 查看活跃的 worker 和任务。
- `agent-team worker assign <id> "<task>"`: 分配工作。
- `agent-team worker merge <id>`: 合并 worker 变更。

### 通信
- `agent-team reply <id> "<msg>"`: 向 worker 发送消息。
- `agent-team reply-main "<msg>"`: Worker 向主控回传消息。

</details>

<details>
<summary><b>📂 目录结构</b></summary>

```
项目根目录/
├── .agents/teams/        <- 项目专属角色
├── .worktrees/           <- 隔离的 worker 工作区
├── roles-lock.json       <- 远程角色版本锁
├── gemini-extension.json <- 扩展清单
└── hooks/                <- 共享生命周期钩子
```

</details>

<details>
<summary><b>🌐 环境变量</b></summary>

| 变量 | 默认值 | 说明 |
| :--- | :--- | :--- |
| `AGENT_TEAM_BACKEND` | `wezterm` | 终端：`wezterm` 或 `tmux`。 |
| `AGENT_TEAM_ROLE_HUB_URL` | `https://...` | 埋点上报地址。 |
| `AGENT_TEAM_ROLE_HUB_DEBUG` | `0` | 若设为 `1` 则等待上报完成。 |

</details>

---

## 📄 License

MIT © [JsonLee](https://github.com/JsonLee12138)