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.4 KiB
2.4 KiB
接入清单
把本工具包引用/复制到新项目后，按此清单接入。术语与规则详见 core/。
1. 分发与版本
- 选定分发方式（README §「分发方式」A 引用 / B 复制）。
- kit 放到
docs/agent-collaboration-kit/。 - 项目
AGENTS.md与tasks.yaml记录kitVersion（对齐 kit 根VERSION）。
2. 项目级规范（覆盖层）
- 由
templates/AGENTS.template.md生成项目根AGENTS.md。 AGENTS.md引用docs/agent-collaboration-kit/core/，不复制其内容。- 填清项目简介、技术栈、运行/构建/单测/集成测试命令。
3. 路径权限
- 填实际的 Product/Test 可写路径（规格、集成测试、复测记录）。
- 填实际的 Developer 可写路径（源码、单元测试、配置模板）。
- 本地私有配置标记只读或不提交。
- 确认
tasks.yaml只有 Coordinator 写（见core/roles-and-permissions.md）。
4. 任务板
- 由
templates/tasks.template.yaml生成项目根tasks.yaml。 - 替换
<project_name>、<repo_path>、<base_url>、<dev_worktree>。 - 至少加一个真实任务，验收写成可观测信号（见
core/optimization-method.md§1）。 - 跑
scripts/validate_tasks.py tasks.yaml通过。
5. 编排
- 决定用 Orca（
core/orca-adapter.md）还是手动模式（core/closed-loop.md）。 - Orca：
orca status、terminal list可用，worker_done能发回 Coordinator。 - 决定用当前 worktree 还是隔离 worktree。
6. 验证命令
- Product/Test 有黑盒验证命令，Developer 有白盒验证命令。
- 构建产物与服务启动命令写清。
- 浏览器测试
BASE_URL写清，复测前能确认服务来自正确 worktree。
7. 三轮失败策略
- 每个任务记录
dispatch.rounds。 - 三轮失败标记
leftover并填resolution.leftoverReason。 leftover不阻塞其它任务；最终报告列出所有leftover与最后失败证据。
8. 第一次试运行
选一个低风险 bug 跑完整闭环，结束后检查是否出现：
- Developer 修改了越权路径。
- worker_done 没有验证证据。
- Product/Test 复测到了旧服务。
- 任务板字段不够记录失败原因。
- 三轮失败策略没被执行。
把发现的问题回写到项目 AGENTS.md；若属通用问题，回流到 kit 的 core/ 并升 VERSION。