guanghulab-collab/COLLABORATION-PROTOCOL.md

COLLABORATION-PROTOCOL · 多人格体协作协议

适用于铸渊 ICE-GL-ZY001 调度下的所有多人格体协作任务。 适用仓库:guanghulab-collab / 项目编号:NVCOLLAB-MP-001 创建:D166 · 2026-07-06

---

1. 总原则

• 多人格体 = 一个主控(铸渊) + 多个执行 Agent
• 脑子不变,手脚可换 — 任何执行 Agent 都可被替换,不影响主控决策
• 协作元数据(本仓库)与业务正文(其他仓库)严格解耦
• 任何工序必须留痕,失败必须有失败记录

2. 工序模板

每个任务必须按如下工序流转:

子任务 A → 子任务 B → 审核 C → 签字 D
   ↑                       ↓
   └────── 失败返修 ────────┘

2.1 字段约定

每个工序块必须包含以下字段(均可被审核 Agent 解析):

字段	含义	示例
@stage	当前工序标签	A-draft / B-refine / C-audit / D-sign
@owner	当前工序的人格体	general-agent-D166-001
@signer	本工序结束时签字的人格体	verifier-agent-D166-001
@lock	锁定标记,锁定后本工序文件不可改	@lock=true
@evidence	本工序产出的证据(commit hash / 文件路径 / hash)	commit=abc1234
@timestamp	ISO 8601 时间戳	2026-07-06T14:57:00Z

2.2 工序流转规则

• 仅当 @lock=true 且 @signer 已签字,方可进入下一道工序
• 未签字的工序文件视为"未确认",不得用于下游消费
• 每个工序的最长等待时间见 §4(任务失败处理)

3. 派单规范

主控下发子任务时,必须使用如下结构(写在本仓库的 COORDINATION.md):

派单: <agent-id>
任务: <一句话描述>
输入: <文件 / commit / line-range>
输出: <文件 / commit>
期望: <token 数 / 字数 / 结构>
签字人: <agent-id>
锁: @lock=true (主控最终签字)

派单前必须:

1. 在 OVERVIEW.md 勾选对应条目为 in_progress
2. 在 COORDINATION.md 增派单条目
3. 子 Agent 接收后必须 @ack 回主控

4. 任务失败处理

失败类型	处理
Agent 失联(超时 5 分钟)	主控重派同一 Agent,失败 2 次后切到备用 Agent
内容不合规(token 数 / 人设 / 政策)	工序文件打回上一工序,并附 @reason 字段
凭证过期	沿用主凭证,禁止在 commit 信息里出现完整 secret
文件锁冲突	主控强制 unlock 并记录 ForceUnlock 事件

每次失败必须在 OVERVIEW.md 增一行:

[<ISO 时间>] [<agent-id>] FAIL: <一句话原因> → 处置: <一句话>

5. 永久记忆沉淀

任务最终签字后:

1. 主控在 README.md 增 1 行任务摘要(项目编号 + 字数 + commit)
2. 失败记录不得删除,作为后人教训
3. 跨任务经验沉淀入 glw-memory 仓库(如有)

6. 角色与权限

角色	可写	可签字	可解锁
铸渊 ICE-GL-ZY001	全部	最终签字	是
铭序 ICE-GL-MX001	全部	中间签字	否
general-agent-Dxxx	仅其派单工序	自工序签字	否
verifier-agent-Dxxx	评审区	自工序签字	否

---

铸渊识海 · D166 协议定稿