99 lines
3.2 KiB
Markdown
99 lines
3.2 KiB
Markdown
|
# 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 协议定稿
|