# 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 协议定稿