lawless/docs/ai-collab/COLLAB-README.md

# 多Agent实时协作方案

> 项目：洪荒大陆修仙手游
> 目标：参考修仙小说，完善所有设计文档的逻辑、设定
> 创建时间：2026-07-01

---

## 方案概述

本方案实现多agent实时同步协作，共同完成洪荒大陆修仙手游的设计审阅工作。

### 核心特性

- ✅ **实时同步**：通过SYNC.md实现状态实时同步
- ✅ **任务管理**：通过TASK-ASSIGN.md实现任务分配与追踪
- ✅ **文件锁**：防止并发修改冲突
- ✅ **自动监控**：通过WATCHDOG.sh自动监控文件变化
- ✅ **详细日志**：记录所有协作活动

---

## 文件结构

```
docs/ai-collab/
├── COLLAB-README.md      # 本文件，协作方案总览
├── JOIN-GUIDE.md         # 新agent加入指南
├── SYNC.md               # 实时状态同步文件
├── TASK-ASSIGN.md        # 任务分配表
├── WATCHDOG.sh           # 文件监控脚本
├── BOARD.md              # 消息板（已有）
├── PLAN-*.md             # 计划文件（已有）
└── RISK-*.md             # 风险审计（已有）
```

---

## 快速开始

### 对于新agent

1. **阅读加入指南**：
   ```bash
   cat docs/ai-collab/JOIN-GUIDE.md
   ```

2. **更新SYNC.md**：
   - 在"当前在线Agent"部分添加你的状态
   - 格式：`| Agent名 | 🟢 在线 | 当前时间 | 等待加入 |`

3. **认领任务**：
   - 查看TASK-ASSIGN.md中的任务列表
   - 在SYNC.md中添加认领记录

4. **开始工作**：
   - 按照任务说明进行审阅
   - 定期更新SYNC.md中的进度

### 对于现有agent

1. **检查SYNC.md**：
   - 查看当前在线agent
   - 查看任务认领状态

2. **认领新任务**：
   - 在SYNC.md中添加认领记录
   - 开始工作

3. **更新进度**：
   - 定期更新SYNC.md中的任务进度
   - 完成任务后标记为✅完成

---

## 协作流程

### 1. 上线流程

```
[Agent 时间] 🟢 上线，准备开始工作
```

### 2. 认领任务

```
[Agent 时间] 📋 认领任务 TXXX 任务名称
```

### 3. 锁定文件

```
[Agent 时间] 🔒 锁定 文件路径
```

### 4. 更新进度

```
[Agent 时间] 🔄 进行中 TXXX，进度 XX%
```

### 5. 完成任务

```
[Agent 时间] ✅ 完成 TXXX
[Agent 时间] 🔓 释放 文件路径
```

### 6. 下线

```
[Agent 时间] 🔴 下线，完成工作
```

---

## 任务列表

| 任务ID | 任务名称 | 优先级 | 负责Agent | 状态 |
|--------|---------|--------|----------|------|
| T001 | 境界体系修仙对齐 | P0 | - | ⏳ 待认领 |
| T002 | 功法体系细化 | P0 | - | ⏳ 待认领 |
| T003 | 天道系统扩展 | P0 | - | ⏳ 待认领 |
| T004 | 战斗系统修仙化 | P0 | - | ⏳ 待认领 |
| T005 | 渡劫系统对齐 | P0 | - | ⏳ 待认领 |
| T006 | 炼丹炼器完善 | P1 | - | ⏳ 待认领 |
| T007 | 宗门系统细化 | P1 | - | ⏳ 待认领 |
| T008 | 资源体系丰富 | P1 | - | ⏳ 待认领 |
| T009 | 种族系统修仙化 | P1 | - | ⏳ 待认领 |

详细任务说明请查看 TASK-ASSIGN.md

---

## 协作规则

### 1. 实时同步

- **定期检查**：每5-10分钟检查一次SYNC.md
- **及时更新**：状态变化时立即更新SYNC.md
- **避免冲突**：修改文件前先检查文件锁状态
- **及时释放**：完成任务后立即释放文件锁

### 2. 文件锁

修改文件前必须在SYNC.md的"文件锁状态"部分登记：

```
| 文件路径 | Agent名 | 当前时间 | 预计释放时间 |
```

修改完成后释放锁：

```
| 文件路径 | - | - | - |
```

### 3. 沟通

- **日常沟通**：通过SYNC.md更新日志
- **紧急沟通**：在SYNC.md中添加`[紧急]`标签
- **详细讨论**：在BOARD.md中添加讨论内容

### 4. 版本控制

- **修改前**：读取文件最新版本
- **修改后**：更新文档版本号
- **记录变更**：在文档页脚添加changelog

---

## 文件监控

### 启动监控

```bash
# 给脚本执行权限
chmod +x docs/ai-collab/WATCHDOG.sh

# 启动监控
./docs/ai-collab/WATCHDOG.sh
```

### 监控功能

- 自动监控GDD文件变化
- 自动更新SYNC.md
- 记录变化日志

### 查看状态

```bash
./docs/ai-collab/WATCHDOG.sh --status
```

---

## 修仙小说参考

### 核心设定

1. **境界体系**：炼气→筑基→结丹→元婴→化神→合体→渡劫→大乘→飞升
2. **功法体系**：天地玄黄、心法武技、神通秘术
3. **炼丹炼器**：丹药品阶、法宝品阶、炼制流程
4. **天道因果**：天道、因果、功德、劫难、心魔
5. **宗门帮派**：宗门等级、职位、任务、资源
6. **战斗系统**：法宝对战、神通对决、阵法禁制、飞剑符箓

详细参考请查看 JOIN-GUIDE.md

---

## 常见问题

### Q1: 如何加入协作？

A1: 阅读 JOIN-GUIDE.md，按照指南操作。

### Q2: 如何认领任务？

A2: 查看 TASK-ASSIGN.md，在 SYNC.md 中添加认领记录。

### Q3: 如何避免文件冲突？

A3: 修改文件前在 SYNC.md 中登记文件锁。

### Q4: 如何与其他agent沟通？

A4: 通过 SYNC.md 更新日志，或在 BOARD.md 中添加讨论内容。

### Q5: 遇到问题怎么办？

A5: 在 SYNC.md 中标记 `⚠️ 问题`，并描述问题内容。

---

## 联系方式

- **实时状态**：查看 SYNC.md
- **任务分配**：查看 TASK-ASSIGN.md
- **详细讨论**：查看 BOARD.md
- **加入指南**：查看 JOIN-GUIDE.md

---

## 更新日志

- 2026-07-01：创建多Agent实时协作方案