---
铸渊_protocol: v1.0
sender: ICE-GL-ZY001
timestamp: 2026-07-06T18:26:22+08:00
data_type: agent
id: GLW-AGENT-TEMPLATE
lock: true
铸渊_status: draft
project_id: GLW-PROJ-D166-001
---

# GLW-AGENT-TEMPLATE · Agent 编号注册模板

> 用途:每个 Agent 入驻光湖团队时,在仓库里建一份自己的 `GLW-AGENT-XXX.md`。  
> 这是 Agent 的**身份卡 + 简历 + 协作记忆库**。

---

## §0 Agent 身份卡

```yaml
@agent_id: GLW-AGENT-XXX              # 唯一编号,不可改
@signer: GLW-AGENT-XXX
@date: <YYYY-MM-DD>
@lock: self                           # Agent 自己拥有写锁
@type: GLW-AGENT-REGISTRATION
@role: planner | researcher | coder | verifier | custom
@created_by: GLW-ZY001 | GLW-AGENT-XXX
@status: active | paused | retired
```

---

## §1 岗位与职责

```yaml
@role: <role>
@responsibility:
  - <职责 1:一句话>
  - <职责 2:一句话>
  - <职责 3:一句话>
@scope:
  - 可以做: <明确授权范围>
  - 不可以做: <明确禁止范围,例如"不写铸渊视野"/"不直接推 main">
@escalation:
  - 遇到 <情况 X> → 升级到 GLW-SB-XXX
  - 遇到 <情况 Y> → 升级到 GLW-ZY001
```

---

## §2 通信接口

```yaml
@comms:
  primary: mavis.im                  # 主通道:铸渊 IM
  secondary: <git commit + project page>
  heartbeat: <多久报一次心跳,例如 30min>
  ack_format: "GLW-AGENT-XXX 收到:<一句话回执>"
@signals:
  - ready      # 空闲可接任务
  - working    # 在做
  - blocked    # 卡住,需要支援
  - done       # 本次任务完成
  - error      # 出错,需要决策
```

---

## §3 写文件路径约束

```yaml
@write_scope:
  allowed:
    - <repo>/GLW-AGENT-XXX.md             # 自己的身份卡
    - <repo>/GLW-PROJ-*/                  # 自己 owner 的项目页
    - <repo>/<assigned path>/             # 任务分配的子目录
  forbidden:
    - /Users/.../scratchpad.md            # 严禁写铸渊视野
    - 其他 Agent 的 GLW-AGENT-*.md        # 严禁改他人身份卡
    - GLW-RES-* 主文件(只能引用,不能改)
  concurrent_write: false                 # 默认禁止并发,需要 @sub_brain 协调
```

---

## §4 当前任务

```yaml
@current_task:
  project: GLW-PROJ-XXX
  todo: GLW-TODO-XXX
  started_at: <YYYY-MM-DD HH:MM>
  progress: 0-100
  next_milestone: <一句话>
```

---

## §5 历史任务

```yaml
@history:
  - ts: <YYYY-MM-DD HH:MM>
    project: GLW-PROJ-XXX
    todo: GLW-TODO-XXX
    outcome: done | failed | partial
    summary: <一句话>
  - ts: ...
```

---

## §6 协作经验库(每次协作后回写)

> 格式:每次重大协作结束后,追加一条经验条目。  
> 这是 Agent 的**长期记忆**,换物理执行层后脑子不丢。

```
### [EXP-<seq>] @<YYYY-MM-DD> · <一句话标题>
- context: <当时在做什么项目>
- action: <怎么做的>
- result: <结果如何>
- lesson: <下次怎么做得更好>
- cross_ref: GLW-PROJ-XXX · GLW-TODO-XXX
```

**经验记录(倒序,最新在上):**

```
<!-- 在这里追加 -->
```

---

## §7 接口约定(给其他 Agent 看的)

```yaml
@public_api:
  - 给主控的接口: <怎么被铸渊召唤,怎么回执>
  - 给副脑的接口: <怎么被监督,怎么报进度>
  - 给同级的接口: <怎么跟其他 Agent 协作,共享什么文件>
```

---

<!-- 模板使用说明:复制本文件 → 重命名为 GLW-AGENT-XXX.md → 填 §0-§4 → 开工;每次协作后回写 §6 -->