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

docs/agent-spec.md

@@ -105,9 +105,26 @@
 - 不自动分配 assignee；AI 只提供可选推荐，用户确认采纳后才写入
 - 不做"上一版基准 diff"
 
-### Agent 2：Risk Watch Agent（风险预警）— 待规划
+### Agent 2：Risk Watch Agent（小宝预警解读）
 
-仅占位，正式规划见 roadmap.md V3.2。
+**目的**：解释小宝预警规则引擎输出的版本发版风险结果，生成项目经理可读的风险原因、延期预测、建议发版窗口和处理动作。
+
+**输入**：
+- 版本上下文：产品、项目、版本、期望发版日期。
+- 规则风险结果：`riskScore`、`riskLevel`、`forecastReleaseDate`、`delayDays`、`confidence`、风险信号。
+- 趋势和快照：风险分变化、连续上升/下降、关键 Bug、失败用例、阻塞和静默风险变化。
+- 日报与工作活动证据：今日交付、今日进展、今日风险、进展备注、需要补充进展的事项。
+
+**触发**：
+- `on_track` 不触发。
+- `at_risk`、`likely_delayed`、`blocked` 自动触发。
+- `attention` 在风险分明显上升、趋势连续上升、关键 Bug 增加、失败用例增加、阻塞增加、静默风险增加、置信度下降或预测发版日延后时触发。
+
+**输出**：`summary`、`why[]`、`forecast`、`recommendedReleaseWindow`、`suggestedActions[]`、`ownerHints[]`。
+
+**权限**：读规则结果和压缩证据；写 `xiaobao-risk-insights` 缓存。不修改 Version、Requirement、DevTask、TestCase、Bug、Member。
+
+**失败回退**：AI 不可用时保留规则预警，前端显示“规则预警已生成，AI 解读会在触发条件满足时自动补充”。AI 失败不影响快照保存和规则风险展示。
 
 ### Agent 3：Schedule Suggest Agent（排期建议）— 待规划