# multi-agent-refactor-demo

**Repository Path**: wang_steadfast/multi-agent-refactor-demo

## Basic Information

- **Project Name**: multi-agent-refactor-demo
- **Description**: 基于多智能体协同（Multi-Agent）的复杂微服务演进与重构系统
- **Primary Language**: Python
- **License**: MIT-0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Multi-Agent Microservice Refactor Demo

一个可运行的最小闭环 Demo，用于展示多 Agent 如何协作完成微服务 API 迁移、测试验证、失败反思和 PR Draft 生成。

## Demo 场景

`order_service` 原本调用 `user_service.user_api.get_user_by_id`，现在需要迁移到新 API：

```python
get_user_profile(user_id)
```

运行工作流后，系统会自动：

1. 拆解 Issue。
2. 检索相关代码上下文。
3. 修改 `order_service/client.py`。
4. 更新 pytest 测试。
5. 运行测试。
6. 生成审查结果和 PR Draft。

## 快速启动

```bash
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
pytest demo_repo -q
```

如果 Windows 临时目录权限异常，可以指定项目内临时目录：

```powershell
$env:TEMP="$PWD\outputs\tmp"
$env:TMP=$env:TEMP
pytest demo_repo -q -p no:cacheprovider
```

运行一次完整工作流：

```bash
python run_demo.py
```

启动 FastAPI：

```bash
uvicorn app.main:app --reload
```

启动 Streamlit：

```bash
streamlit run app/ui/streamlit_app.py
```

## API

提交任务：

```http
POST /tasks
```

```json
{
  "issue": "迁移 order-service 中对 get_user_by_id 的调用，统一改为 get_user_profile，并补充相关测试。",
  "repo_path": "./demo_repo"
}
```

执行任务：

```http
POST /tasks/{task_id}/run
```

查询任务：

```http
GET /tasks/{task_id}
```

查询 PR Draft：

```http
GET /tasks/{task_id}/report
```

## 说明

当前版本优先保证可演示和可测试。Agent 默认使用规则化实现完成固定场景迁移，不依赖真实 LLM API；后续可以在 `app/agents/` 中替换为 OpenAI、Claude 或其他模型调用。