laily
d7a74578dc
- 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>
2.2 KiB
2.2 KiB
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 白盒验证：
npm run build
go test ./...
npm run dev # 本地起前端
Product/Test 黑盒验证：
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
任务板校验：
python3 docs/agent-collaboration-kit/scripts/validate_tasks.py tasks.yaml
硬规则（其余见 core/）
worker_done不等于完成，必须独立复测后才能verified。- 只有 Coordinator 写
tasks.yaml。 - 每个任务最多派发 3 轮，仍不过标记
leftover并继续。 - 不提交或推送，除非用户明确要求。