4.2 KiB
4.2 KiB
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. 团队协作模式（推荐）
# 1. 启动 4 Pane 团队工作空间（自动命名并加载角色提示词）
/isos-tmux-team
# 2. Pane 1（PM）已自动加载项目经理提示词
# 3. PM 向其他 Pane 分发任务
# 向 Pane 2（后端）发送后端任务
# 向 Pane 3（前端）发送前端任务
# 向 Pane 4（测试）发送测试任务
2. 单独使用各 Agent
# 启动后端开发 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 生命周期管理
协作流程
典型任务流转（以前端功能开发为例）
- PM 分析：前端任务（UI + Service 层），无后端依赖
- PM → 前端 Agent：发送任务提示词
- 前端 Agent 完成：UI 组件 + API 路由 + 单元测试
- PM 验收：类型检查 + 测试 + 覆盖率
- PM → 测试 Agent：发送接口测试任务
- 测试 Agent 完成：API 接口测试 + 覆盖率分析
- PM 验收：测试通过 + 覆盖率达标
并行开发场景（前后端并行开发为例）
- PM 分析：后端（API 路由）+ 前端（UI + Service 层）并行
- PM → 后端 Agent：发送 API 开发任务 PM → 前端 Agent：发送前端开发任务
- 后端 Agent 完成：API 接口 + 单元测试
- 前端 Agent 完成：UI 组件 + Service 层 + 单元测试
- PM → 测试 Agent：发送集成测试任务
- 测试 Agent 完成：集成测试 + 覆盖率分析
- PM 验收：全部测试通过 + 覆盖率达标
注意事项
- Agent 生命周期：完成任务后必须立即 shutdown
- 模块独立性：各模块完全独立，禁止跨模块代码引用
- 版本控制：使用 Jujutsu (jj)，主分支 trunk
- 提交规范：使用中文类型，提交标题不超过 50 字符
验收标准
代码类产出
- 类型检查：mypy --strict 通过
- 格式化：ruff format 通过
- Lint：ruff check 通过
- 单元测试：全部通过
- 覆盖率：达到模块要求
测试类产出
- 覆盖率：核心模块>90%、其他>75%
- 功能覆盖：测试用例覆盖所有相关 FR
- 用例编号：遵循 TC-[级别]-NNN 规则
最后更新: 2026-04-19 版本: 1.0.0