# AgentTeamExperience

**Repository Path**: alienity/agent-team-experience

## Basic Information

- **Project Name**: AgentTeamExperience
- **Description**: 记录和迭代AgentTeams的使用经验，使用opencode
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Team Experience

基于 OpenCode AgentTeams 的多智能体协作开发项目经验库。

## 项目简介

本项目提供一套完整的多代理协作开发系统，通过精细化的 Agent 分工和 Workspace 隔离机制，实现高效、可扩展的自动化开发流程。

## 核心特性

- **多 Agent 协作**：10+ 专业 Agent 覆盖产品分析、开发、测试、经验总结全流程
- **Workspace 隔离**：独立工作空间减少 90%+ Token 消耗，支持并行开发
- **自动化上下文管理**：智能缓存和恢复，长任务不丢失上下文
- **经验学习机制**：每次任务自动沉淀知识，避免重复踩坑
- **精细化分工**：工具/引擎/渲染 三类开发 Agent 各司其职

## Agent 团队

| 角色 | 类型 | 职责 |
|------|------|------|
| Team Leader | Primary | 分析需求，协调各子代理，流程控制 |
| PM Analyst | Subagent | 需求细化，产出技术规格，自动创建 Workspace |
| Developer | Subagent | 全栈协调，集成各 Workspace 输出 |
| Tools Developer | Subagent | 工具函数、辅助类、通用方法 |
| Engine Developer | Subagent | 业务逻辑、数据处理、状态管理 |
| Renderer Developer | Subagent | UI 组件、页面布局、交互效果 |
| QA Tester | Subagent | 测试验证，质量评估，Bug 追踪 |
| Experience Learner | Subagent | 经验总结，知识沉淀 |
| Context Manager | Subagent | 上下文监控，缓存管理 |
| Workspace Manager | Subagent | 创建、分配、监控工作空间 |

## 快速开始

### 1. 启动 OpenCode

```bash
opencode
```

### 2. 切换 Agent

按 `Tab` 键切换到 `team-leader` 代理

### 3. 描述需求

```
我要添加一个用户登录功能，支持邮箱和密码，需要验证码
```

### 4. 自动协作

Team Leader 会自动协调各子代理完成：
```
需求分析 → Workspace 分配 → 并行开发 → 集成 → 测试 → 经验总结
```

## 工作流程

```
┌─────────────┐
│   用户需求   │
└──────┬──────┘
       ▼
┌─────────────┐     ┌─────────────┐
│ Team Leader │ ──→ │ PM Analyst  │
│  (Primary)  │     │  技术规格   │
└──────┬──────┘     └──────┬──────┘
       │                   │
       │         ┌─────────┼─────────┐
       │         ▼         ▼         ▼
       │   ┌─────────┐ ┌───────┐ ┌──────────┐
       └──→│  Tools  │ │Engine │ │ Renderer │
           │  Dev    │ │  Dev  │ │   Dev    │
           └────┬────┘ └───┬───┘ └────┬─────┘
                │          │          │
                └──────────┼──────────┘
                           ▼
                    ┌─────────────┐
                    │  Developer  │
                    │  (协调集成) │
                    └──────┬──────┘
                           ▼
                    ┌─────────────┐
                    │  QA Tester  │
                    │  测试验证   │
                    └──────┬──────┘
                           │
                    ┌──────┴──────┐
                    │  发现 Bug?  │──→ 退回开发修复
                    └──────┬──────┘
                           ▼
                    ┌─────────────┐
                    │ Experience  │
                    │   Learner   │
                    │  经验总结   │
                    └──────┬──────┘
                           ▼
                    ┌─────────────┐
                    │  知识库更新  │
                    └─────────────┘
```

## 目录结构

```
opencodeproj/
├── opencode.json              # Agent 配置
├── AGENTS.md                  # 开发规范指南
└── .opencode/
    ├── agents/                # Agent 定义
    ├── prompts/               # Agent 提示词
    ├── plans/                 # 任务计划
    ├── cache/                 # 上下文缓存
    ├── context/               # 长期记忆
    ├── state/                 # 状态文件
    └── skills/                # 可复用技能
└── .experience/               # 经验知识库
    ├── 流程规范/
    └── 经验总结模板.md
```

## 核心机制

### Workspace 隔离

每个任务创建独立 Workspace：
- 只加载相关文件
- 减少 Token 消耗 90%+
- 支持并行开发
- 清晰的任务边界

### 上下文管理

全自动缓存和恢复：
- 上下文 > 75% 自动缓存
- 压缩后自动恢复
- 无需手动操作

### 经验学习

每次任务后自动：
- 总结技术实现
- 记录问题案例
- 沉淀最佳实践
- 更新知识库

## 开发规范

详细开发规范请参考：
- [`opencodeproj/AGENTS.md`](opencodeproj/AGENTS.md) - 代码规范、Git 工作流、测试指南
- [`opencodeproj/.opencode/README.md`](opencodeproj/.opencode/README.md) - AgentTeams 完整使用指南

## 常用命令

```bash
# 安装依赖
npm install

# 构建
npm run build

# 测试
npm test

# 代码检查
npm run lint

# 格式化
npm run lint:fix

# 类型检查
npm run typecheck
```

## Git 工作流

### 提交规范

```bash
# 格式：<type>: <description>
git commit -m "feat: add user login feature"
git commit -m "fix: resolve authentication bug"
git commit -m "docs: update API documentation"
```

### 类型说明

- `feat`: 新功能
- `fix`: Bug 修复
- `docs`: 文档更新
- `style`: 代码格式
- `refactor`: 重构
- `test`: 测试相关
- `chore`: 构建/工具

## 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE)。

## 相关链接

- [OpenCode 文档](https://opencode.ai)
- [AgentTeams 配置指南](opencodeproj/.opencode/README.md)