142 lines
4.2 KiB
Markdown
142 lines
4.2 KiB
Markdown
# ISOS Agent Team 配置
|
||
|
||
## Agent 团队概述
|
||
|
||
本配置定义了 ISOS 项目的 4 个核心 Agent，每个 Agent 专注于特定领域，支持并行开发和高效协作。
|
||
|
||
## 团队组成
|
||
|
||
| Agent | 角色 | 文件 | Command | 主要职责 |
|
||
|-------|------|------|---------|----------|
|
||
| **isos-backend-agent** | 后端开发 | `.claude/agents/isos-backend-agent.md` | `/isos-backend` | FastAPI + SQLite 开发 |
|
||
| **isos-frontend-agent** | 前端开发 | `.claude/agents/isos-frontend-agent.md` | `/isos-frontend` | Svelte 5 + PyWebView |
|
||
| **isos-test-agent** | 测试工程师 | `.claude/agents/isos-test-agent.md` | `/isos-test` | 全级别测试和覆盖率 |
|
||
| **isos-project-manager-agent** | 项目经理 | `.claude/agents/isos-project-manager-agent.md` | `/isos-pm` | 任务分发和进度管理 |
|
||
|
||
## 使用方法
|
||
|
||
### 1. 团队协作模式（推荐）
|
||
|
||
```bash
|
||
# 1. 启动 4 Pane 团队工作空间（自动命名并加载角色提示词）
|
||
/isos-tmux-team
|
||
|
||
# 2. Pane 1（PM）已自动加载项目经理提示词
|
||
# 3. PM 向其他 Pane 分发任务
|
||
# 向 Pane 2（后端）发送后端任务
|
||
# 向 Pane 3（前端）发送前端任务
|
||
# 向 Pane 4（测试）发送测试任务
|
||
```
|
||
|
||
### 2. 单独使用各 Agent
|
||
|
||
```bash
|
||
# 启动后端开发 Agent
|
||
/isos-backend
|
||
|
||
# 启动前端开发 Agent
|
||
/isos-frontend
|
||
|
||
# 启动测试 Agent
|
||
/isos-test
|
||
|
||
# 启动项目经理 Agent
|
||
/isos-pm
|
||
```
|
||
|
||
## 里程碑模板
|
||
|
||
> 根据实际项目需要定义里程碑和角色分工。
|
||
|
||
| 里程碑 | 后端 | 前端 | 测试 |
|
||
|--------|:----:|:----:|:----:|
|
||
| M1: 基础架构 | ● | ● | ○ |
|
||
| M2: 核心功能 A | ● | | ● |
|
||
| M3: 核心功能 B | | ● | ● |
|
||
| M4: 核心功能 C | | ● | ● |
|
||
| M5: 集成与同步 | ● | ● | ● |
|
||
| M6: 部署与打包 | ● | ● | ● |
|
||
| M7: 增强功能 | | ● | ● |
|
||
| M8: 运维功能 | ● | | ● |
|
||
|
||
● 主要负责 ○ 配合测试
|
||
|
||
## 技术栈概览
|
||
|
||
### 后端开发 Agent
|
||
- Python 3.12+, mypy strict
|
||
- FastAPI 0.109+, SQLite 3.45+
|
||
- ruff format + ruff check
|
||
- Docker 24+
|
||
- uv 包管理
|
||
|
||
### 前端开发 Agent
|
||
- Svelte 5（runes: $state, $derived, $effect）
|
||
- PyWebView, TypeScript strict
|
||
- Vite + npm, Node.js 22+
|
||
- Python 3.12+（Service 层）
|
||
- IPC 通信：Svelte ↔ Python HTTPS
|
||
|
||
### 测试 Agent
|
||
- pytest, pytest-cov, pytest-mock
|
||
- httpx（API 测试）
|
||
- Playwright（E2E 测试）
|
||
- freezegun, hypothesis
|
||
- 覆盖率：核心模块>90%, 其他>75%
|
||
|
||
### 项目经理 Agent
|
||
- 任务分析和分发
|
||
- 进度跟踪和协调
|
||
- 代码审查协调
|
||
- 验收检查
|
||
- Agent 生命周期管理
|
||
|
||
## 协作流程
|
||
|
||
### 典型任务流转（以前端功能开发为例）
|
||
|
||
1. **PM 分析**：前端任务（UI + Service 层），无后端依赖
|
||
2. **PM → 前端 Agent**：发送任务提示词
|
||
3. **前端 Agent 完成**：UI 组件 + API 路由 + 单元测试
|
||
4. **PM 验收**：类型检查 + 测试 + 覆盖率
|
||
5. **PM → 测试 Agent**：发送接口测试任务
|
||
6. **测试 Agent 完成**：API 接口测试 + 覆盖率分析
|
||
7. **PM 验收**：测试通过 + 覆盖率达标
|
||
|
||
### 并行开发场景（前后端并行开发为例）
|
||
|
||
1. **PM 分析**：后端（API 路由）+ 前端（UI + Service 层）并行
|
||
2. **PM → 后端 Agent**：发送 API 开发任务
|
||
**PM → 前端 Agent**：发送前端开发任务
|
||
3. **后端 Agent 完成**：API 接口 + 单元测试
|
||
4. **前端 Agent 完成**：UI 组件 + Service 层 + 单元测试
|
||
5. **PM → 测试 Agent**：发送集成测试任务
|
||
6. **测试 Agent 完成**：集成测试 + 覆盖率分析
|
||
7. **PM 验收**：全部测试通过 + 覆盖率达标
|
||
|
||
## 注意事项
|
||
|
||
1. **Agent 生命周期**：完成任务后必须立即 shutdown
|
||
2. **模块独立性**：各模块完全独立，禁止跨模块代码引用
|
||
3. **版本控制**：使用 Jujutsu (jj)，主分支 trunk
|
||
4. **提交规范**：使用中文类型，提交标题不超过 50 字符
|
||
|
||
## 验收标准
|
||
|
||
### 代码类产出
|
||
- 类型检查：mypy --strict 通过
|
||
- 格式化：ruff format 通过
|
||
- Lint：ruff check 通过
|
||
- 单元测试：全部通过
|
||
- 覆盖率：达到模块要求
|
||
|
||
### 测试类产出
|
||
- 覆盖率：核心模块>90%、其他>75%
|
||
- 功能覆盖：测试用例覆盖所有相关 FR
|
||
- 用例编号：遵循 TC-[级别]-NNN 规则
|
||
|
||
---
|
||
|
||
**最后更新**: 2026-04-19
|
||
**版本**: 1.0.0
|