docs(小宝预警): 更新架构与 Agent 规范

docs/workflow.md

@@ -226,6 +226,19 @@ Implementation convention:
 - Daily report grouping belongs in `apps/web/lib/workspace-daily-report.ts`.
 - Page components should consume report output, not rebuild report rules.
 
+## 小宝预警工作流
+
+小宝预警位于主导航“工作区 / 小宝预警”，展示在“与我相关”上方。可见范围由角色权限控制：
+
+- `xiaobao.warning:manage`：查看所有未结束版本的预警。
+- `xiaobao.warning:view`：仅查看当前用户在 `version.members` 中的未结束版本。
+
+页面打开时会聚合版本下的计划、开发任务、测试用例、Bug、日报和工作活动，计算当前风险并保存当天快照。页面使用 `buildXiaobaoWorkItems` 做版本级聚合，不使用个人工作台的 `aggregateWorkItems(userName, ...)` 过滤。
+
+AI 解读不由人工按钮触发。`at_risk`、`likely_delayed`、`blocked` 自动触发；`attention` 在风险分明显上升、趋势连续上升、关键 Bug 增加、测试失败、阻塞增加、静默风险增加、置信度下降或预测发版日延后时触发。缓存命中时复用解读；缓存保存时间使用客户端时间，不信任模型返回的 `generatedAt` 作为缓存新鲜度。
+
+静默风险包括长期无更新、无日报、无活动、进行中事项无人处理等信号。日报和工作活动是风险解释的重要证据，必须进入 AI 解读输入。
+
 ## 日期选择与计划时间
 
 - 调研、产品方案、UI 设计、开发任务、测试用例、Bug 创建时使用统一工作日日期时间选择器。