Code Refactor Agent - 基于 OpenClaw + Hermes 的全自动代码库重构系统

项目简介

生产级 AI Agent 系统，解决后端团队代码规范不统一、技术债积累、Code Review 效率低的问题。

核心价值：

• 定时自动扫描 monorepo
• 多 Agent 协作完成重构（Planner → Coder → Reviewer → Tester）
• 自动生成 PR + CI/CD 验证
• Hermes 长期记忆持续优化重构模式
• 支持 Claude 3.5 / DeepSeek / MiMo-V2.5-Pro

技术栈

• 运行框架：OpenClaw (自托管 Agent)
• 记忆系统：Hermes Agent (Nous Research)
• 工作流编排：LangGraph
• 静态分析：Ruff, Semgrep, SonarQube CLI
• Git 操作：GitPython + gh CLI
• 测试：pytest + coverage

快速开始

1. 环境准备

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

# 安装 OpenClaw (参考官方 https://openclaw.ai/)
# 安装 Hermes Agent (参考 https://hermes-agent.nousresearch.com/)

# 配置 GitHub CLI
gh auth login

2. 配置环境变量

cp .env.example .env
# 编辑 .env 填入 API Keys 和仓库路径

3. 运行每日扫描

python scripts/run_daily_scan.py

4. 触发单次重构任务

python -m workflows.langgraph_workflow --repo ./tests/sample_repo

🐳 Docker 一键部署（推荐生产方式）

快速启动（3 步）

# 1. 克隆/进入项目目录
cd code-refactor-agent

# 2. 配置环境变量（至少填 API Key 和仓库路径）
cp .env.example .env
# 编辑 .env 填入：
#   ANTHROPIC_API_KEY=sk-...
#   GITHUB_TOKEN=ghp_...
#   REPO_PATH=/path/to/your/monorepo   # 宿主机路径

# 3. 一键启动（包含 refactor-agent + redis + 持久化记忆）
docker-compose up -d

# 查看日志
docker-compose logs -f refactor-agent

生产部署命令

# 后台运行 + 自动重启
docker-compose up -d --build

# 查看状态
docker-compose ps

# 停止
docker-compose down

# 更新代码后重新构建
docker-compose up -d --build --force-recreate

关键特性

• 每日自动扫描：容器内 cron 每天 02:00 自动执行 run_daily_scan.py
• Hermes 记忆持久化：/app/memory volume 持久保存历史重构模式
• 真实 Git + PR：gh CLI 已预装，支持 GITHUB_TOKEN 认证
• OpenClaw 集成：在宿主机安装 OpenClaw 后，可直接注册 openclaw_skills/scanner.py 和 executor.py
• Hermes 集成：使用 memory/hermes_integration.py 持久化到 volume（完整 Hermes 可单独部署官方镜像）
• 安全默认：AUTO_MERGE=false，PR 必须人工审批

开发模式（热重载）

docker-compose -f docker-compose.yml -f docker-compose.override.yml up --build

与 OpenClaw + Hermes 完整集成建议

1. 宿主机安装 OpenClaw → 注册 skills（scanner + executor）
2. 单独部署 Hermes Agent（参考官方文档）
3. 本容器通过 HERMES_MEMORY_PATH 共享记忆 volume
4. OpenClaw 可通过 API 调用本容器的 LangGraph 工作流

项目结构

code-refactor-agent/
├── Dockerfile                    # Docker 镜像构建
├── docker-compose.yml            # 一键部署（agent + redis + 持久化）
├── docker-compose.override.yml   # 开发热重载配置
├── .dockerignore
├── openclaw_skills/              # OpenClaw Skills（Scanner + Executor）
│   ├── scanner.py
│   └── executor.py
├── agents/
│   └── supervisor.py
├── workflows/
│   └── langgraph_workflow.py
├── memory/
│   └── hermes_integration.py
├── config/prompts/
├── scripts/
│   ├── run_daily_scan.py
│   └── entrypoint.sh             # Docker 启动脚本（cron + gh 认证）
└── docs/
    └── architecture.md

真实 Executor 功能（新增）

• 使用 git worktree 实现零拷贝快速分支
• 支持 gh CLI（推荐）或 PyGithub 创建 PR
• 自动添加标签 ai-refactor、tech-debt
• 默认不自动合并（AUTO_MERGE=false），必须人工审批
• 失败时自动回滚 worktree

安全注意事项（生产必读）

• 默认不自动合并 PR：必须人工审批后合并
• 所有代码修改先在临时分支 + Docker 沙箱验证
• 敏感文件（.env, 密钥）加入 .gitignore + OpenClaw 黑名单
• 建议先在小仓库 / 单个模块试点

下一步计划

• 接入 MiMo-V2.5-Pro 降低成本
• 增加架构一致性规则引擎
• 可视化 Dashboard（重构历史 + Token 消耗）
• 支持多语言（Python / Go / Java）

贡献

欢迎提交 Issue 和 PR！本项目已在公司内部 + 2 个开源项目验证。

---

作者：AI Agent 重度开发者
更新日期：2026-04-28