Beaver 通知机制规范 (Notification System)
Beaver 旨在解决研发过程中的信息过载与协同断层问题。通过“分级、分发、分时”的智能通知机制，Beaver 确保正确的人在正确的时间收到正确且高信噪比的信息。
1. 核心触达渠道
Beaver 的所有触达将根据紧急程度与受众范围，路由至以下三个主要渠道：
- 私信 (Direct Message / IM): 面向个人开发者。用于推送专属的待办清单、Code Review 请求、以及针对个人的合规性预警。
- 公共/管理频道 (Public Channel): 面向架构师、项目经理及全体成员。用于推送项目整体进度、风险预警、上下游阻塞状态和全局统计报告。
- GitHub 评论 (GitHub Comments): 直接在对应的 Issue 或 Pull Request 下留言。用于提供强上下文的合规性指引、补充测试要求或状态流转建议。
2. 场景与触达矩阵
Beaver 将通知按照时效性与业务目的划分为四大类：实时告警、晨间提醒、周期性报告 和 异步长尾监控。
2.1 实时告警 (Real-time Alerts)
定位：需要干系人立即关注与响应的高风险或阻塞性事件，强调“阻断”与“求助”。
| 触发场景 | 推送对象 | 触达渠道 | 通知内容与预期目的 |
|---|---|---|---|
| 新增 P0/Blocker 缺陷 | 负责人、管理团队 | 私信 + 公共频道 | 预警卡片：包含 Bug 描述与快速复现链接。目的：要求负责人立即排查，停止其他低优先级任务。 |
| 任务状态变更为 Blocked | 上下游负责人、项目经理 | 公共频道 | 阻塞求助：包含阻塞的具体原因、AI 解析出的上游依赖链路。目的：呼叫跨团队资源协调，迅速解除阻塞。 |
| PR 紧急 Review 请求 | 指定 Reviewer | 私信 | Review 邀请：包含 PR 链接、代码变更规模及 LLM 预估的 Review 时长。目的：减少 PR 滞留时间，加速主干合并。 |
| 流程合规性违规拦截 | 操作者 (开发者) | GitHub 评论 + 私信 | 合规指引：明确指出违规项（如：核心逻辑超 200 行、缺失测试证据、非法状态跳跃）及具体的修正建议。目的：实时纠正错误流程，保障研发质量底线。 |
2.2 晨间 Focus 提醒 (Morning Focus)
定位：每日工作规划与资源对齐，强调“聚焦”与“调度”。 触发时间：工作日 09:00 (本地时间)
| 触发场景 | 推送对象 | 触达渠道 | 通知内容与预期目的 |
|---|---|---|---|
| 个人专属待办清单 | 开发者 | 私信 | Focus 列表：智能罗列今日名下处于 status/in-progress、status/ready-to-develop 的核心任务。特殊高亮：利用显眼的标识 (如 ⏳) 标出临近 DDL (<48h) 或已存在延期风险的任务。 |
| 未分配资源调度池 | 项目经理 / 架构师 | 公共频道 | 待调度列表：汇总当前处于 status/triage 待分拣阶段，或已过初筛但无 assignee (负责人) 的任务卡片，并附带 AI 初步建议的规模与优先级。目的：推动团队每日的新增工作负载调度。 |
2.3 周期性报告 (Periodic Sync)
定位：全局进度同步与深度风险诊断，强调“透明”与“复盘”。
| 触发场景 | 推送对象 | 触达渠道 | 通知内容与预期目的 |
|---|---|---|---|
| 每日进展同步 (日报) | 全体成员 | 公共频道 (工作日 18:00) | 昨日看板概览：汇总当日新晋 status/done 的成果、依然 in-progress 的活跃任务。风险链条：由 LLM 提取当日讨论中的核心风险点和潜在阻塞链条，保持全局透明。 |
| 每周健康诊断 (周报) | 全体成员 | 公共频道 (周五 18:00) | 项目深度体检：展示当前 Milestone 达成度、研发吞吐量 (Size L/S 分布)、PR 平均响应时长 (Cycle Time) 趋势，以及代码质量债务的回溯预警。 |
| 迭代闭环复盘 (Retrospective) | 全体成员 | 公共频道 (Milestone 结束时) | Sprint 总结：表彰典范 (合并最快/零阻塞 - The Good)、复盘最长阻塞/最多违规操作 (The Bad)、以及 LLM 基于本期痛点自动生成的下一迭代流程优化建议 (Action Item)。 |
2.4 异步长尾与超时监控 (Time & Stale)
定位：防止任务遗漏、“僵尸卡片”堆积或进度悄然失控。
| 触发场景 | 推送对象 | 触达渠道 | 通知内容与预期目的 |
|---|---|---|---|
| 长尾停滞 (Stale) | 任务负责人 | 私信 + GitHub 评论 | 跟进询问：当任务在特定活跃状态（如 in-progress 或 review-needed）无代码提交或讨论停留超过健康阈值（如 >5天），Beaver 自动挂载 beaver/stale 标签，并私信询问是否遇到困难、需资源倾斜或重新评估规模。 |
| 任务已逾期 (Overdue) | 任务负责人、项目经理 | 私信 + 公共频道 | 进度脱控报警：当前时间已超过该任务设定的 DDL。Beaver 自动挂载 beaver/overdue 标签，要求负责人立即更新最新状态并评估对整体进度的延期影响。 |
3. 降噪与免打扰原则 (Anti-Spam)
为了避免 Beaver 本身成为新的“信息噪音源”，系统内置以下防护机制：
- 事件防抖与聚合 (Debounce)：对于高频发生的关联事件（如：短时间内多个关联子任务的并发状态变更），Beaver 会在后台缓存队列中进行防抖与语义聚合，合并为单条高质量的上下文通知。
- 状态感知静音 (OOT/Busy)：若开发者在协作平台或 GitHub 设置了 "Busy" (忙碌) 或 "Out of office" (休假) 状态，除 P0 级 Blocker 之外的所有非紧急通知将延后推送，或仅在次日晨间做轻量汇总。
- 动态解释阈值：对于经验丰富的核心贡献者，Beaver 将逐渐减少流程合规性警告中的“冗余解释字数”，仅提供最核心直接的 Action Item，保持沟通干练。