refactor(agent-collaboration-kit): split stable core from project overrides

- Reorganize flat files into core/ templates/ examples/ scripts/ with VERSION
- Deduplicate: single-source state machine, three-round policy, acceptance signals
- Abstract orchestration in closed-loop.md with manual mode; move Orca commands to orca-adapter.md
- Add tasks.schema.json + validate_tasks.py (jsonschema or builtin rules, no hard deps)
- Add filled examples, concurrency write rule, kitVersion tracking; unify to Chinese

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-07-06 10:01:09 +08:00
parent 58de2650c2
commit d7a74578dc
18 changed files with 1177 additions and 806 deletions
@@ -0,0 +1,64 @@
# notes-web Agent 协作协议(示例)
> 本项目基于 agent-collaboration-kit v0.2.0。
> 稳定规范引用 `docs/agent-collaboration-kit/core/`,本文件只填项目差异。
## 项目概览
- 项目:`notes-web`
- 技术栈:`TypeScript + React (Vite) + Go`
- 运行命令:`npm run dev`(前端)、`go run ./server`(后端)
- Base URL`http://localhost:5173`
- 任务板:`tasks.yaml`
## 稳定规范(引用,不重复)
- 角色 / 权限 / 状态机 / 完成定义:`docs/agent-collaboration-kit/core/roles-and-permissions.md`
- 闭环流程(含手动模式、worktree 对齐):`docs/agent-collaboration-kit/core/closed-loop.md`
- 优化方法(验收信号、三轮策略):`docs/agent-collaboration-kit/core/optimization-method.md`
- 派发 prompt 模板:`docs/agent-collaboration-kit/core/prompt-templates.md`
- Orca 编排命令:`docs/agent-collaboration-kit/core/orca-adapter.md`
## 路径权限
| 路径 | 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 写 |
## 命令
Developer 白盒验证:
```bash
npm run build
go test ./...
npm run dev # 本地起前端
```
Product/Test 黑盒验证:
```bash
curl -s http://localhost:5173/api/health
curl -s -X POST http://localhost:5173/api/fix/preview -d @fixtures/preview.json
# 浏览器回归:tests/browser/cases/*.md
```
任务板校验:
```bash
python3 docs/agent-collaboration-kit/scripts/validate_tasks.py tasks.yaml
```
## 硬规则(其余见 core/
- `worker_done` 不等于完成,必须独立复测后才能 `verified`
- 只有 Coordinator 写 `tasks.yaml`
- 每个任务最多派发 3 轮,仍不过标记 `leftover` 并继续。
- 不提交或推送,除非用户明确要求。