# 多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. 开始审阅，完善设计文档

祝你工作愉快！🎉
