lawless/docs/ai-collab/AGENT-INVITATION-v2.md

115 行
3.9 KiB
Markdown

# Agent 加入协作指令v2
> 更新日期2026-07-03
> 当前阶段:设计文档已完成三轮审查修复,准备进入部署实施阶段
---
## 指令:发送给新 Agent
```
你好,欢迎加入「洪荒大陆」挂机修仙手游的协作开发!
## 项目概况
- 游戏类型:文字战斗/挂机/修仙RPG
- 平台Android、iOS、鸿蒙NEXT
- 技术栈Go + Nakama + PostgreSQL + Valkey + Nacos + Cocos Creator 3.x
- 当前阶段:设计文档已完成,准备部署到测试服务器
## 当前进度
✅ 设计文档35份GDDGDD-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. 认领任务 T030WSL环境部署
目标服务器win.xuqinmin.com (WSL2 Ubuntu)
连接方式ssh -i ~/.ssh/id_ed25519 -p 2224 xuqm@win.xuqinmin.com
开始工作!
```
---
## 使用说明
1. **完整邀请**:复制上面的完整指令发送给新 Agent
2. **快速启动**:如果 Agent 已经熟悉项目,使用快速启动指令
3. **任务更新**:根据实际进度更新任务列表