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
@@ -21,16 +21,16 @@
## 路径权限(项目覆盖层,必须填实际路径)
| 路径 | Product/Test | Developer | 说明 |
|------|:------------:|:---------:|------|
| `<spec_paths>` | R/W | Read-only | 产品规格、API 文档、计划 |
| `<integration_test_paths>` | R/W | Read-only | 浏览器/API 回归 |
| `<test_records_path>` | R/W | Read-only | 复测记录 |
| `<source_paths>` | Read-only | R/W | 应用源码 |
| `<unit_test_paths>` | Read-only | R/W | 单元测试 |
| `<shared_config_templates>` | Read-only | R/W | 可提交配置模板 |
| `<local_config_paths>` | Read-only | Read-only | 本地私有配置 |
| `tasks.yaml` | R/W | Read-only | 只有 Coordinator 写 |
| 路径 | Coordinator | Test | Developer | 说明 |
|------|:-----------:|:----:|:---------:|------|
| `<spec_paths>` | R/W | Read-only | Read-only | 产品规格、API 文档、计划PM 拥有) |
| `<integration_test_paths>` | Read-only | R/W | Read-only | 浏览器/API 回归Test 拥有) |
| `<test_records_path>` | Read-only | R/W | Read-only | 复测记录 |
| `<source_paths>` | Read-only | Read-only | R/W | 应用源码 |
| `<unit_test_paths>` | Read-only | Read-only | R/W | 单元测试 |
| `<shared_config_templates>` | Read-only | Read-only | R/W | 可提交配置模板 |
| `<local_config_paths>` | Read-only | Read-only | Read-only | 本地私有配置 |
| `tasks.yaml` | R/W | Read-only | Read-only | 只有 Coordinator 写 |
## 命令(项目覆盖层)
@@ -42,7 +42,7 @@ Developer 白盒验证:
<local_run_command>
```
Product/Test 黑盒验证
Test 黑盒复测
```bash
<preflight_command>
@@ -58,7 +58,8 @@ python3 docs/agent-collaboration-kit/scripts/validate_tasks.py tasks.yaml
## 硬规则(其余见 core/
- `worker_done` 不等于完成。Product/Test 必须独立复测后才能 `verified`
- 只有 Coordinator 写 `tasks.yaml`Developer 通过 worker_done 回报
- 三角色独立:Coordinator 只编排、Test 只验证、Developer 只实现(验证者 ≠ 实现者)
- `worker_done` 与复测报告都不等于完成。必须 Test 独立复测 + Coordinator 终检后才能 `verified`
- 只有 Coordinator 写 `tasks.yaml`Developer 与 Test 都只读,通过消息回报。
- 每个任务最多派发 3 轮,仍不过标记 `leftover` 并继续下一个。
- 不提交或推送,除非用户明确要求。
@@ -103,6 +103,7 @@
"additionalProperties": true,
"properties": {
"fixedBy": { "type": ["string", "null"] },
"verifiedBy": { "type": ["string", "null"] },
"verifiedAt": { "type": ["string", "null"] },
"leftoverReason": { "type": ["string", "null"] },
"evidence": { "type": "object" }
@@ -1,7 +1,7 @@
# 复制到项目根目录为 tasks.yaml,替换占位符。结构见 templates/tasks.schema.json。
version: 1
updatedAt: "<YYYY-MM-DDTHH:mm:ss+TZ>"
source: "Product/Test Agent"
source: "Coordinator (PM) Agent"
kitVersion: "<接入时的 agent-collaboration-kit 版本,见 kit 根 VERSION>"
project:
name: "<project_name>"
@@ -39,7 +39,7 @@ tasks:
<Expected behavior.>
actual: >
<Actual behavior observed by Product/Test.>
<Actual behavior observed by Test.>
evidence:
browser: "<snapshot text, screenshot path, or UI finding>"
@@ -63,5 +63,6 @@ tasks:
resolution:
fixedBy: null
verifiedBy: null
verifiedAt: null
leftoverReason: null