auto-sync: 2026-05-27 08:59:28

docs/design/v2.8-direction-notes.md

@@ -237,13 +237,27 @@ API 已覆盖：读任务、写状态、写产出、写评论、写决策、写
 | 1 | Mail 独立 | 新建 `mail_handler.py`，标注废弃 ticker/dispatcher/spawner | ~130 行 | 无 |
 | 2 | Prompt 进化 | `spawner.py` SPAWN_PROMPT_TEMPLATE 重写（身份+目标+能力+约束+交接责任） | ~60 行 | 无 |
 | 3 | Handoff 上下文 | `bootstrap.py` `_format_depends_on()` 增强：读取 handoff comment | ~30 行 | #2 |
-| 4 | 知识注入 | `spawner.py` 新增 `_inject_wiki_knowledge()` | ~30 行 | NAS 挂载路径修正 |
-| 5 | Bootstrap 增强 | `bootstrap.py` 支持 wiki knowledge 层 | ~20 行 | #4 |
+| 4 | Handoff API | `blackboard_routes.py` `GET /comments` 支持 `comment_type` 查询参数 | ~10 行 | #3 |
+| 5 | Review 检查 | review 流程增加 handoff 检查：无 handoff comment 则提醒 | ~20 行 | #2 |
+| 6 | 知识注入 | `spawner.py` 新增 `_inject_wiki_knowledge()`（含 rg 检查 + grep fallback） | ~40 行 | NAS 挂载路径修正 |
+| 7 | Bootstrap 增强 | `bootstrap.py` `build()` 内部调用 wiki knowledge 层 | ~20 行 | #6 |
 
 ### NAS 挂载路径问题
 
 当前 `~/.obsidian-wiki/config` 配的是 `/Volumes/KnowledgeBase/wiki-vault/`，实际挂载在 `/Volumes/KnowledgeBase-1/wiki-vault/`。需要修正。
 
+### ripgrep 依赖
+
+知识注入用 `rg` 命令 grep index.md。需要检查 macOS 是否安装了 ripgrep，未安装时 fallback 到系统 `grep`。
+
+### 废弃标注方式
+
+Mail 独立时，ticker/dispatcher/spawner 中旧方法标注 `# TODO: remove after v2.8 - use mail_handler instead`，方便后续清理。
+
+### Agent 自主度验证
+
+v2.9 上线后，跑 5 个测试 task，观察不同 Agent（张飞/关羽/赵云）接到新 Prompt 后是否按预期自主决策。
+
 ---
 
 ## 六、工具评估