claude_dev
0187809460
新增文件:
- 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>
219 lines
4.2 KiB
Markdown
219 lines
4.2 KiB
Markdown
# 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-机制验证)
|