286 lines
6.7 KiB
Markdown
286 lines
6.7 KiB
Markdown
# 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): 初始化模板
|