feat(ack): add project knowledge guardrails

skills/ack/examples/project.example.md

@@ -1,9 +1,10 @@
 # notes-web Agent 协作协议（示例，项目覆盖层）
 
-> 本项目基于 ack v0.8.1。
+> 本项目基于 ack v0.9.0。
 > 通用规范由 `/ack` 从 Skill 自身的 `references/` 读取，本文件只填项目差异。
 > 覆盖层文件放在 `docs/ack/project.md`，不占用 `AGENTS.md`。
-> `docs/ack/` 只保存 `project.md` 与 `tasks.yaml`。
+> ACK 不会自动修改 `AGENTS.md`、`CLAUDE.md` 或其它 Agent 指令文件。
+> `docs/ack/` 只保存 `project.md`、`tasks.yaml` 与 `knowledge.yaml`。
 
 ## 项目概览
 
@@ -12,6 +13,7 @@
 - 运行命令：`npm run dev`（前端）、`go run ./server`（后端）
 - Base URL：`http://localhost:5173`
 - 任务板：`docs/ack/tasks.yaml`
+- 项目知识：`docs/ack/knowledge.yaml`
 - 覆盖层文件：`docs/ack/project.md`
 
 ## 稳定规范（引用，不重复）
@@ -44,6 +46,7 @@
 | `config/*.example.*` | Read-only | Read-only | R/W | 可提交配置模板 |
 | `.env`、`config/local.*` | Read-only | Read-only | Read-only | 本地私有配置 |
 | `tasks.yaml` | R/W | Read-only | Read-only | 只有 Coordinator 写 |
+| `knowledge.yaml` | R/W | Read-only | Read-only | 只有 Coordinator 写；Developer/Test 通过回报提名或验证 |
 
 ## 命令
 
@@ -63,13 +66,22 @@ curl -s -X POST http://localhost:5173/api/fix/preview -d @fixtures/preview.json
 # 浏览器回归：tests/browser/cases/*.md
 ```
 
-任务板校验由 `/ack` 使用 Skill 自带的 `scripts/validate_tasks.py` 执行。
+项目已审查的知识检查入口保存在 `knowledge.yaml.verificationRegistry`，格式为检查
+ID 对应仓库内相对 path 和结构化 args。知识正文不保存或自动执行自由 shell 命令。
+执行时只把检查 ID 交给 Skill 的 `scripts/run_verification.py`，不直接拼接
+path/args。
+项目状态校验由 `/ack` 使用 Skill 自带的 `scripts/validate_tasks.py` 和
+`scripts/validate_knowledge.py` 执行。
 
 ## 硬规则（其余见 references/）
 
 - 三角色独立：Coordinator 只编排、Test 只验证、Developer 只实现。
 - 模型分层：Coordinator 强模型不跑测试，Test/Developer 中低模型（见 references/model-routing.md）。
 - `worker_done` 与复测报告都不等于完成，必须 Test 独立复测 + Coordinator 终检后才能 `verified`。
-- 只有 Coordinator 写 `tasks.yaml`；Test 与 Developer 只读。
+- 只有 Coordinator 写 `tasks.yaml` 和 `knowledge.yaml`；Test 与 Developer 只读。
+- Coordinator 只派发按 scope 命中并显式写入 `knowledgeRefs` 的 `active` 知识；
+  `candidate` 不派发，知识库不全量注入。
+- Developer 回报 `knowledgeApplied` 与 `knowledgeCandidates`，Test 回报
+  `knowledgeChecks`；关键约束应继续下沉到测试、lint、CI 或正式规范。
 - 每个任务最多派发 3 轮，仍不过标记 `leftover` 并继续。
 - 不提交或推送，除非用户明确要求。