This commit is contained in:
2026-07-07 00:53:54 +08:00
parent d7a74578dc
commit 6bd03c2f6d
13 changed files with 272 additions and 129 deletions
@@ -1,6 +1,6 @@
# notes-web Agent 协作协议(示例)
> 本项目基于 agent-collaboration-kit v0.2.0。
> 本项目基于 agent-collaboration-kit v0.3.0。
> 稳定规范引用 `docs/agent-collaboration-kit/core/`,本文件只填项目差异。
## 项目概览
@@ -21,16 +21,16 @@
## 路径权限
| 路径 | Product/Test | Developer | 说明 |
|------|:------------:|:---------:|------|
| `docs/spec/**` | R/W | Read-only | 产品规格 |
| `tests/browser/**` | R/W | Read-only | 浏览器回归用例 |
| `.qa-records/**` | R/W | Read-only | 复测记录(gitignore |
| `web/**``server/**` | Read-only | R/W | 应用源码 |
| `**/*_test.go``web/**/*.test.tsx` | Read-only | R/W | 单元测试 |
| `config/*.example.*` | Read-only | R/W | 可提交配置模板 |
| `.env``config/local.*` | Read-only | Read-only | 本地私有配置 |
| `tasks.yaml` | R/W | Read-only | 只有 Coordinator 写 |
| 路径 | Coordinator | Test | Developer | 说明 |
|------|:-----------:|:----:|:---------:|------|
| `docs/spec/**` | R/W | Read-only | Read-only | 产品规格(PM 拥有) |
| `tests/browser/**` | Read-only | R/W | Read-only | 浏览器回归用例Test 拥有) |
| `.qa-records/**` | Read-only | R/W | Read-only | 复测记录(gitignore |
| `web/**``server/**` | Read-only | Read-only | R/W | 应用源码 |
| `**/*_test.go``web/**/*.test.tsx` | Read-only | Read-only | R/W | 单元测试 |
| `config/*.example.*` | Read-only | Read-only | R/W | 可提交配置模板 |
| `.env``config/local.*` | Read-only | Read-only | Read-only | 本地私有配置 |
| `tasks.yaml` | R/W | Read-only | Read-only | 只有 Coordinator 写 |
## 命令
@@ -42,7 +42,7 @@ go test ./...
npm run dev # 本地起前端
```
Product/Test 黑盒验证
Test 黑盒复测
```bash
curl -s http://localhost:5173/api/health
@@ -58,7 +58,8 @@ python3 docs/agent-collaboration-kit/scripts/validate_tasks.py tasks.yaml
## 硬规则(其余见 core/
- `worker_done` 不等于完成,必须独立复测后才能 `verified`
- 只有 Coordinator 写 `tasks.yaml`
- 三角色独立:Coordinator 只编排、Test 只验证、Developer 只实现
- `worker_done` 与复测报告都不等于完成,必须 Test 独立复测 + Coordinator 终检后才能 `verified`
- 只有 Coordinator 写 `tasks.yaml`Test 与 Developer 只读。
- 每个任务最多派发 3 轮,仍不过标记 `leftover` 并继续。
- 不提交或推送,除非用户明确要求。
@@ -1,8 +1,8 @@
# 填好的最小示例(虚构的 notes-web 项目)。可用 scripts/validate_tasks.py 校验通过。
version: 1
updatedAt: "2026-07-06T09:40:00+08:00"
source: "Product/Test Agent"
kitVersion: "0.2.0"
source: "Coordinator (PM) Agent"
kitVersion: "0.3.0"
project:
name: "notes-web"
repoPath: "/home/dev/notes-web"
@@ -62,6 +62,7 @@ tasks:
evidence: "复测 4 行 diff 全部出现,取消不触发写入"
resolution:
fixedBy: "dev-worker-1"
verifiedBy: "test-worker-1"
verifiedAt: "2026-07-06T09:38:00+08:00"
leftoverReason: null
@@ -109,5 +110,6 @@ tasks:
evidence: "乐观锁与前端重试逻辑冲突,需重新设计"
resolution:
fixedBy: null
verifiedBy: null
verifiedAt: null
leftoverReason: "failed after 3 supervised developer rounds; 需重新设计并发模型"