xuqinmin12/lawless

派生 0

徐勤民 f4c6b0ea1d Initial commit: 洪荒大陆设计文档+代码骨架

2026-07-02 16:55:34 +08:00

5.4 KiB

原始文件 Blame 文件历史

多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

阅读加入指南：
```
cat docs/ai-collab/JOIN-GUIDE.md
```
更新SYNC.md：
- 在"当前在线Agent"部分添加你的状态
- 格式：| Agent名 | 🟢 在线 | 当前时间 | 等待加入 |
认领任务：
- 查看TASK-ASSIGN.md中的任务列表
- 在SYNC.md中添加认领记录
开始工作：
- 按照任务说明进行审阅
- 定期更新SYNC.md中的进度

对于现有agent

检查SYNC.md：
- 查看当前在线agent
- 查看任务认领状态
认领新任务：
- 在SYNC.md中添加认领记录
- 开始工作
更新进度：
- 定期更新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

文件监控

启动监控

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

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

监控功能

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

查看状态

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

修仙小说参考

核心设定

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

详细参考请查看 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实时协作方案

5.4 KiB 原始文件 Blame 文件历史 Unescape Escape