feat(ack): add project knowledge guardrails

skills/ack/templates/project.template.md

@@ -5,9 +5,11 @@
 >
 > **本文件是「项目覆盖层」，文件名可配置。** 默认放 `docs/ack/project.md`，
 > 不占用 `AGENTS.md`，避免与团队已有的 `AGENTS.md` 约定冲突。
-> 若希望 Agent 自动加载，可在项目 `AGENTS.md` 里加一行指向本文件，或直接把本文件命名为 `AGENTS.md`。
+> 若希望 Agent 自动加载，可由项目维护者自行在 `AGENTS.md` 中引用本文件；ACK
+> 不会自动修改 `AGENTS.md`、`CLAUDE.md` 或其它 Agent 指令文件。
 > 无论叫什么，都在 `tasks.yaml` 的 `project.overlayFile` 记录实际路径。
-> `docs/ack/` 只保存本项目的 `project.md` 与 `tasks.yaml`，不复制或链接 Skill。
+> `docs/ack/` 只保存本项目的 `project.md`、`tasks.yaml` 与 `knowledge.yaml`，
+> 不复制或链接 Skill。
 
 ## 项目概览
 
@@ -16,6 +18,7 @@
 - 运行命令：`<run_command>`
 - Base URL：`<base_url>`
 - 任务板：`docs/ack/tasks.yaml`
+- 项目知识：`docs/ack/knowledge.yaml`
 - 覆盖层文件：`<overlay_file_path>`（默认 `docs/ack/project.md`）
 
 ## 通用规范（由 ACK Skill 按需读取）
@@ -48,6 +51,7 @@
 | `<shared_config_templates>` | Read-only | Read-only | R/W | 可提交配置模板 |
 | `<local_config_paths>` | 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 通过回报提名或验证 |
 
 ## 命令（项目覆盖层）
 
@@ -67,13 +71,28 @@ Test 黑盒复测：
 <browser_regression_command>
 ```
 
-任务板校验由 `/ack` 使用 Skill 自带的 `scripts/validate_tasks.py` 执行。
+知识项的 `verification.ref` 只能引用 `knowledge.yaml.verificationRegistry` 中已
+审查的检查入口。Registry 只保存仓库内相对 path 和结构化 args，不保存或执行自由
+shell 命令；新项目没有知识时保持空对象。Developer/Test 只能把 registry ID 交给
+Skill 的 `scripts/run_verification.py` 执行，不直接拼接 path/args。检查脚本从项目
+根 cwd 或 `ACK_PROJECT_ROOT` 定位资源，不能依赖自身文件路径。
+`ACK_PROJECT_ROOT` 是 runner 固定的根目录 fd 路径；仅用于日志的原始路径位于
+`ACK_PROJECT_ROOT_DISPLAY`。
+
+项目状态校验由 `/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`；Developer 与 Test 都只读，通过消息回报。
+- 只有 Coordinator 写 `tasks.yaml` 和 `knowledge.yaml`；Developer 与 Test 都只读，
+  通过消息回报。
+- Coordinator 只派发按 scope 命中并显式写入 `knowledgeRefs` 的 `active` 知识；
+  `candidate` 不派发，知识库不全量注入。
+- Developer 回报 `knowledgeApplied` 与 `knowledgeCandidates`，Test 回报
+  `knowledgeChecks`。关键约束应下沉为测试、lint、CI 或正式规范。
+- ACK 不自动修改 `AGENTS.md`、`CLAUDE.md` 或其它 Agent 指令文件。
 - 每个任务最多派发 3 轮，仍不过标记 `leftover` 并继续下一个。
 - 不提交或推送，除非用户明确要求。