# Agent Team 分工及提示词

**文档版本**: 1.0.0
**最后更新**: 2026-04-19

---

## 目录

1. [概述](#1-概述)
2. [角色定义与分工](#2-角色定义与分工)
3. [<!-- 角色1 -->Agent](#3-角色1-agent)
4. [<!-- 角色2 -->Agent](#4-角色2-agent)
5. [<!-- 角色3 -->Agent](#5-角色3-agent)
6. [<!-- 角色4 -->Agent](#6-角色4-agent)
7. [协作流程](#7-协作流程)
8. [资源约束](#8-资源约束)
9. [产出物验收标准](#9-产出物验收标准)

---

## 1. 概述

### 1.1 目的

本文档定义项目**开发阶段**的 Agent Team 协作模式，面向实际编码和测试工作。每个角色的提示词模板可直接复制到 tmux Pane 中启动 Agent。

### 1.2 适用范围

- **阶段**: <!-- 开发阶段说明 -->
- **角色**: <!-- 角色列表 -->
- **协作方式**: tmux 4 Pane 并行工作

### 1.3 核心约束

| 约束 | 说明 |
|------|------|
| 模块独立性 | 各模块完全独立，禁止跨模块代码引用 |
| 通信方式 | 仅通过 REST API |
| 版本控制 | Jujutsu (jj)，主分支 `trunk` |
| 提交类型 | 使用中文（功能、修复、维护、文档、重构、测试...） |
| 包管理 | uv（Python）、nvm + npm（前端） |

---

## 2. 角色定义与分工

### 2.1 角色总览

| 角色 | 代码目录 | 技术栈 | 负责里程碑 |
|------|---------|--------|-----------|
| **<!-- 角色1 -->** | `apps/<!-- 模块1 -->/` | <!-- 技术栈 --> | <!-- 里程碑 --> |
| **<!-- 角色2 -->** | `apps/<!-- 模块2 -->/` | <!-- 技术栈 --> | <!-- 里程碑 --> |
| **<!-- 角色3 -->** | `tests/` | <!-- 技术栈 --> | 所有里程碑 |
| **项目经理** | `docs/`, 项目根目录 | 文档管理、进度追踪 | 所有里程碑 |

### 2.2 里程碑与角色映射

| 里程碑 | <!-- 角色1 --> | <!-- 角色2 --> | 测试 |
|--------|:---:|:---:|:---:|
| M1: <!-- 阶段1 --> | ● | ● | ○ |
| M2: <!-- 阶段2 --> | ● | | ● |
| M3: <!-- 阶段3 --> | | ● | ● |

● 主要负责 ○ 配合测试

### 2.3 角色依赖关系

```
PM ──分发任务──→ <!-- 角色1 --> ──完成──→ 测试工程师
  │                  │
  ├──分发任务──→ <!-- 角色2 --> ──完成──→ 测试工程师
  │                  │
  └──────────进度跟踪 & 验收────────────┘
```

---

## 3. <!-- 角色1 -->Agent

### 3.1 职责

- <!-- 职责1 -->
- <!-- 职责2 -->

### 3.2 技术栈

| 组件 | 技术 | 约束 |
|------|------|------|
| <!-- 组件 --> | <!-- 技术 --> | <!-- 约束 --> |

### 3.3 项目结构

```
apps/<!-- 模块 -->/
├── src/<!-- 模块名 -->/
│   ├── main.py
│   ├── api/
│   ├── services/
│   ├── models/
│   ├── db/
│   └── config/
├── tests/
│   ├── conftest.py
│   ├── unit/
│   └── integration/
└── pyproject.toml
```

### 3.4 完整提示词模板

**复制以下内容到 tmux Pane 启动 Agent**：

```
你是项目的<!-- 角色1 -->工程师。

## 你的职责

<!-- 职责列表 -->

## 技术栈

- <!-- 技术栈列表 -->

## 编码规范

- 缩进：4 空格 | 行宽：100 字符
- 命名：PascalCase 类/类型，snake_case 函数/变量，UPPER_SNAKE_CASE 常量
- Docstring：Google 风格，公共函数和类必须有
- 字符串：用户可见用双引号，代码内部用单引号
- 类型注解：所有函数必须有完整类型注解

## 架构约束

- 各模块完全独立，禁止跨模块引用
- 通信方式：仅 REST API

## 验证步骤

每次编码完成后执行：

1. uv run mypy src --strict          # 类型检查
2. ruff format --check . && ruff check .  # 代码格式和 Lint
3. uv run pytest tests/unit/ -v      # 单元测试
4. uv run pytest --cov=src           # 覆盖率检查

## 版本控制

- 工具：Jujutsu (jj)，并存模式
- 主分支：trunk
- 提交格式：<中文类型>(<作用域>): <描述>
- 提交标题不超过 50 字符
```

---

## 4. <!-- 角色2 -->Agent

<!-- 按 §3 模板添加 -->

---

## 5. <!-- 角色3 -->Agent

<!-- 按 §3 模板添加 -->

---

## 6. 项目经理 Agent

### 6.1 职责

- 任务分析和分发
- 进度跟踪和协调
- 代码审查协调
- 验收检查
- Agent 生命周期管理

### 6.2 完整提示词模板

**复制以下内容到 tmux Pane 启动 Agent**：

```
你是项目的项目经理（PM），负责开发阶段的任务分发、进度跟踪和质量验收。

## 你的职责

1. 分析任务需求，拆解为可分发的子任务
2. 通过 tmux send-keys 向各 Pane 分发任务
3. 跟踪各 Agent 的进度和完成状态
4. 协调 Agent 间的依赖关系
5. 执行产出物验收检查
6. 管理 Agent 生命周期

## 验收检查项

| 检查项 | 命令 |
|--------|------|
| 类型检查 | uv run mypy src --strict |
| 格式化 | ruff format --check . |
| Lint | ruff check . |
| 单元测试 | uv run pytest tests/unit/ -v |
| 覆盖率 | uv run pytest --cov=src --cov-report=term |

## 版本控制

- 工具：Jujutsu (jj)
- 主分支：trunk
- 提交格式：<中文类型>(<作用域>): <描述>
```

---

## 7. 协作流程

### 7.1 启动团队

```bash
# 使用 /isos-tmux-team 启动 4 Pane 工作空间
/isos-tmux-team
```

### 7.2 典型任务流转

```
1. PM 分析任务
2. PM → 对应 Pane：发送任务提示词
3. Agent 完成开发
4. PM 验收：类型检查 + 测试 + 覆盖率
5. PM → 测试 Pane：发送测试任务
6. 测试 Agent 完成
7. PM 最终验收
```

---

## 8. 资源约束

### 8.1 tmux 资源

| 约束 | 限制 | 原因 |
|------|------|------|
| Window 数量 | 最多 1 个 | 资源集中 |
| Pane 数量 | 最多 4 个 | 内存和 CPU 限制 |
| Agent 运行时间 | 建议不超过 30 分钟 | 上下文窗口限制 |

### 8.2 并行开发

- Agent 通过 `EnterWorktree` 在独立 git worktree 中工作
- 禁止多个 Agent 在同一目录编辑
- 合并冲突在主目录解决

---

## 9. 产出物验收标准

### 9.1 代码类产出

| 检查项 | 标准 | 命令 |
|--------|------|------|
| 类型检查 | mypy --strict 通过 | `uv run mypy src --strict` |
| 格式化 | ruff format 通过 | `ruff format --check .` |
| Lint | ruff check 通过 | `ruff check .` |
| 单元测试 | 全部通过 | `uv run pytest tests/unit/ -v` |
| 覆盖率 | 达到模块要求 | `uv run pytest --cov=src` |

### 9.2 测试类产出

| 检查项 | 标准 |
|--------|------|
| 覆盖率 | 满足各模块覆盖率要求 |
| 功能覆盖 | 测试用例覆盖所有相关 FR |

### 9.3 版本控制

| 检查项 | 标准 |
|--------|------|
| 提交类型 | 使用中文类型 |
| 提交标题 | 不超过 50 字符 |
| 模块边界 | 每个 PR 只改动一个模块 |

---

**版本历史**:
- v1.0.0 (2026-04-19): 初始化模板