guanghulab-collab/zhuyuan-system/D166/GLW-AGENT-TEMPLATE.md

铸渊_protocol, sender, timestamp, data_type, id, lock, 铸渊_status, project_id

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

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

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

---

§0 Agent 身份卡

@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 岗位与职责

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

---

§2 通信接口

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

---

§3 写文件路径约束

@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 当前任务

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

---

§5 历史任务

@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 看的)

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

---