feat(ack): add project knowledge guardrails

skills/ack/references/adoption-checklist.md

@@ -4,7 +4,9 @@
 
 - [ ] ACK Skill 已全局安装或安装到当前项目。
 - [ ] 已运行 `skiff init ack --project <project-root>`。
-- [ ] `docs/ack/` 只包含项目自己的 `project.md` 与 `tasks.yaml`。
+- [ ] `docs/ack/` 只包含项目自己的 `project.md`、`tasks.yaml` 与 `knowledge.yaml`。
+- [ ] 旧项目缺少 `knowledge.yaml` 时，只补空文件及缺失的
+      `project.knowledgeFile` 指针，没有重跑初始化或覆盖其它项目状态。
 - [ ] 项目中没有 ACK Skill 的复制目录或 `kit`、`framework` 软链接。
 - [ ] `tasks.yaml` 使用 `ackVersion` 记录 ACK Skill 版本。
 
@@ -12,6 +14,8 @@
 
 - [ ] `project.md` 只保存项目差异，不复制 Skill 的通用规范。
 - [ ] `tasks.yaml` 的 `project.overlayFile` 指向实际覆盖层。
+- [ ] `tasks.yaml` 的 `project.knowledgeFile` 固定为
+      `docs/ack/knowledge.yaml`。
 - [ ] 技术栈、运行、构建、单测和集成测试命令均来自项目证据。
 - [ ] Coordinator、Developer、Test 的模型档位和升级规则已明确。
 
@@ -22,6 +26,7 @@
 - [ ] Developer 可写源码与单元测试，但不能改规格或黑盒验收。
 - [ ] 私有配置只读且不提交。
 - [ ] `tasks.yaml` 只有 Coordinator 写。
+- [ ] `knowledge.yaml` 只有 Coordinator 写；Developer 与 Test 只通过回报提名或验证。
 
 ## 任务板
 
@@ -30,12 +35,30 @@
 - [ ] 真实任务的验收是可观测信号。
 - [ ] 已运行 `<ack-skill-dir>/scripts/validate_tasks.py` 并通过。
 
+## 项目知识
+
+- [ ] 新项目没有已验证知识时使用 `verificationRegistry: {}` 与 `entries: []`，
+      不虚构 active 条目。
+- [ ] 已运行 `<ack-skill-dir>/scripts/validate_knowledge.py` 并通过；同时校验任务引用。
+- [ ] Coordinator 只从 `active` 条目按 scope 推荐知识，并显式确认固定 revision 的
+      `knowledgeRefs`。
+- [ ] `candidate` 留在任务证据中，不派发；`stale`、`superseded`、`archived`
+      不默认选择。
+- [ ] 每轮只内联命中的少量知识，不全量注入 `knowledge.yaml`。
+- [ ] Developer 回报 `knowledgeApplied` 与 `knowledgeCandidates`，Test 回报
+      `knowledgeChecks`。
+- [ ] `verification.ref` 只引用 `verificationRegistry` 中已审查的仓库内相对 path
+      和结构化 args；执行时只把 registry ID 交给 `run_verification.py`，不从
+      知识正文或选择器输出拼接 shell。
+- [ ] 关键约束已规划下沉到测试、lint、CI 或正式规范。
+- [ ] ACK 不自动修改 `AGENTS.md`、`CLAUDE.md` 或其它 Agent 指令文件。
+
 ## 编排
 
 - [ ] 已选择 Orca 或手动模式。
 - [ ] 派发前优先复用同 worktree、同角色、同配置的空闲 worker。
 - [ ] Developer 与 Test 的启动命令通过校验。
-- [ ] 多 worktree 场景只有一个权威 `tasks.yaml`。
+- [ ] 多 worktree 场景只有一个权威 `tasks.yaml` 和 `knowledge.yaml`。
 - [ ] Test 使用的服务来自正确 worktree。
 
 ## 闭环
@@ -48,4 +71,5 @@
 
 首次接入建议选择一个低风险问题跑完整闭环。项目差异写回
 `docs/ack/project.md`；通用问题回流到 ACK Skill 的 `references/`、`templates/`
-或 `scripts/`，并更新 `VERSION`。
+或 `scripts/`，并更新 `VERSION`。项目特有、跨任务复用且已经验证的经验才写入
+`docs/ack/knowledge.yaml`。