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 自己写交接 + 黑板作为共享空间。