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. 验证环境

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

2. 启动环境

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

3. 启动实例

在各 tmux pane 中分别执行：

# 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	部署指南
docs/design/04-design-v0.4.md	完整设计文档
docs/04-quick-reference.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 跨实例通信

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

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

备选方案: 文件消息队列

# 发送消息
~/.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. 克隆仓库

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

2. 运行测试

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

3. 启动环境

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

详细步骤见 DEPLOYMENT.md

状态

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

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

待用户操作:

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

许可证

[待定]

联系方式

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