feat(ack): add project knowledge guardrails

skills/ack/references/optimization-method.md

@@ -36,7 +36,7 @@
 
 ## 2. 回报必须带证据，不带结论
 
-Developer 的 `worker_done` 应报告：改了哪些文件、跑了哪些命令、自己如何复现验收路径、仍可能有的风险。Test 的复测报告同理：跑了哪些命令、命中/缺失了哪些验收信号、实际观察到什么、证据（snapshot / API 结果）。两者的"结论"都不作数，只有 Coordinator 落盘的 `tasks.yaml` 才是事实。
+Developer 的 `worker_done` 应报告：改了哪些文件、跑了哪些命令、自己如何复现验收路径、仍可能有的风险。Test 的复测报告同理：跑了哪些命令、命中/缺失了哪些验收信号、实际观察到什么、证据（snapshot / API 结果）。两者的"结论"都不作数；任务结论只有 Coordinator 落盘到 `tasks.yaml` 才算数，跨任务知识只有 Coordinator 落盘到 `knowledge.yaml` 才会生效。
 
 不要写：
 
@@ -138,7 +138,41 @@ one dispatch = one bug = one acceptance path
 
 ---
 
-## 9. 结束条件
+## 9. 让经验成为有证据、会过期的知识护栏
+
+项目特有、跨任务复用且会改变后续开发或验证行为的经验，可以提名到项目知识护栏。
+不要把全部对话、日志或单次猜测自动保存成“记忆”。
+
+```text
+Developer / Test 当前任务观测
+  -> knowledgeCandidates（只留在任务证据）
+  -> Test 独立验证 + Coordinator gate
+  -> Coordinator 写入 active knowledge
+  -> stale
+  -> superseded / archived
+```
+
+`prepare(task)` 时只按 component、path、dependency、version 和 tag 推荐相关
+`active` 条目；自动匹配只负责推荐，Coordinator 确认固定 revision 的显式
+`knowledgeRefs` 才是本轮权威上下文。每轮只派发命中的少量条目，不全量注入知识库。
+
+Developer 回报实际采用的 `knowledgeApplied` 和带当前观测证据的
+`knowledgeCandidates`。Test 对本轮显式引用回报 `knowledgeChecks`，并用独立观测
+确认或否定 candidate。同一 Agent 不能把自己读到的旧知识复述成新证据，避免错误
+知识自我强化。
+
+知识中的验证只能引用 `knowledge.yaml.verificationRegistry` 中已经审查的仓库内
+相对 path 和结构化 args，不能把正文或选择器输出拼接成自由 shell 执行。实际运行
+只把 registry ID 交给 `<ack-skill-dir>/scripts/run_verification.py`。安全、正确性
+和兼容性等关键约束一旦稳定，应下沉为测试、lint、CI 或正式规范；知识项继续解释
+触发条件、原因与证据，不替代可执行控制。
+
+依赖、配置、路径或版本变化后应重新审查相关知识。临时 workaround 必须有失效或
+移除条件；冲突规则不能靠“最后写入者获胜”处理。
+
+---
+
+## 10. 结束条件
 
 一轮闭环结束时，必须能回答：
 
@@ -146,5 +180,7 @@ one dispatch = one bug = one acceptance path
 - 每个 leftover 失败了几轮？最后一轮失败证据是什么？
 - 当前工作树有哪些未提交改动？
 - 是否还有 open / failed_retest 未处理？
+- 本轮显式 `knowledgeRefs` 是否都有必要的 `knowledgeChecks`？
+- 是否有待验证 candidate，或因依赖、路径、版本变化需要转为 stale 的知识？
 
 答不清楚，闭环就还没结束。