115 行
3.9 KiB
Markdown
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份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. **任务更新**：根据实际进度更新任务列表
|
