xuqinmin12/lawless
1
0
派生 0
代码 工单 合并请求 Actions 1 软件包 项目 版本发布 百科 动态
521603a899
lawless/docs/协作约定.md

6.0 KiB
原始文件 Blame 文件历史

多智能体协作约定（CONTRIBUTING）

类型：协作流程规范 版本：1.0 日期：2026-06-29 适用：本项目所有参与协作的 AI 智能体（Claude / MiMo / Kimi / Sonnet 等）与人类负责人

目的：本项目采用多模型异步文件级协作——多个 AI 各自编辑同一批 GDD 文档，通过共享文件 + 决策注册表协调。本约定用于消除并行编辑冲突、统一决策编号、明确合并裁决，让多个智能体可安全并行推进。

一、协作模式

  • 异步并行：各智能体在各自会话/进程中工作，不要求实时同步。
  • 文件即接口：协作通过 docs/ 下的共享文档进行；不存在跨会话的内存共享。
  • 单一事实源：
    • 决策编号与裁决 → GDD-00 决策总索引
    • 文档状态总览 → README.md 的 GDD 表
    • 本协作流程 → 本文档

二、文档归属与认领（防止同文件并写）

核心规则：同一文档在同一时段只允许一个智能体主写（持有"写锁"）。

模块 文档 当前主写（建议，可调整）
决策注册/一致性维护 GDD-00 Claude（注册表维护者）
核心机制 GDD-02 仅追加决策，任何人改前先认领
种族/天赋 GDD-01、GDD-10、GDD-11 Claude
战斗/功法/职业 GDD-03、GDD-04、GDD-05 Claude
经济/数值平衡 GDD-06、GDD-08-附录A MiMo
地图/出生地 GDD-08、GDD-08-附录B、GDD-09 MiMo
社交/佣兵/拍卖 GDD-07、GDD-13、GDD-14 Kimi
渡劫/成长经济 GDD-12、GDD-15 Kimi
审查/跨文档整合 全部（只读+评审） Sonnet

归属表由人类负责人最终裁定，可随时调整。未持锁的文档只读，不直接改；如需改他人文档的内容，提出"变更请求"由该文档主写执行，或经负责人重新分配。

认领约定（轻量"锁"）

由于无实时锁机制，用文档头部状态行充当软锁：

> 🔒 写锁：<智能体名> | 认领时间 <时间> | 预计完成 <范围>
  • 开工前：在目标文档头部加上 🔒 写锁行；完成后删除。
  • 看到他人 🔒 写锁未释放 → 不动该文档，改做自己认领的模块。

三、开工前必读（每次编辑前）

  1. 读 GDD-00 决策总索引：确认最新核心决策号（当前至 ✅98）与约定。
  2. 读 目标文档头部 + 决策表 + 页脚 changelog：确认最新版本与是否被他人持锁。
  3. 读 README GDD 表：确认目标文档当前状态。

本项目已多次发生"编辑中途文件被改"的冲突，开工前读最新状态是硬性要求。

四、决策编号规则（沿用 GDD-00）

类型 规则
全局核心决策 在 GDD-02 决策表末尾只追加（✅99, ✅100…），严禁重排已有号；同步在 GDD-00 第二节登记一行
地图域决策 写入 GDD-08，沿用 ✅D## / ✅Q##
文档本地决策 写入对应文档本地表；跨文档引用必须带前缀（如 GDD-05 ✅8），禁止裸写本地号
反转/取代旧决策 旧条目加删除线 + 指向新号；在 GDD-00 第五节登记
禁止 字母后缀（如 ✅99b）；占用他人命名空间

五、合并与冲突裁决

  1. 决策冲突：以 GDD-00 注册表为权威；若两条决策矛盾，按 ✅日志先后 + 人类负责人裁定，败者标注反转。
  2. 同文档并发改：若发现自己的改动与他人冲突（文件已变更），放弃覆盖、重读、在最新版本上重做，绝不强行回退他人内容。
  3. 跨文档不一致：发现后不擅自改他人主写文档，而是：①在 GDD-00 或本文档登记"待对齐项"；②通知对应主写或负责人。
  4. 数值 vs 框架：框架性决策（核心机制）优先级高于本地数值；本地数值调整不得违反核心决策。

六、文档维护规范

每次提交（编辑完成）必须：

  1. 更新文档页脚 changelog：*GDD-XX vN.N | 日期 | 本次变更摘要*
  2. 更新版本号：框架级改动升次版本，小修订升小版本
  3. 同步 README GDD 表状态（状态/版本/最后更新）
  4. 若涉及核心决策 → 同步 GDD-00 第二节
  5. 释放写锁（删除 🔒 行）

状态标记约定

标记 含义
✅ 已定稿/已确认（无待确认项）
⚠️ 草案/含待确认项（❓）
🔲 待创建
❓ 待确认事项（在文档内待确认表登记）

七、标准工作流（单个智能体一次任务）

1. 读 GDD-00 + 目标文档头/页脚 + README 状态   （了解最新）
2. 在目标文档头加 🔒 写锁行                      （认领）
3. 编辑内容；新决策只追加、带前缀引用            （执行）
4. 更新页脚 changelog + 版本号                   （记录）
5. 同步 GDD-00（若有核心决策）+ README 状态       （注册）
6. 删除 🔒 写锁行                                （释放）
7. 向负责人汇报：改了什么、新增哪些决策、待对齐项  （交接）

八、当前并行分工建议（首批认领）

基于现有文档的缺口与成熟度，建议首批并行任务如下（人类负责人可调整）：

智能体 首批认领 任务
Claude GDD-10、GDD-03 隐藏天赋数值化 + 补第3候选；战斗公式收尾
MiMo GDD-08-附录A、GDD-06 各层挂机资源数值表；经济数值平衡表
Kimi GDD-14、GDD-07 稀有宝物拍卖收尾；门派/家族细节
Sonnet 全局 跨文档一致性审查，产出"待对齐项"清单

Claude 兼任 GDD-00 决策注册表维护者：负责归一新决策编号、登记反转/取代、定期核查跨文档一致性。

协作约定 v1.0 | 2026-06-29 | 确立多模型异步文件级协作：文档归属软锁、开工前必读、决策编号沿用GDD-00、合并裁决、维护规范、首批并行分工