From c77a9e69a55e22e9341c18ed94ac73bc287ba19d Mon Sep 17 00:00:00 2001
From: cfdaily <cfdaily@gitee.com>
Date: Wed, 27 May 2026 08:59:12 +0800
Subject: [PATCH] auto-sync: 2026-05-27 08:59:12

---
 docs/design/v2.8-direction-notes.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/design/v2.8-direction-notes.md b/docs/design/v2.8-direction-notes.md
index ada0397..d4eb907 100644
--- a/docs/design/v2.8-direction-notes.md
+++ b/docs/design/v2.8-direction-notes.md
@@ -135,9 +135,10 @@ POST /api/projects/{pid}/tasks/{id}/comments  {"comment_type": "handoff"}
 | 下一个 Agent 怎么拿 | 被动接收注入 | 主动读黑板 |
 
 **具体改动**：
-1. **Prompt 约束新增**：完成任务后必须写 handoff comment（决策、问题、建议）
+1. **Prompt 约束新增**：完成任务后必须写 handoff comment（决策、问题、建议），不超过 500 字，只写决策/权衡/坑/建议，不写实现细节
 2. **BootstrapBuilder 增强**：`_format_depends_on()` 不只读 output 摘要，还读 `comment_type=handoff`
-3. **API 无需改动**：当前 `POST /comments` 已支持 `comment_type` 字段
+3. **API 扩展**：`GET /comments` 需支持 `comment_type=handoff` 查询参数（当前可能不支持，需确认并补充）
+4. **Review 检查**：task review 阶段检查是否有 handoff comment，没有则提醒 Agent 补充
 
 **对齐 PRD v3.0**：这就是 "B3 共享意识" 的具体实现路径——Agent 自己写交接 + 黑板作为共享空间。