feat(ack): add project knowledge guardrails

skills/ack/examples/tasks.example.yaml

@@ -2,12 +2,14 @@
 version: 1
 updatedAt: "2026-07-06T09:40:00+08:00"
 source: "Coordinator (PM) Agent"
-ackVersion: "0.8.1"
+ackVersion: "0.9.0"
 project:
   name: "notes-web"
   repoPath: "/home/dev/notes-web"
   baseUrl: "http://localhost:5173"
   devWorktree: "/home/dev/notes-web-wt/fix-preview"
+  overlayFile: "docs/ack/project.md"
+  knowledgeFile: "docs/ack/knowledge.yaml"
 
 summary:
   verified: ["BUG-002"]
@@ -27,6 +29,19 @@ tasks:
       - "docs/spec/fix-preview.md#preview"
     testRefs:
       - "tests/browser/cases/01-preview.md"
+    knowledgeRefs:
+      - "K-001@1"
+    knowledgeApplied:
+      - ref: "K-001@1"
+        result: "applied"
+        evidence: "重启服务并核对 commit 后再交给 Test"
+    knowledgeCandidates: []
+    knowledgeChecks:
+      - ref: "K-001@1"
+        result: "passed"
+        evidence: "服务实例、worktree 与 commit 9f8e7d6 一致"
+        checkedBy: "test-worker-1"
+        checkedAt: "2026-07-06T09:36:00+08:00"
     description: >
       用户在 /fix 页点击“预览变更”后，确认区不渲染 API 返回的 diff。
     stepsToReproduce:
@@ -55,9 +70,11 @@ tasks:
       worker: "dev-worker-1"
       rounds:
         - round: 1
+          attemptId: "BUG-002-A1"
           result: failed
           evidence: "只渲染了 title，缺少 before/after/coverChanged"
         - round: 2
+          attemptId: "BUG-002-A2"
           result: passed
           evidence: "复测 4 行 diff 全部出现，取消不触发写入"
     resolution:
@@ -76,6 +93,24 @@ tasks:
     specRefs:
       - "docs/spec/concurrency.md"
     testRefs: []
+    knowledgeRefs: []
+    knowledgeApplied: []
+    knowledgeCandidates:
+      - kind: "pitfall"
+        title: "乐观锁检查必须覆盖批量导入路径"
+        claim: "只在 API 写入路径检查版本号会漏掉批量导入"
+        scope:
+          components: ["server-store"]
+          paths: ["server/store/**"]
+          tags: ["concurrency"]
+        appliesWhen: "修改 note 的并发写入或批量导入逻辑"
+        directive: "同时验证 API 与批量导入的版本冲突处理"
+        rationale: "第二轮修复只覆盖 API，批量导入仍可静默覆盖"
+        evidenceRefs:
+          - "tasks.yaml#BUG-003-round-2"
+        proposedBy: "test-worker-1"
+        proposedAt: "2026-07-06T09:32:00+08:00"
+    knowledgeChecks: []
     description: >
       两个会话同时保存同一条 note 时，后写覆盖先写，无冲突提示。
     stepsToReproduce:
@@ -100,12 +135,15 @@ tasks:
       worker: "dev-worker-1"
       rounds:
         - round: 1
+          attemptId: "BUG-003-A1"
           result: failed
           evidence: "加了版本号但未在写入路径校验"
         - round: 2
+          attemptId: "BUG-003-A2"
           result: failed
           evidence: "校验只覆盖 API，未覆盖批量导入路径"
         - round: 3
+          attemptId: "BUG-003-A3"
           result: failed
           evidence: "乐观锁与前端重试逻辑冲突，需重新设计"
     resolution: