.pouch/skills/ack/references/adoption-checklist.md

ACK 接入清单

安装与初始化

• ACK Skill 已全局安装或安装到当前项目。
• 已运行 skiff init ack --project <project-root>。
• docs/ack/ 只包含项目自己的 project.md 与 tasks.yaml。
• 项目中没有 ACK Skill 的复制目录或 kit、framework 软链接。
• tasks.yaml 使用 ackVersion 记录 ACK Skill 版本。

项目覆盖层

• project.md 只保存项目差异，不复制 Skill 的通用规范。
• tasks.yaml 的 project.overlayFile 指向实际覆盖层。
• 技术栈、运行、构建、单测和集成测试命令均来自项目证据。
• Coordinator、Developer、Test 的模型档位和升级规则已明确。

路径权限

• Coordinator 可写规格和任务板。
• Test 可写集成测试与复测记录，但不能改源码。
• Developer 可写源码与单元测试，但不能改规格或黑盒验收。
• 私有配置只读且不提交。
• tasks.yaml 只有 Coordinator 写。

任务板

• 已替换项目名、仓库路径、Base URL、worktree 和覆盖层路径。
• 没有真实任务时使用 tasks: []。
• 真实任务的验收是可观测信号。
• 已运行 <ack-skill-dir>/scripts/validate_tasks.py 并通过。

编排

• 已选择 Orca 或手动模式。
• 派发前优先复用同 worktree、同角色、同配置的空闲 worker。
• Developer 与 Test 的启动命令通过校验。
• 多 worktree 场景只有一个权威 tasks.yaml。
• Test 使用的服务来自正确 worktree。

闭环

• worker_done 不直接视为完成。
• Test 独立复测后由 Coordinator 读取证据终检。
• 每轮写入 dispatch.rounds。
• 三轮失败后标记 leftover 并填写原因。
• leftover 不阻塞其它任务。

首次接入建议选择一个低风险问题跑完整闭环。项目差异写回 docs/ack/project.md；通用问题回流到 ACK Skill 的 references/、templates/ 或 scripts/，并更新 VERSION。