# 🤖 AI Agent Collaboration Framework

> **从模拟到真实：让每个AI Agent都拥有独立的Git身份，实现真正的实盘协作**

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![Git 2.20+](https://img.shields.io/badge/git-2.20+-orange.svg)](https://git-scm.com/)
[![Tests](https://github.com/your-org/agent-collaboration-framework/workflows/Tests/badge.svg)](https://github.com/your-org/agent-collaboration-framework/actions)

## 🎯 核心理念

**不是让AI Agent假装协作，而是让每个Agent都有真实的Git身份：独立的SSH密钥、GPG签名、用户名和邮箱，实现可追溯的团队协作历史。**

## ✨ 特性亮点

### 🔐 真实身份系统
- ✅ 每个Agent拥有独立的SSH密钥对
- ✅ 独立的GPG签名密钥（可选）
- ✅ 独立的Git配置（用户名、邮箱）
- ✅ 可追溯的完整提交历史

### 🤖 预定义Agent角色
| Agent | 角色 | 专长 |
|-------|------|------|
| `claude-ai` | 架构师 | 系统设计、技术选型 |
| `gemini-dev` | 开发者 | 核心功能开发 |
| `qwen-ops` | 运维 | 部署脚本、监控 |
| `llama-research` | 研究员 | 性能分析、优化 |

### 🚀 一键启动
```bash
curl -fsSL https://raw.githubusercontent.com/your-org/agent-collaboration-framework/main/install.sh | bash
```

## 🏃‍♂️ 快速开始

### 1. 安装
```bash
git clone https://github.com/your-org/agent-collaboration-framework.git
cd agent-collaboration-framework
./install.sh
```

### 2. 运行演示
```bash
# 启动多Agent协作演示
python3 examples/basic/demo_collaboration.py

# 查看Agent状态
./agents/stats.sh
```

### 3. 手动协作
```bash
# 切换到架构师Agent
./agents/switch_agent.sh claude-ai
echo "# 系统架构设计" > docs/architecture.md
git add docs/architecture.md
git commit -m "添加系统架构设计文档"

# 切换到开发者Agent
./agents/switch_agent.sh gemini-dev
echo "console.log('Hello World');" > src/app.js
git add src/app.js
git commit -m "实现基础应用功能"
```

## 📊 实时协作展示

### 当前Agent活动
```bash
$ ./agents/stats.sh

🔍 Agent协作统计:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Agent: claude-ai (架构师)
  提交次数: 5
  代码行数: 120
  主要贡献: 架构设计, 文档编写

Agent: gemini-dev (开发者)
  提交次数: 8
  代码行数: 350
  主要贡献: 核心功能, 单元测试

Agent: qwen-ops (运维)
  提交次数: 3
  代码行数: 80
  主要贡献: 部署脚本, 配置管理

Agent: llama-research (研究员)
  提交次数: 2
  代码行数: 60
  主要贡献: 性能分析, 优化建议
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

## 🏗️ 架构设计

### 核心组件
```
agent-collaboration-framework/
├── agents/                    # Agent身份管理
│   ├── identity_manager.py   # 身份管理系统
│   ├── switch_agent.sh       # Agent切换工具
│   └── stats.sh             # 统计工具
├── src/                     # 核心源码
├── examples/                # 使用示例
├── tests/                   # 测试套件
└── docs/                    # 完整文档
```

### 身份管理流程
```mermaid
graph TD
    A[启动项目] --> B[初始化Agent]
    B --> C[生成SSH密钥]
    B --> D[配置Git身份]
    C --> E[Agent切换]
    D --> E
    E --> F[真实Git提交]
    F --> G[可追溯历史]
```

## 🎭 使用场景

### 1. 🏢 个人项目增强
- 模拟大型团队协作
- 代码审查练习
- 架构设计验证

### 2. 🎓 教学演示
- Git协作教学
- 敏捷开发实践
- 代码审查培训

### 3. 🏭 企业级应用
- AI辅助代码审查
- 多角色代码分析
- 自动化文档生成

## 🔧 高级功能

### 自定义Agent角色
```bash
# 创建新Agent角色
./scripts/create_agent.sh "rust-expert" "Rust专家" "rust@ai-collaboration.local"
```

### 批量操作
```bash
# 所有Agent同时更新文档
./scripts/bulk_commit.sh "更新文档" --agents="all"
```

### 代码审查模式
```bash
# 启动审查模式
./scripts/review_mode.sh
```

## 🐳 Docker部署

```bash
# 使用Docker快速启动
docker run -it \
  -v $(pwd):/workspace \
  agent-collaboration:latest

# 使用Docker Compose
docker-compose up -d
```

## 📈 路线图

### Phase 1: 核心功能 ✅
- [x] 多Agent身份管理
- [x] Git协作演示
- [x] 基础工具脚本
- [x] Docker支持

### Phase 2: 增强协作 🚧
- [ ] Web界面管理
- [ ] 实时协作监控
- [ ] 代码质量分析
- [ ] 权限管理系统

### Phase 3: 企业级 🎯
- [ ] 审计日志
- [ ] 集成CI/CD
- [ ] 高级分析
- [ ] 云原生部署

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 快速贡献
1. 🍴 Fork项目
2. 🌿 创建功能分支
3. 📝 提交更改
4. 🚀 创建Pull Request

### 开发环境
```bash
git clone https://github.com/your-org/agent-collaboration-framework.git
cd agent-collaboration-framework
pip install -r requirements-dev.txt
pytest tests/
```

## 📚 完整文档

- 📖 [安装指南](SETUP.md)
- 🚀 [快速开始](QUICK_START.md)
- 🤝 [贡献指南](CONTRIBUTING.md)
- 📊 [API文档](docs/api/README.md)
- 🎓 [教程](docs/guides/README.md)

## 📞 社区支持

- 💬 [GitHub Discussions](https://github.com/your-org/agent-collaboration-framework/discussions)
- 🐛 [Issue追踪](https://github.com/your-org/agent-collaboration-framework/issues)
- 🌟 [Star历史](https://star-history.com/#your-org/agent-collaboration-framework)

## 📄 许可证

[MIT许可证](LICENSE) - 详见许可证文件。

---

<div align="center">

**🚀 从模拟到真实，从工具到伙伴。**

[![Star History Chart](https://api.star-history.com/svg?repos=your-org/agent-collaboration-framework&type=Date)](https://star-history.com/#your-org/agent-collaboration-framework&Date)

</div>