147 lines
3.4 KiB
Markdown
147 lines
3.4 KiB
Markdown
---
|
|
铸渊_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 --> |