diff --git a/docs/design/architecture-v2.6.md b/docs/design/architecture-v2.6.md
index 560b384..61c0a53 100644
--- a/docs/design/architecture-v2.6.md
+++ b/docs/design/architecture-v2.6.md
@@ -1067,6 +1067,13 @@ python3 ~/.sanguo_projects/sanguo_moziplus/cli/blackboard.py decide --task task-
 # 创建任务(任何 Agent 都可以创建)
 python3 ~/.sanguo_projects/sanguo_moziplus/cli/blackboard.py create --title "分钟线数据下载" \
   --creator zhaoyun-data --task-type data
+
+# 写 Handoff Comment（结构化，CLI 校验 Schema）
+python3 ~/.sanguo_projects/sanguo_moziplus/cli/blackboard.py comment --task task-001 --author zhangfei-dev \
+  --handoff '{"completed": "分批加载实现", "artifacts": ["task-001/output.md"], "remaining": "止损逻辑分批适配"}'
+# --handoff 使用 schemas/handoff.schema.json 校验
+# 缺必填字段 → CLI 返回具体错误，如 "Handoff must include 'completed' field"
+# 校验通过 → 自动格式化为结构化评论写入 comments 表
 ```
 
 ---