149 lines
3.5 KiB
Plaintext
149 lines
3.5 KiB
Plaintext
---
|
|
铸渊_protocol: v1.0
|
|
sender: ICE-GL-ZY001
|
|
timestamp: 2026-07-06T18:26:22+08:00
|
|
data_type: proj
|
|
id: GLW-PROJ-TEMPLATE
|
|
lock: true
|
|
铸渊_status: draft
|
|
project_id: GLW-PROJ-D166-001
|
|
---
|
|
|
|
# GLW-PROJ-TEMPLATE · 项目编号页模板
|
|
|
|
> 用途:每个项目开工时,先建一份项目编号页(GLW-PROJ-XXX)。
|
|
> 这是**实时同步的唯一共享文件**——所有 Agent 进度都 commit 到这里。
|
|
> 拿到新加坡仓库路径后,直接 `git push` 到中央仓库即可全团队可见。
|
|
|
|
---
|
|
|
|
## §0 项目元数据
|
|
|
|
```yaml
|
|
@project_id: GLW-PROJ-XXX # 替换 XXX 为本项目编号
|
|
@project_name: <一句话项目名>
|
|
@parent_task: GLW-WO-XXX-XXX # 上游任务单编号
|
|
@created_by: GLW-AGENT-XXX # 建页 Agent
|
|
@created_at: <YYYY-MM-DD HH:MM>
|
|
@status: planning | running | blocked | done
|
|
@priority: P0 | P1 | P2
|
|
```
|
|
|
|
---
|
|
|
|
## §1 主控与协作团队
|
|
|
|
```yaml
|
|
@zhuyu: GLW-ZY001 # 铸渊主控(大脑)
|
|
@sub_brain: GLW-SB-XXX # 副脑(本项目的执行监督)
|
|
@agents:
|
|
- id: GLW-AGENT-A
|
|
role: planner
|
|
responsibility: 方案设计 / 拆任务 / 写文档
|
|
- id: GLW-AGENT-B
|
|
role: researcher
|
|
responsibility: 资料检索 / HLDP 文档定位 / 接口发现
|
|
- id: GLW-AGENT-C
|
|
role: coder
|
|
responsibility: 写代码 / 推送 / 模板生成
|
|
- id: GLW-AGENT-D
|
|
role: verifier
|
|
responsibility: 测试 / 回写经验 / 把关质量
|
|
```
|
|
|
|
---
|
|
|
|
## §2 中央事实源(只读引用,GLW-RES-*)
|
|
|
|
```yaml
|
|
@resources:
|
|
- id: GLW-RES-001
|
|
title: <资料标题>
|
|
location: <路径 / URL / repo path>
|
|
type: doc | code | spec | log | ico
|
|
digest: <一句话摘要>
|
|
locked_by: GLW-AGENT-XXX # 谁负责维护这一份
|
|
- id: GLW-RES-002
|
|
...
|
|
```
|
|
|
|
> 原则:中央事实源**不复制内容**,只放指针 + 摘要。所有 Agent 通过 GLW-RES-* 引用,避免事实漂移。
|
|
|
|
---
|
|
|
|
## §3 任务清单 (GLW-TODO)
|
|
|
|
```yaml
|
|
@todos:
|
|
- id: GLW-TODO-001
|
|
title: <任务名>
|
|
owner: GLW-AGENT-XXX
|
|
status: todo | doing | review | done | blocked
|
|
depends_on: [] # GLW-TODO-XXX 列表
|
|
eta: <YYYY-MM-DD>
|
|
notes: <一句话>
|
|
- id: GLW-TODO-002
|
|
...
|
|
```
|
|
|
|
---
|
|
|
|
## §4 实时进度更新区(每个 Agent 实时 commit)
|
|
|
|
> 每个 Agent 完成一段工作,**必须**在本节追加一段 commit 条目。
|
|
> 格式严格,便于副脑和铸渊 grep:
|
|
|
|
```
|
|
### [GLW-AGENT-X] @<timestamp> · <status>
|
|
- action: <做了什么,一句话>
|
|
- artifacts: <产出文件路径列表>
|
|
- next: <下一步,或 "await feedback">
|
|
- blocker: <none | 描述>
|
|
```
|
|
|
|
**commit 历史(倒序,最新在上):**
|
|
|
|
```
|
|
<!-- 在这里追加,不要清空历史 -->
|
|
```
|
|
|
|
---
|
|
|
|
## §5 协作链记录(铸渊 ↔ 副脑 ↔ Agent)
|
|
|
|
```yaml
|
|
@chain:
|
|
- ts: <YYYY-MM-DD HH:MM>
|
|
from: GLW-ZY001
|
|
to: GLW-AGENT-A
|
|
msg: <一句话指令>
|
|
- ts: <YYYY-MM-DD HH:MM>
|
|
from: GLW-AGENT-A
|
|
to: GLW-ZY001
|
|
msg: <回执>
|
|
...
|
|
```
|
|
|
|
---
|
|
|
|
## §6 锁与冲突仲裁
|
|
|
|
```yaml
|
|
@lock_policy:
|
|
- 谁在 §4 写 commit,谁就 lock 自己的 @agent_id 段
|
|
- 同一 Agent 不并发写(必须等上一次 commit 落盘)
|
|
- 跨 Agent 冲突由 @sub_brain 仲裁
|
|
- 整页锁 (@lock: locked) 只允许 @zhuyu 上锁
|
|
```
|
|
|
|
---
|
|
|
|
## §7 收尾
|
|
|
|
- 项目完成时,由 @sub_brain 把 @status 改为 `done`,并在 §4 追加一条 `### [SUB-BRAIN] @done · project closed`
|
|
- 项目页**不删**,归档到 `GLW-ARCH-XXX` 编号下
|
|
- 经验教训回写到各 Agent 的 GLW-AGENT-XXX.md
|
|
|
|
---
|
|
|
|
<!-- 模板使用说明:复制本文件 → 重命名为 GLW-PROJ-XXX.hdlp → 填 §0-§3 → 开工 --> |