196 行
5.5 KiB
Markdown
196 行
5.5 KiB
Markdown
|
# 多Agent实时协作加入指南
|
|||
|
|
|
|||
|
|
> 本文档用于引导新agent加入洪荒大陆修仙手游设计审阅协作
|
|||
|
|
> 最后更新：2026-07-01
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 欢迎加入
|
|||
|
|
|
|||
|
|
你好，欢迎加入洪荒大陆修仙手游的设计审阅协作！
|
|||
|
|
|
|||
|
|
我们正在进行一项重要工作：**参考修仙小说，完善所有设计文档的逻辑、设定**。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 第一步：了解项目
|
|||
|
|
|
|||
|
|
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`
|
|||
|
|
- 内容：所有核心决策的索引
|
|||
|
|
|
|||
|
|
### 第二步：加入协作
|
|||
|
|
|
|||
|
|
1. **更新SYNC.md**：
|
|||
|
|
- 文件位置：`/Users/xuqinmin/Projects/NewsProject/lawless/docs/ai-collab/SYNC.md`
|
|||
|
|
- 操作：在"当前在线Agent"部分添加你的状态
|
|||
|
|
|
|||
|
|
添加格式：
|
|||
|
|
```
|
|||
|
|
| 你的Agent名 | 🟢 在线 | 当前时间 | 等待加入 |
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. **认领任务**：
|
|||
|
|
- 文件位置：`/Users/xuqinmin/Projects/NewsProject/lawless/docs/ai-collab/TASK-ASSIGN.md`
|
|||
|
|
- 操作：查看任务列表，认领一个任务
|
|||
|
|
|
|||
|
|
认领格式（在SYNC.md中添加）：
|
|||
|
|
```
|
|||
|
|
[你的Agent名 当前时间] 📋 认领任务 TXXX 任务名称
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. **开始工作**：
|
|||
|
|
- 按照任务说明进行审阅
|
|||
|
|
- 定期更新SYNC.md中的进度
|
|||
|
|
- 完成任务后标记为✅完成
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 协作规则
|
|||
|
|
|
|||
|
|
### 1. 实时同步规则
|
|||
|
|
|
|||
|
|
- **定期检查**：每5-10分钟检查一次SYNC.md
|
|||
|
|
- **及时更新**：状态变化时立即更新SYNC.md
|
|||
|
|
- **避免冲突**：修改文件前先检查文件锁状态
|
|||
|
|
- **及时释放**：完成任务后立即释放文件锁
|
|||
|
|
|
|||
|
|
### 2. 文件锁规则
|
|||
|
|
|
|||
|
|
修改文件前必须在SYNC.md的"文件锁状态"部分登记：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
| 文件路径 | 你的Agent名 | 当前时间 | 预计释放时间 |
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
修改完成后释放锁：
|
|||
|
|
```
|
|||
|
|
| 文件路径 | - | - | - |
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 沟通规则
|
|||
|
|
|
|||
|
|
- **日常沟通**：通过SYNC.md更新日志
|
|||
|
|
- **紧急沟通**：在SYNC.md中添加`[紧急]`标签
|
|||
|
|
- **详细讨论**：在BOARD.md中添加讨论内容
|
|||
|
|
|
|||
|
|
### 4. 版本控制规则
|
|||
|
|
|
|||
|
|
- **修改前**：读取文件最新版本
|
|||
|
|
- **修改后**：更新文档版本号
|
|||
|
|
- **记录变更**：在文档页脚添加changelog
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 任务流程
|
|||
|
|
|
|||
|
|
### 完整流程示例
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
1. [Agent 18:00] 🟢 上线，准备开始工作
|
|||
|
|
2. [Agent 18:05] 📋 认领任务 T001 境界体系修仙对齐
|
|||
|
|
3. [Agent 18:10] 🔒 锁定 docs/设计文档/GDD-02-底层核心机制.md
|
|||
|
|
4. [Agent 18:15] 🔄 进行中 T001，开始审阅
|
|||
|
|
5. [Agent 18:30] 🔄 进行中 T001，进度 30%
|
|||
|
|
6. [Agent 18:45] 🔄 进行中 T001，进度 60%
|
|||
|
|
7. [Agent 19:00] 🔄 进行中 T001，进度 90%
|
|||
|
|
8. [Agent 19:15] ✅ 完成 T001
|
|||
|
|
9. [Agent 19:15] 🔓 释放 docs/设计文档/GDD-02-底层核心机制.md
|
|||
|
|
10. [Agent 19:20] 📋 认领下一个任务
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 修仙小说参考
|
|||
|
|
|
|||
|
|
### 核心设定参考
|
|||
|
|
|
|||
|
|
1. **境界体系**：
|
|||
|
|
- 炼气→筑基→结丹→元婴→化神→合体→渡劫→大乘→飞升
|
|||
|
|
- 每个大境界分初期、中期、后期、大圆满
|
|||
|
|
|
|||
|
|
2. **功法体系**：
|
|||
|
|
- 品阶：天地玄黄、宇宙洪荒
|
|||
|
|
- 类型：心法、武技、神通、秘术
|
|||
|
|
- 来源：宗门传承、秘境探索、机缘巧合、自行领悟
|
|||
|
|
|
|||
|
|
3. **炼丹炼器**：
|
|||
|
|
- 丹药品阶：凡品、黄品、玄品、地品、天品、仙品
|
|||
|
|
- 法宝品阶：凡器、法器、灵器、仙器、神器
|
|||
|
|
- 流程：准备材料、开始炼制、控制火候、丹成/器成
|
|||
|
|
|
|||
|
|
4. **天道因果**：
|
|||
|
|
- 天道：宇宙运行的法则，不可违逆
|
|||
|
|
- 因果：善有善报，恶有恶报
|
|||
|
|
- 功德：行善积德，功德无量
|
|||
|
|
- 劫难：修炼路上的考验，渡劫是核心玩法
|
|||
|
|
- 心魔：内心深处的执念，需要克服
|
|||
|
|
|
|||
|
|
5. **宗门帮派**：
|
|||
|
|
- 宗门等级：一等宗门、二等宗门、三等宗门等
|
|||
|
|
- 宗门职位：掌门、长老、执事、内门弟子、外门弟子等
|
|||
|
|
- 宗门任务：日常任务、宗门任务、悬赏任务等
|
|||
|
|
|
|||
|
|
6. **战斗系统**：
|
|||
|
|
- 法宝对战：法宝是核心战斗手段
|
|||
|
|
- 神通对决：神通是高阶战斗手段
|
|||
|
|
- 阵法：布置阵法，困敌/杀敌
|
|||
|
|
- 禁制：设置禁制，保护/限制
|
|||
|
|
- 飞剑：飞剑是标志性战斗手段
|
|||
|
|
- 符箓：使用符箓，一次性攻击/防御
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 常见问题
|
|||
|
|
|
|||
|
|
### Q1: 如何与其他agent沟通？
|
|||
|
|
|
|||
|
|
A1: 通过SYNC.md更新日志，或在BOARD.md中添加讨论内容。
|
|||
|
|
|
|||
|
|
### Q2: 如何避免文件冲突？
|
|||
|
|
|
|||
|
|
A2: 修改文件前在SYNC.md中登记文件锁，修改完成后释放锁。
|
|||
|
|
|
|||
|
|
### Q3: 任务完成后如何交接？
|
|||
|
|
|
|||
|
|
A3: 在SYNC.md中标记任务完成，然后认领下一个任务。
|
|||
|
|
|
|||
|
|
### Q4: 遇到问题怎么办？
|
|||
|
|
|
|||
|
|
A4: 在SYNC.md中标记`⚠️ 问题`，并描述问题内容，寻求其他agent协助。
|
|||
|
|
|
|||
|
|
### Q5: 如何确保修改质量？
|
|||
|
|
|
|||
|
|
A5: 修改完成后，其他agent可以交叉复核，确保修改质量。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 联系方式
|
|||
|
|
|
|||
|
|
- **实时状态**：查看SYNC.md
|
|||
|
|
- **任务分配**：查看TASK-ASSIGN.md
|
|||
|
|
- **详细讨论**：查看BOARD.md
|
|||
|
|
- **项目记忆**：查看project_lawless.md
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 开始工作
|
|||
|
|
|
|||
|
|
现在，你可以：
|
|||
|
|
|
|||
|
|
1. 更新SYNC.md，标记你已上线
|
|||
|
|
2. 查看TASK-ASSIGN.md，认领一个任务
|
|||
|
|
3. 开始审阅，完善设计文档
|
|||
|
|
|
|||
|
|
祝你工作愉快！🎉
|
