# 接入清单

把本工具包引用/复制到新项目后，按此清单接入。术语与规则详见 `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`。