# Ai-agent

**Repository Path**: cheng_jiupeng/ai-agent

## Basic Information

- **Project Name**: Ai-agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-19
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code + Reasonix + Mimo 协作系统

## 🎯 工作流程

```
1. 用户打开 Claude Code，加载项目
   │
2. Claude Code 读取项目结构，分析需求
   │
3. Claude Code 生成执行计划（子任务列表）
   │
4. ⏸️  等待用户确认计划
   │
5. 用户确认后，选择执行工具（Reasonix / Mimo / 混合）
   │
6. Claude Code 调用对应的 CLI 工具执行任务
   │
7. 用户通过 Web UI 或命令行监控进度
   │
8. 执行完成后，Claude Code 汇总结果
```

## ✨ 核心特性

- ✅ **Claude Code 原生体验**：无需离开 Claude Code 界面
- ✅ **计划确认机制**：规划完成后等待用户确认
- ✅ **灵活分配**：可为每个子任务选择最佳执行工具
- ✅ **Web UI 监控**：实时查看所有 Agent 执行状态
- ✅ **跨平台**：Windows、macOS、Linux 通用

## 📦 安装

### 前提条件

1. **Claude Code CLI** 已安装
   ```bash
   npm install -g @anthropic-ai/claude-code
   ```

2. **Reasonix CLI** 已安装
   ```bash
   # 根据 Reasonix 官方文档安装
   ```

3. **Mimo CLI** 已安装
   ```bash
   # 根据 Mimo 官方文档安装
   ```

### 安装桥接工具

```bash
# 克隆项目
git clone <your-repo-url> claude-reasonix-bridge
cd claude-reasonix-bridge

# 安装依赖
npm install

# 安装为 Claude Code 插件
claude-code plugin install ./claude-reasonix-bridge
```

## 🚀 使用流程

### 第1步：在 Claude Code 中启动项目

```bash
# 打开 Claude Code
claude-code

# 加载你的项目
> /load-project ./my-project
```

### 第2步：让 Claude Code 规划任务

在 Claude Code 中输入：

```
请分析当前项目，并制定开发计划。
```

Claude Code 会：
1. 读取项目结构
2. 分析代码依赖
3. 生成子任务列表

**示例输出**：
```
📋 项目分析报告

项目类型: Node.js + Express + React
技术栈: TypeScript, PostgreSQL

执行计划:
1. [任务-001] 设计数据库 Schema → 预计10分钟
2. [任务-002] 实现用户注册 API → 预计30分钟
3. [任务-003] 实现用户登录 API → 预计30分钟
4. [任务-004] 编写单元测试 → 预计20分钟
5. [任务-005] 代码审查 → 预计15分钟

建议分配:
- 任务-001 ~ 004: 使用 Mimo (编码能力强)
- 任务-005: 使用 Reasonix (审查能力强)

是否确认执行？[Y/n]
```

### 第3步：确认并选择执行工具

**方式1：全部确认**
```
> Y
```

**方式2：自定义分配**
```
> /assign 任务-001 mimo
> /assign 任务-002 mimo
> /assign 任务-003 reasonix
> /assign 任务-004 mimo
> /assign 任务-005 reasonix
> /confirm
```

**方式3：交互式选择**
Claude Code 会逐个任务询问：
```
任务-001: 设计数据库 Schema
选择执行工具:
  1. Mimo
  2. Reasonix
  3. 跳过
选择: 1

任务-002: 实现用户注册 API
选择执行工具:
  ...
```

### 第4步：监控执行进度

**方式1：命令行监控**
```bash
# 新开一个终端
cd claude-reasonix-bridge
npm run monitor
```

**方式2：Web UI 监控**
```bash
# 启动 Web UI
npm run webui

# 浏览器打开
open http://localhost:3000
```

**Web UI 功能**：
- 📊 实时显示所有任务状态
- 🔍 查看每个 Agent 的详细日志
- ⏸️  暂停/继续任务
- 🔨 手动重试失败的任务

### 第5步：查看执行结果

执行完成后，Claude Code 会自动汇总：

```
✅ 所有任务执行完成！

执行摘要:
- 总任务数: 5
- 成功: 4
- 失败: 1 (任务-003)
- 总耗时: 1小时20分钟

失败任务详情:
- 任务-003: 用户登录 API
  - 错误: 数据库连接超时
  - 日志: logs/task-003-error.log
  - 建议: 检查数据库配置

是否重试失败任务？[Y/n]
```

## 🔧 配置

### 配置文件：`.claude-bridge.config.json`

```json
{
  "master": {
    "type": "claude-code",
    "model": "claude-sonnet-4",
    "role": "规划者"
  },
  "workers": {
    "reasonix": {
      "cli": "reasonix",
      "type": "code-review",
      "strength": "代码审查、架构设计"
    },
    "mimo": {
      "cli": "mimo",
      "type": "code-generation",
      "strength": "代码编写、调试"
    }
  },
  "workflow": {
    "requireConfirmation": true,
    "autoSelectWorker": false,
    "enableWebUI": true,
    "webUIPort": 3000
  }
}
```

