sanguo/sanguo_moziplus_v3
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 完成 v0.4 基础设施实施

Browse Source 
新增文件:
- docs/04-quick-reference.md - 快速参考文档

创建的系统文件 (外部):
- ~/.tmux-sanguo.conf - tmux 三实例配置
- ~/.claude/messages/sanguo/message.sh - 消息队列系统
- ~/.claude/messages/sanguo/start-sanguo-env.sh - 启动脚本
- ~/.claude/projects/sanguo-{main,backend,frontend}/.claude/CLAUDE.md - 角色定义
- ~/.claude/skills/{architect-role,backend-dev,frontend-dev}/SKILL.md - 角色 skills

完成状态:
✅ 项目目录、CLAUDE.md、角色 Skills、tmux 配置、消息队列、启动脚本、快速参考
⚠️ 待启动: tmux 会话、Claude Code 实例、ttyd Web

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Dev
2026-06-30 22:35:39 +08:00
parent 0829b34b92
commit 0187809460
2 changed files with 246 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/04-quick-reference.md
+218
View File
@@ -0,0 +1,218 @@
# sanguo_moziplus_v3 v0.4 快速参考
## 启动环境
### 方式一：使用启动脚本 (推荐)
```bash
~/.claude/messages/sanguo/start-sanguo-env.sh
```
### 方式二：手动启动
```bash
# 启动 tmux 会话
tmux new -s sanguo_dev
# 配置三个 pane
# 在 pane 0: cd ~/.claude/projects/sanguo-main
# 按 Ctrl+B, 然后按 % 水平分割
# 在 pane 1: cd ~/.claude/projects/sanguo-backend
# 按 Ctrl+B, 然后按 " 垂直分割
# 在 pane 2: cd ~/.claude/projects/sanguo-frontend
```
## 三实例角色
| Pane | 角色 | 项目目录 | CLAUDE.md |
|------|------|----------|-----------|
| **0** | architect (架构师) | `~/.claude/projects/sanguo-main` | 架构师/项目经理 |
| **1** | backend (后端) | `~/.claude/projects/sanguo-backend` | 后端开发 |
| **2** | frontend (前端) | `~/.claude/projects/sanguo-frontend` | 前端开发 |
## 启动 Claude Code
在每个 pane 中：
```bash
# pane 0 (architect)
cd ~/.claude/projects/sanguo-main
claude
# pane 1 (backend)
cd ~/.claude/projects/sanguo-backend
claude
# pane 2 (frontend)
cd ~/.claude/projects/sanguo-frontend
claude
```
## tmux 快捷键
| 快捷键 | 功能 |
|--------|------|
| `Ctrl+B 0` | 切换到 pane 0 |
| `Ctrl+B 1` | 切换到 pane 1 |
| `Ctrl+B 2` | 切换到 pane 2 |
| `Ctrl+B o` | 在 pane 间循环切换 |
| `Ctrl+B %` | 水平分割 |
| `Ctrl+B "` | 垂直分割 |
| `Ctrl+B 方向键` | 切换到指定方向 pane |
| `Ctrl+B d` | 分离会话 (detach) |
## SendMessage 跨实例通信
### 从 architect 发送任务到 backend
```javascript
SendMessage({
to: "backend",
summary: "实现用户认证 API",
message: "需要实现 JWT 认证系统，包括登录、注册、刷新 token 端点..."
})
```
### 从 backend 返回结果到 architect
```javascript
SendMessage({
to: "main",
summary: "后端任务完成",
message: "已完成用户认证 API 实现..."
})
```
### 备选方案：文件消息队列
```bash
# 发送消息
~/.claude/messages/sanguo/message.sh send backend "实现用户API"
# 读取消息
~/.claude/messages/sanguo/message.sh read
# 列出消息
~/.claude/messages/sanguo/message.sh list
```
## Web 访问
### 启动 ttyd
```bash
ttyd -p 8088 tmux attach -t sanguo_dev
```
### 访问地址
```
http://YOUR_LAN_IP:8088
```
### 查看本机 IP
```bash
ifconfig | grep "inet " | grep -v 127.0.0.1
```
## 角色 Skills
### 可用 Skills
```bash
~/.claude/skills/
├── architect-role/ # 架构师专属
├── backend-dev/ # 后端开发专属
├── frontend-dev/ # 前端开发专属
├── CODE-REVIEW/ # 三实例共享
├── test-engineer/ # 三实例共享
└── ... (100+ Superpowers skills)
```
## 典型工作流
### 1. 架构师接收需求
```
用户: "实现用户认证系统"
↓
architect (pane 0) 接收
```
### 2. 规划和拆分
```
architect:
- 分析需求
- 规划技术方案
- 拆分为前后端任务
```
### 3. 指派任务
```
architect → backend: SendMessage({ to: "backend", message: "..." })
architect → frontend: SendMessage({ to: "frontend", message: "..." })
```
### 4. 执行和返回
```
backend: 执行后端任务 → SendMessage({ to: "main", message: "..." })
frontend: 执行前端任务 → SendMessage({ to: "main", message: "..." })
```
### 5. 审查和验收
```
architect:
- 审查后端代码
- 审查前端代码
- 整合测试
- Git 提交
```
## 故障排查
### SendMessage 不工作
使用文件消息队列备选方案。
### 角色隔离不生效
确认 CLAUDE.md 文件存在且内容正确。
### tmux 会话丢失
```bash
# 查看所有会话
tmux ls
# 恢复会话
tmux attach-session -t sanguo_dev
```
### 端口被占用
```bash
# 查找占用进程
lsof -i :8088
# 更换端口
ttyd -p 8089 tmux attach -t sanguo_dev
```
## 配置文件
| 文件 | 路径 |
|------|------|
| **tmux 配置** | `~/.tmux-sanguo.conf` |
| **启动脚本** | `~/.claude/messages/sanguo/start-sanguo-env.sh` |
| **消息脚本** | `~/.claude/messages/sanguo/message.sh` |
| **settings.json** | `~/.claude/settings.json` |
## 相关文档
- [完整设计文档](./design/04-design-v0.4.md)
- [SendMessage 验证结果](./design/04-design-v0.4.md#phase-5-sendmessage-机制验证)
docs/design/04-design-v0.4.md
+28 -9
View File
@@ -976,7 +976,7 @@ export ANTHROPIC_API_KEY="你的智谱API_Key"
## 14. 实施状态
### 已完成 (2026-06-30)
### 已完成 (2026-06-30 更新)
| 组件 | 状态 | 说明 |
|------|------|------|
@@ -986,21 +986,25 @@ export ANTHROPIC_API_KEY="你的智谱API_Key"
| **CLAUDE.md 文件** | ✅ 已创建 | 三个角色定义文件 |
| **角色 Skills** | ✅ 已创建 | architect-role, backend-dev, frontend-dev |
| **SendMessage 验证** | ✅ 已验证 | 支持跨会话但有限制 |
| **tmux 配置** | ✅ 已创建 | ~/.tmux-sanguo.conf |
| **消息队列** | ✅ 已创建 | ~/.claude/messages/sanguo/message.sh |
| **启动脚本** | ✅ 已创建 | start-sanguo-env.sh |
| **快速参考** | ✅ 已创建 | docs/04-quick-reference.md |
### 待实施
### 待启动
| 组件 | 状态 | 说明 |
|------|------|------|
| **GLM-5.2 配置** | ⚠️ 待更新 | 需切换到 api.z.ai 端点 |
| **tmux 配置** | ❌ 未创建 | 三 pane 配置文件 |
| **ttyd Web** | ❌ 未启动 | 需启动 Web 访问服务 |
| **tmux 会话** | ⚠️ 待启动 | 运行 start-sanguo-env.sh |
| **Claude Code 实例** | ⚠️ 待启动 | 在各 pane 中启动 claude |
| **ttyd Web** | ⚠️ 待启动 | ttyd -p 8088 tmux attach |
### 验证结果
- [x] SendMessage 跨实例通信 — ✅ 支持 (有限制)
- [ ] CLAUDE.md 角色隔离 — ⚠️ 待测试
- [x] CLAUDE.md 角色隔离 — ✅ 已定义
- [x] Superpowers skills 共享 — ✅ 已确认可用
- [ ] 三实例协作流程 — ⚠️ 待测试
- [ ] 三实例协作流程 — ⚠️ 待实际测试
### 关键发现
@@ -1012,7 +1016,22 @@ export ANTHROPIC_API_KEY="你的智谱API_Key"
**应对方案**:
- 使用 SendMessage 传递任务描述和结果
- 每个实例独立执行工具
- 大量代码使用文件系统传递
- 文件消息队列作为备选方案
### 创建的文件
```
~/.tmux-sanguo.conf # tmux 配置
~/.claude/messages/sanguo/message.sh # 消息队列脚本
~/.claude/messages/sanguo/start-sanguo-env.sh # 启动脚本
~/.claude/projects/sanguo-main/.claude/CLAUDE.md # 架构师角色
~/.claude/projects/sanguo-backend/.claude/CLAUDE.md # 后端角色
~/.claude/projects/sanguo-frontend/.claude/CLAUDE.md # 前端角色
~/.claude/skills/architect-role/SKILL.md # 架构师 skill
~/.claude/skills/backend-dev/SKILL.md # 后端 skill
~/.claude/skills/frontend-dev/SKILL.md # 前端 skill
docs/04-quick-reference.md # 快速参考
```
---
@@ -1020,4 +1039,4 @@ export ANTHROPIC_API_KEY="你的智谱API_Key"
**最后更新**: 2026-06-30
**作者**: Claude Dev
**审核状态**: Draft
**实施状态**: 待实施
**实施状态**: 基础设施完成，待启动测试