Builder Agent

概述

这是一个自动生成安全工具和 DevOps 实用程序的开发智能体。ChatDev 2.0 的 7 个智能体协作完成从需求分析到部署的全过程自动化。

自我修正循环：发生错误时自动修正后重试（最多 3 次）

工作流程

创意发掘（GitHub Trending、CVE、安全新闻）
    ↓
Notion 队列注册（创意数据库）
    ↓
ChatDev 2.0 开发（7 个智能体协作）
    ├─ CEO：需求分析
    ├─ CPO：产品规划
    ├─ CTO：架构设计
    ├─ Programmer：代码生成
    ├─ Reviewer：代码审查
    ├─ Tester：测试生成
    └─ CTO Final：最终验证
    ↓
自动测试执行
    ↓
发生错误？ → 修正 → 重试（最多 3 次）
    ↓
GitHub 仓库创建并部署

主要功能

1. 创意发掘

• GitHub Trending：热门项目分析
• CVE 数据库：基于最新漏洞的工具
• 安全新闻：基于安全新闻的实用工具
• Notion 队列：自动注册创意

2. ChatDev 2.0 开发

7 个智能体协作：

3. 自我修正循环

测试执行
    ↓
发现错误
    ↓
分析错误 → 提出修正方案
    ↓
修改代码
    ↓
重新测试
    ↓
成功？ → 部署 / 失败？ → 重试（最多 3 次）

4. GitHub 自动部署

• 仓库创建：自动创建 GitHub 仓库
• 代码上传：自动推送完成的代码
• README 生成：自动文档化
• 发布版本：自动发布 v1.0.0 版本

安装方法

1. 克隆仓库

git clone --recursive https://github.com/rebugui/OpenClaw.git
cd OpenClaw/submodules/builder-agent

2. ChatDev 2.0 设置

cd ../chatdev-v2
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

3. 安装依赖

cd ../builder-agent
pip install -r requirements.txt

4. 设置环境变量

cp .env.example .env

编辑 .env 文件：

# GLM API（智谱 AI）
GLM_API_KEY=your_glm_api_key
GLM_BASE_URL=https://api.z.ai/api/coding/paas/v4

# GitHub
GITHUB_TOKEN=your_github_token
GITHUB_USERNAME=your_username

# Notion
NOTION_API_KEY=your_notion_api_key
NOTION_DATABASE_ID=your_database_id

# ChatDev
CHATDEV_URL=http://localhost:6400

5. 启动 ChatDev 服务器

cd ../chatdev-v2
python server_main.py --port 6400
# API: http://localhost:6400

使用方法

手动执行

1. 创意发掘

python main.py discovery

2. 开发执行

# 从 Notion 队列获取创意并开发
python main.py develop

# 开发特定项目
python main.py develop --project "cve-scanner"

3. 队列监控

python queue_monitor.py

注册到调度器

注册到 OpenClaw 调度器以自动执行：

# config.yaml
jobs:
  # 创意发掘（每天 08:00、20:00）
  - id: "builder_discovery"
    name: "Builder Discovery - 每天上午 8 点/下午 8 点发掘创意"
    enabled: true
    module: "submodules.builder-agent.main"
    class: "BuilderAgentV3"
    method: "run_discovery"
    trigger:
      type: "cron"
      day_of_week: "mon-sun"
      hour: "8,20"
      minute: 0

  # 开发队列处理（每 6 小时）
  - id: "builder_queue_processor"
    name: "Builder Queue Processor - 每 6 小时处理开发/改进队列"
    enabled: true
    module: "submodules.builder-agent.main"
    class: "BuilderAgentV3"
    method: "run_development_from_notion"
    trigger:
      type: "interval"
      hours: 6

  # 队列监控（每 6 小时）
  - id: "builder_queue_monitor"
    name: "Builder Queue Monitor - 每 6 小时检查队列状态并发送通知"
    enabled: true
    module: "modules.builder.queue_monitor"
    function: "main"
    trigger:
      type: "interval"
      hours: 6

配置文件

config.yaml

discovery:
  sources:
    - github_trending
    - cve_database
    - security_news
  max_ideas: 5
  keywords:
    - vulnerability
    - scanner
    - automation

development:
  max_retries: 3
  test_timeout: 300
  output_dir: "./projects"

chatdev:
  url: "http://localhost:6400"
  model: "glm-5"
  timeout: 1800

github:
  auto_publish: true
  private: false
  license: "MIT"

文件结构

builder-agent/
├── main.py              # 主执行文件
├── config.yaml          # 配置文件
├── .env.example         # 环境变量示例
├── requirements.txt     # 依赖
│
├── discoverer/          # 创意发掘
│   ├── github_trending.py
│   ├── cve_analyzer.py
│   └── news_monitor.py
│
├── orchestrator/        # 开发编排
│   ├── chatdev_client.py
│   ├── test_runner.py
│   └── github_publisher.py
│
├── improvement/         # 改进系统
│   └── improvement_pipeline.py
│
├── models/              # 数据模型
│   └── project.py
│
└── logs/                # 日志
    └── builder.log

Notion 数据库设置

创意数据库

• Title（标题）
• Status（选项：创意、开发中、测试中、已完成、失败）
• Priority（选项：高、中、低）
• Source（选项：GitHub、CVE、新闻）
• Created（创建日期）
• Repository（URL）

示例项目

生成的项目

1. secure_app – 安全设置自动化工具
2. cve-scanner-v2 – CVE 漏洞扫描器
3. file-integrity-monitor – 文件完整性监控

项目结构

cve-scanner-v2/
├── README.md
├── requirements.txt
├── setup.py
├── src/
│   ├── __init__.py
│   ├── main.py
│   └── utils.py
└── tests/
    ├── __init__.py
    └── test_main.py

成功/失败记录

成功的项目（2026-02-22 ~ 2026-02-23）

1. secure_app ✅（2026-02-22 18:08）
2. cve-scanner-v2 ✅（2026-02-23 12:17）
3. cve-scanner-v6 ✅（2026-02-23 13:41）
4. cve-scanner-v7 ✅（2026-02-23 13:46）
5. cve-scanner-v8 ✅（2026-02-23 14:10）

失败的项目

1. file-integrity-monitor ❌ – 测试失败
2. cve-scanner-v3 ❌ – 测试失败
3. cve-scanner-v5 ❌ – 测试失败

常见问题：测试代码与实现逻辑不匹配 → 需要改进提示词

问题排查

ChatDev 连接失败

# 检查 ChatDev 服务器状态
curl http://localhost:6400/health

# 重启服务器
cd ../chatdev-v2
python server_main.py --port 6400

测试失败

# 检查日志
tail -f logs/builder.log

# 手动运行测试
cd projects/cve-scanner-v2
pytest tests/

GitHub 部署失败

# 检查 Git 权限
ssh -T git@github.com

# 检查令牌权限
curl -H "Authorization: token {GITHUB_TOKEN}" https://api.github.com/user

依赖项

• Python 3.11+
• ChatDev 2.0
• GLM-5 API
• GitHub Personal Access Token
• Notion API

许可证

MIT License

参考

• 仓库：https://github.com/rebugui/builder-agent
• ChatDev 2.0：https://github.com/OpenBMB/ChatDev
• 主仓库：https://github.com/rebugui/OpenClaw