# Agent 加入协作指令（v2）

> 更新日期：2026-07-03
> 当前阶段：设计文档已完成三轮审查修复，准备进入部署实施阶段

---

## 指令：发送给新 Agent

```
你好，欢迎加入「洪荒大陆」挂机修仙手游的协作开发！

## 项目概况
- 游戏类型：文字战斗/挂机/修仙RPG
- 平台：Android、iOS、鸿蒙NEXT
- 技术栈：Go + Nakama + PostgreSQL + Valkey + Nacos + Cocos Creator 3.x
- 当前阶段：设计文档已完成，准备部署到测试服务器

## 当前进度
✅ 设计文档：35份GDD（GDD-00~GDD-34），已完成三轮审查修复（116项问题已处理）
✅ 需求文档：3份PRD
✅ 技术文档：6份TDD
✅ 代码骨架：服务端28个Go模块 + 客户端14个TS脚本
✅ 数据库：4个迁移脚本
✅ 部署方案：WSL部署脚本和指南已准备好

## 你需要做的事情

### 第一步：了解项目（必须）
1. 读取项目记忆：`/Users/xuqinmin/.claude-mimo/projects/-Users-xuqinmin-Projects-NewsProject/memory/project_lawless.md`
2. 读取协作约定：`/Users/xuqinmin/Projects/NewsProject/lawless/docs/协作约定.md`
3. 读取决策总索引：`/Users/xuqinmin/Projects/NewsProject/lawless/docs/设计文档/GDD-00-决策总索引.md`
4. 读取同步状态：`/Users/xuqinmin/Projects/NewsProject/lawless/docs/ai-collab/SYNC.md`

### 第二步：加入协作
在 SYNC.md 的"当前在线Agent"部分添加你的状态：
```
| 你的Agent名 | 🟢 在线 | 当前时间 | 等待加入 |
```

### 第三步：认领任务
当前可选任务：

**P0 - 部署实施（优先）**
- T030: WSL环境部署（安装Go + 启动Docker服务 + 数据库迁移）
- T031: 服务端编译与测试（go build + 单元测试）
- T032: 客户端Cocos场景绑定

**P1 - 系统完善**
- T033: 剩余TODO填充（约15个次要模块）
- T034: 数值平衡联调（GDD-21参数验证）
- T035: API接口测试（gRPC/REST）

**P2 - 内容生成**
- T036: 模板池建设（技能/副本/怪物战报模板）
- T037: 预生成内容库（批量生成事件/描述）
- T038: 缓存池实现（L1/L2/L3三级缓存）

### 第四步：开始工作
1. 在SYNC.md中记录你的任务认领
2. 按照任务说明执行
3. 定期更新进度到SYNC.md
4. 完成后标记为✅完成

## 重要原则
- ⚠️ 修改设计文档时只完善不删除，删除必须经用户确认
- ⚠️ 开工前必读GDD-00决策总索引，确认最新决策编号
- ⚠️ 修改文件前在SYNC.md登记文件锁，完成后释放
- ⚠️ 新增决策编号从✅157开始顺延

## 协作文件说明
| 文件 | 用途 |
|------|------|
| SYNC.md | 实时状态同步（在线Agent/任务状态/文件锁/更新日志） |
| BOARD.md | 讨论板（详细讨论/设计决策） |
| JOIN-GUIDE.md | 详细加入指南 |
| TASK-ASSIGN.md | 任务分配表 |

## 当前文档版本总览
GDD-00 v2.1 / GDD-01 v2.12 / GDD-02 v4.3 / GDD-03 v2.2 / GDD-04 v1.12
GDD-05 v1.18 / GDD-06 v1.16 / GDD-07 v2.5 / GDD-08 v1.11 / GDD-09 v1.7
GDD-12 v1.8 / GDD-13 v1.7 / GDD-14 v1.6 / GDD-15 v1.8 / GDD-16 v1.7
GDD-17 v2.4 / GDD-18 v2.3 / GDD-19 v1.4 / GDD-22 v1.3 / GDD-23 v1.5
GDD-25 v1.4 / GDD-27 v1.3 / GDD-28 v2.3 / GDD-31 v1.3

请回复确认是否加入，并告知你想认领的任务。
```

---

## 快速启动指令（如果 Agent 已熟悉项目）

```
紧急任务：洪荒大陆部署实施

立即执行：
1. 读取 docs/ai-collab/SYNC.md 了解当前状态
2. 读取 docs/部署指南.md 了解部署步骤
3. 在SYNC.md中添加：[你的Agent名 当前时间] 🟢 上线
4. 认领任务 T030：WSL环境部署

目标服务器：win.xuqinmin.com (WSL2 Ubuntu)
连接方式：ssh -i ~/.ssh/id_rsa -p 2222 xuqm@jenkins.xuqinmin.com → wsl -d Ubuntu

开始工作！
```

---

## 使用说明

1. **完整邀请**：复制上面的完整指令发送给新 Agent
2. **快速启动**：如果 Agent 已经熟悉项目，使用快速启动指令
3. **任务更新**：根据实际进度更新任务列表