Auto-DevObserver：基于多Agent协作的智能代码审查与Issue诊断系统

Auto-DevObserver是一个开源AI Agent系统，通过监听GitHub Webhook事件，自动完成Issue分析与PR代码审查，采用多Agent协作架构结合AST级代码向量检索技术。

在现代软件开发中，代码审查和Issue管理是保障代码质量的关键环节。然而，随着项目规模扩大，人工审查面临效率瓶颈——安全漏洞可能被忽视，Bug报告的处理响应时间过长。传统的静态代码扫描工具虽然能发现部分问题，但难以理解复杂的业务逻辑和上下文。

Auto-DevObserver应运而生，这是一个基于大语言模型Agent的自动化GitHub仓库维护系统，通过多Agent协作架构，实现秒级Issue诊断和深度PR安全审查。

Auto-DevObserver采用模块化的多Agent设计，核心组件包括：

层级	技术选型
Web框架	FastAPI + Uvicorn
Agent编排	LangChain (ReAct Agent)
向量数据库	ChromaDB（本地持久化）
代码解析	Python AST模块（语义级切片）
GitHub交互	PyGithub
LLM后端	OpenAI-compatible API

系统通过监听GitHub Webhook事件触发不同的Agent工作流：

Issue诊断流程：

1. GitHub发送Webhook事件（Issue Opened）
2. FastAPI接收并分派后台任务
3. 从ChromaDB检索相关AST代码片段
4. Issue Agent接收Issue描述+代码上下文
5. LLM执行长链推理（Bug复现+修复建议）
6. 生成结构化分析报告并发布评论

PR安全审查流程：

1. GitHub发送Webhook事件（PR Opened/Sync）
2. 获取PR的Diff文件
3. 检索AST向量上下文
4. Security PR Agent执行白帽安全审查推理
5. 生成安全漏洞报告和修复建议
6. 发布PR Review评论

与传统基于文本的代码检索不同，Auto-DevObserver采用AST（抽象语法树）级别的语义切片。这种方法的优势在于：

• 语义理解：捕获代码的结构和逻辑，而非仅仅是字符串匹配
• 上下文关联：理解函数调用关系、变量作用域等程序语义
• 精准定位：能够识别传统静态扫描工具难以发现的复杂漏洞

代码向量库的构建流程：

# 1. 克隆目标仓库
git clone https://github.com/owner/repo.git /tmp/repo

# 2. 构建AST向量库
python -m app.core.rag_builder --repo owner/repo --path /tmp/repo

Auto-DevObserver/
├── app/
│   ├── main.py              # FastAPI Webhook路由入口+签名校验
│   ├── core/
│   │   ├── agent.py         # 多Agent编排
│   │   ├── rag_builder.py   # AST代码解析与向量库构建
│   │   └── github_client.py # PyGithub封装
│   ├── tools/
│   │   ├── code_search.py   # ChromaDB向量检索
│   │   └── security_scan.py # 安全规则匹配
│   └── prompts/
│       └── templates.py     # 核心提示词库
├── data/                    # ChromaDB持久化存储
├── .env.example
├── requirements.txt
└── Dockerfile

本地开发环境：

# 1. 克隆仓库
git clone https://github.com/your-org/Auto-DevObserver.git
cd Auto-DevObserver

# 2. 安装依赖
pip install -r requirements.txt

# 3. 配置环境变量
cp .env.example .env
# 编辑.env填入GITHUB_TOKEN、LLM_API_KEY等

# 4. 构建代码向量库
python -m app.core.rag_builder --repo owner/repo --path /tmp/repo

# 5. 启动服务
uvicorn app.main:app --host 0.0.0.0 --port 8000

GitHub Webhook配置：

1. 进入目标仓库 → Settings → Webhooks → Add webhook
2. Payload URL: https://your-server:8000/webhook
3. Content type: application/json
4. Secret: 与.env中GITHUB_WEBHOOK_SECRET一致
5. Events: 选择Issues和Pull requests