sanguo_moziplus_v3/docs/04-quick-reference.md

sanguo_moziplus_v3 v0.4 快速参考

启动环境

方式一：使用启动脚本 (推荐)

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

方式二：手动启动

# 启动 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 中：

# 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

SendMessage({
  to: "backend",
  summary: "实现用户认证 API",
  message: "需要实现 JWT 认证系统，包括登录、注册、刷新 token 端点..."
})

从 backend 返回结果到 architect

SendMessage({
  to: "main",
  summary: "后端任务完成",
  message: "已完成用户认证 API 实现..."
})

备选方案：文件消息队列

# 发送消息
~/.claude/messages/sanguo/message.sh send backend "实现用户API"

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

# 列出消息
~/.claude/messages/sanguo/message.sh list

Web 访问

启动 ttyd

ttyd -p 8088 tmux attach -t sanguo_dev

访问地址

http://YOUR_LAN_IP:8088

查看本机 IP

ifconfig | grep "inet " | grep -v 127.0.0.1

角色 Skills

可用 Skills

~/.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 会话丢失

# 查看所有会话
tmux ls

# 恢复会话
tmux attach-session -t sanguo_dev

端口被占用

# 查找占用进程
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

相关文档

• 完整设计文档
• SendMessage 验证结果