5.5 KiB
5.5 KiB
多Agent实时协作加入指南
本文档用于引导新agent加入洪荒大陆修仙手游设计审阅协作 最后更新：2026-07-01
欢迎加入
你好，欢迎加入洪荒大陆修仙手游的设计审阅协作！
我们正在进行一项重要工作：参考修仙小说，完善所有设计文档的逻辑、设定。
快速开始
第一步：了解项目
-
读取项目记忆：
- 文件位置：
/Users/xuqinmin/.claude-mimo/projects/-Users-xuqinmin-Projects-NewsProject/memory/project_lawless.md - 内容：项目核心设定、技术栈、种族系统、文档结构
- 文件位置：
-
读取协作约定：
- 文件位置：
/Users/xuqinmin/Projects/NewsProject/lawless/docs/协作约定.md - 内容：文档归属软锁、开工前必读、决策编号规则
- 文件位置：
-
读取决策总索引：
- 文件位置：
/Users/xuqinmin/Projects/NewsProject/lawless/docs/设计文档/GDD-00-决策总索引.md - 内容：所有核心决策的索引
- 文件位置：
第二步：加入协作
-
更新SYNC.md：
- 文件位置：
/Users/xuqinmin/Projects/NewsProject/lawless/docs/ai-collab/SYNC.md - 操作：在"当前在线Agent"部分添加你的状态
添加格式：
| 你的Agent名 | 🟢 在线 | 当前时间 | 等待加入 | - 文件位置：
-
认领任务：
- 文件位置：
/Users/xuqinmin/Projects/NewsProject/lawless/docs/ai-collab/TASK-ASSIGN.md - 操作：查看任务列表，认领一个任务
认领格式（在SYNC.md中添加）：
[你的Agent名 当前时间] 📋 认领任务 TXXX 任务名称 - 文件位置：
-
开始工作：
- 按照任务说明进行审阅
- 定期更新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] 📋 认领下一个任务
修仙小说参考
核心设定参考
-
境界体系：
- 炼气→筑基→结丹→元婴→化神→合体→渡劫→大乘→飞升
- 每个大境界分初期、中期、后期、大圆满
-
功法体系：
- 品阶：天地玄黄、宇宙洪荒
- 类型：心法、武技、神通、秘术
- 来源：宗门传承、秘境探索、机缘巧合、自行领悟
-
炼丹炼器：
- 丹药品阶：凡品、黄品、玄品、地品、天品、仙品
- 法宝品阶：凡器、法器、灵器、仙器、神器
- 流程：准备材料、开始炼制、控制火候、丹成/器成
-
天道因果：
- 天道：宇宙运行的法则，不可违逆
- 因果：善有善报，恶有恶报
- 功德：行善积德，功德无量
- 劫难：修炼路上的考验，渡劫是核心玩法
- 心魔：内心深处的执念，需要克服
-
宗门帮派：
- 宗门等级：一等宗门、二等宗门、三等宗门等
- 宗门职位：掌门、长老、执事、内门弟子、外门弟子等
- 宗门任务：日常任务、宗门任务、悬赏任务等
-
战斗系统：
- 法宝对战：法宝是核心战斗手段
- 神通对决：神通是高阶战斗手段
- 阵法：布置阵法，困敌/杀敌
- 禁制：设置禁制，保护/限制
- 飞剑：飞剑是标志性战斗手段
- 符箓：使用符箓，一次性攻击/防御
常见问题
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
开始工作
现在，你可以：
- 更新SYNC.md，标记你已上线
- 查看TASK-ASSIGN.md，认领一个任务
- 开始审阅，完善设计文档
祝你工作愉快！🎉
