# sanguo_moziplus_v3

**三实例 AI 协作开发环境** - 基于 Claude Code + GLM-5.2

## 版本

**v0.4** - 设计和基础设施完成 (2026-06-30)

## 概述

sanguo_moziplus_v3 是一个多实例 AI 协作开发环境，通过三个独立的 Claude Code 实例协同工作，模拟真实开发团队中的不同角色：

```
┌─────────────────────────────────────────────┐
│           tmux sanguo_dev 会话              │
│                                             │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐ │
│  │ architect │  │ backend  │  │ frontend │ │
│  │ 架构师    │  │ 后端开发  │  │ 前端开发  │ │
│  │ pane #0   │  │ pane #1   │  │ pane #2   │ │
│  └───────────┘  └───────────┘  └───────────┘ │
│                                             │
│  共享 Superpowers Skills (~/.claude/skills/) │
│  共享 GLM-5.2 后端                          │
└─────────────────────────────────────────────┘
```

## 特性

- **三实例协作**: 架构师、后端、前端三个角色独立运行
- **角色隔离**: 通过 CLAUDE.md 定义清晰的角色边界
- **共享技能库**: 所有实例共享 Superpowers skills
- **跨实例通信**: SendMessage + 文件消息队列
- **Web 访问**: 通过 ttyd 实现浏览器访问

## 快速开始

### 1. 验证环境

```bash
~/.claude/messages/sanguo/test-sanguo-env.sh
```

### 2. 启动环境

```bash
~/.claude/messages/sanguo/start-sanguo-env.sh
```

### 3. 启动实例

在各 tmux pane 中分别执行：

```bash
# pane 0
cd ~/.claude/projects/sanguo-main && claude

# pane 1
cd ~/.claude/projects/sanguo-backend && claude

# pane 2
cd ~/.claude/projects/sanguo-frontend && claude
```

## 文档

| 文档 | 描述 |
|------|------|
| [DEPLOYMENT.md](./DEPLOYMENT.md) | 部署指南 |
| [docs/design/04-design-v0.4.md](./docs/design/04-design-v0.4.md) | 完整设计文档 |
| [docs/04-quick-reference.md](./docs/04-quick-reference.md) | 快速参考 |
| [docs/05-example-workflows.md](./docs/05-example-workflows.md) | 示例工作流 |

## 项目结构

```
sanguo_moziplus_v3/
├── DEPLOYMENT.md                    # 部署指南
├── README.md                        # 本文件
├── docs/
│   ├── design/
│   │   ├── 02-design-v0.2.md       # v0.2 设计 (CCB 方案)
│   │   ├── 03-design-v0.3.md       # v0.3 设计 (内置 Agent)
│   │   └── 04-design-v0.4.md       # v0.4 设计 (三实例方案) ✅
│   ├── 04-quick-reference.md       # 快速参考
│   └── 05-example-workflows.md     # 示例工作流
│
├── ~/.claude/projects/              # 项目目录
│   ├── sanguo-main/                # 架构师项目
│   │   └── .claude/CLAUDE.md       # 架构师角色定义
│   ├── sanguo-backend/             # 后端项目
│   │   └── .claude/CLAUDE.md       # 后端角色定义
│   └── sanguo-frontend/            # 前端项目
│       └── .claude/CLAUDE.md       # 前端角色定义
│
├── ~/.claude/skills/               # 角色 Skills
│   ├── architect-role/             # 架构师 skill
│   ├── backend-dev/                # 后端 skill
│   └── frontend-dev/               # 前端 skill
│
└── ~/.claude/messages/sanguo/      # 系统脚本
    ├── start-sanguo-env.sh         # 启动脚本
    ├── message.sh                  # 消息队列
    └── test-sanguo-env.sh          # 测试脚本
```

## 角色

### architect (架构师/项目经理)

**项目**: `~/.claude/projects/sanguo-main`

**职责**:
- 需求分析和理解
- 架构设计和技术选型
- 任务拆分和优先级排序
- 代码审核和质量把关
- 最终验收和 Git 提交管理

**限制**: 绝对不亲自编写代码

### backend (后端开发)

**项目**: `~/.claude/projects/sanguo-backend`

**职责**:
- 服务端代码实现
- API 设计和实现
- 数据库设计和 Migration
- 单元测试和集成测试

**限制**: 只处理后端任务，拒绝前端任务

### frontend (前端开发)

**项目**: `~/.claude/projects/sanguo-frontend`

**职责**:
- 前端组件开发
- 页面布局和样式
- 用户交互逻辑
- 浏览器兼容性

**限制**: 只处理前端任务，拒绝后端任务

## 协作方式

### SendMessage 跨实例通信

```javascript
// architect → backend
SendMessage({
  to: "backend",
  summary: "实现用户 API",
  message: "需要实现用户查询 API，包括..."
})

// backend → architect
SendMessage({
  to: "main",
  summary: "后端完成",
  message: "已完成用户 API，文件包括..."
})
```

### 备选方案: 文件消息队列

```bash
# 发送消息
~/.claude/messages/sanguo/message.sh send backend "任务内容"

# 读取消息
~/.claude/messages/sanguo/message.sh read
```

## 技术栈

| 组件 | 技术/版本 |
|------|----------|
| **Claude Code** | v2.1.187+ |
| **Superpowers** | Marketplace |
| **GLM-5.2** | 智谱 AI |
| **ttyd** | v1.7.7 |
| **tmux** | v3.7 |

## 环境要求

- macOS 或 Linux
- Claude Code v2.1.166+
- tmux
- ttyd
- Bash

## 安装

### 1. 克隆仓库

```bash
git clone http://192.168.2.154:3000/sanguo/sanguo_moziplus_v3.git
cd sanguo_moziplus_v3
```

### 2. 运行测试

```bash
~/.claude/messages/sanguo/test-sanguo-env.sh
```

### 3. 启动环境

```bash
~/.claude/messages/sanguo/start-sanguo-env.sh
```

详细步骤见 [DEPLOYMENT.md](./DEPLOYMENT.md)

## 状态

**v0.4 设计和基础设施: ✅ 完成**

- ✅ 完整设计文档
- ✅ 快速参考文档
- ✅ 示例工作流文档
- ✅ 部署指南
- ✅ 三实例项目结构
- ✅ 角色 Skills
- ✅ tmux 配置
- ✅ 启动脚本
- ✅ 消息队列系统
- ✅ 环境测试脚本

**待用户操作**:

- ⏳ 启动 tmux 环境
- ⏳ 在各 pane 启动 Claude Code
- ⏳ 测试 SendMessage 协作

## 许可证

[待定]

## 联系方式

- 仓库: http://192.168.2.154:3000/sanguo/sanguo_moziplus_v3