### 自定义 Prompt

创建 `.claude/prompts/planner.md`：

```markdown
# 主脑规划 Prompt

你是一个项目规划专家。当用户请求你规划任务时：

1. 仔细阅读项目结构
2. 识别关键文件和依赖关系
3. 将任务分解为可独立执行的子任务
4. 为每个子任务推荐合适的执行工具：
   - Mimo: 适合代码编写、调试、测试
   - Reasonix: 适合代码审查、架构优化、性能分析
5. 等待用户确认后再执行
```

## 🌐 Web UI 截图（示意）

```
╔═══════════════════════════════════════════════════════════╗
║                  多Agent 执行监控面板                      ║
╠═══════════════════════════════════════════════════════════╣
║                                                             ║
║  项目: my-project                   状态: 执行中 ⚡          ║
║                                                             ║
║  ┌─────────────────────────────────────────────────────┐    ║
║  │ 任务列表                                          │    ║
║  ├─────────────────────────────────────────────────────┤    ║
║  │ ✅ 任务-001: 设计数据库 Schema    Mimo   2分钟    │    ║
║  │ 🔄 任务-002: 实现用户注册 API   Mimo   进行中    │    ║
║  │ ⏳ 任务-003: 实现用户登录 API   Reasonix  等待   │    ║
║  │ ⏳ 任务-004: 编写单元测试       Mimo   等待     │    ║
║  │ ⏳ 任务-005: 代码审查           Reasonix  等待   │    ║
║  └─────────────────────────────────────────────────────┘    ║
║                                                             ║
║  进度: █████████░░░░░░░░░░░ 40% (2/5)                  ║
║                                                             ║
║  [暂停所有]  [继续执行]  [查看日志]  [取消任务]           ║
║                                                             ║
╚═══════════════════════════════════════════════════════════╝
```

## 🔄 跨电脑使用

### 在新电脑上部署

```bash
# 1. 安装依赖 CLI
# 安装 Claude Code, Reasonix, Mimo

# 2. 克隆配置
git clone <your-repo-url>
cd claude-reasonix-bridge
npm install

# 3. 配置 API 密钥
cp .env.example .env
vim .env

# 4. 启动 Web UI
npm run webui

# 5. 在 Claude Code 中加载插件
claude-code plugin enable claude-reasonix-bridge
```

## 📁 项目结构

```
claude-reasonix-bridge/
├── package.json
├── .claude-bridge.config.json   # 主配置文件
├── src/
│   ├── index.js                 # 主入口
│   ├── bridge/                  # 桥接逻辑
│   │   ├── claude-bridge.js    # Claude Code 桥接
│   │   ├── reasonix-bridge.js  # Reasonix 桥接
│   │   └── mimo-bridge.js     # Mimo 桥接
│   ├── planner/                 # 规划模块
│   │   └── task-planner.js     # 任务规划器
│   ├── executor/                # 执行模块
│   │   └── task-executor.js    # 任务执行器
│   ├── monitor/                 # 监控模块
│   │   ├── cli-monitor.js      # CLI 监控
│   │   └── webui-server.js     # Web UI 服务器
│   └── utils/                  # 工具函数
├── webui/                      # Web UI 前端
│   ├── index.html
│   ├── app.js
│   └── style.css
├── .claude/                    # Claude Code 配置
│   └── prompts/
│       └── planner.md
└── logs/                       # 日志目录
```

## 🛠️ 高级用法

### 自定义任务类型

编辑 `config/task-types.json`：

```json
{
  "code-generation": {
    "preferredWorker": "mimo",
    "description": "代码编写任务"
  },
  "code-review": {
    "preferredWorker": "reasonix",
    "description": "代码审查任务"
  }
}
```

### 批量执行模式

```bash
# 跳过确认，直接执行
claude-code --no-confirm "开发用户管理系统"
```

### 只规划不执行

```bash
# 只生成计划，不执行
claude-code --plan-only "开发用户管理系统"
```

## 🐛 故障排查

### 问题1：Reasonix CLI 未找到

```bash
# 测试 Reasonix 是否可用
reasonix --version

# 如果未安装，根据官方文档安装
```

### 问题2：Mimo CLI 未找到

```bash
# 测试 Mimo 是否可用
mimo --version

# 如果未安装，根据官方文档安装
```

### 问题3：Web UI 无法访问

```bash
# 检查端口是否被占用
lsof -i :3000  # macOS/Linux
netstat -ano | findstr :3000  # Windows

# 修改端口
vim .claude-bridge.config.json
# 修改 webUIPort 为其他端口
```

## 📚 参考资料

- Claude Code 文档: https://docs.anthropic.com/claude-code
- Reasonix 文档: [官方文档链接]
- Mimo 文档: [官方文档链接]

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

MIT License