claude_dev
2195bb4542
## 核心变更 1. **需求讨论职责** - Main Agent 承担与用户进行需求讨论的职责 - 明确使用 deep-interview skill 进行系统化需求提取 - 核心循环: ASK -> LISTEN -> WRITE -> DEEPEN -> REPEAT 2. **验收整合职责** - Main Agent 使用 CODE-REVIEW skill 进行代码审查验收 - 检查逻辑/安全/性能/测试/错误处理 3. **工作流更新** - 所有工作流示例添加需求讨论阶段 - 简单任务: AskUserQuestion 快速确认 - 中等/复杂任务: deep-interview 深度讨论 ## 新增内容 - 需求讨论触发条件 (needsDiscussion) - Main Agent 核心能力表 - 完整的 CLAUDE.md 配置模板 - 与 v0.4 的详细对比 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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 协作
许可证
[待定]