Notify - 智能通知分发

何时使用此技能

当需要从AI智能体向用户发送通知时使用。涵盖渠道选择、时机、格式以及避免通知疲劳。

通知类型与路由

需避免的关键错误

空通知

BAD:  "Task completed ✅"
GOOD: "✅ Deploy v2.3.1 done. Preview: dev.app.com"

BAD:  "Error occurred"  
GOOD: "❌ Build failed: missing env var STRIPE_KEY in production"

通知轰炸

• 绝不发送“仍在运行”或“一切正常”类消息
• 绝不为10个子任务发送10条消息 - 应合并为1条
• 绝不因可等到上午9点处理的事宜在凌晨3点发送通知

渠道紧急程度误用

BAD:  Critical alert via email (seen 4 hours later)
GOOD: Critical alert via push + SMS

BAD:  Weekly summary via SMS at 11pm
GOOD: Weekly summary via email Monday 9am

格式规则

按渠道划分

• Telegram/Discord：不使用Markdown表格。使用项目符号列表
• 电子邮件：可使用完整格式，须包含可操作的标题行
• 短信：不超过160字符，最关键信息置前
• 推送通知：标题（50字符）+ 正文（最多100字符）

通用规则

• 以结果为导向，而非过程
• 如需采取行动，请包含一个明确的行动项
• 使用用户所在时区的时间戳
• 上下文：内容 + 影响 + 建议行动

时间安排与批量处理

静默时段

• 默认：用户所在时区 23:00 - 08:00
• 紧急（级别 5）可打破静默时段
• 非紧急通知排队，于 08:00 发送

批量处理逻辑

If 3+ notifications within 5 minutes for same project:
  → Combine into single message with summary

If notification is informational (level 1-2):
  → Queue for next digest (morning or evening)

确认格式

安排任何通知时，请确认：

✅ Scheduled: "Weekly metrics report"
📅 Every Monday 09:00 (Europe/Madrid)
📬 Via: Email
🔕 Respects quiet hours: Yes

升级流程

如果用户未响应紧急告警：

1. 等待 2 小时
2. 通过同一渠道发送一次提醒
3. 如果 4 小时后仍无响应：尝试备用渠道（如已配置）
4. 未经明确许可，绝不联系他人
5. 3 次尝试后：记录日志并停止（不无限发送）

用户偏好设置清单

在发送第一条通知之前，需要了解：

• 主要渠道（Telegram/Slack/电子邮件）
• 时区
• 静默时段（或使用默认的23-08）
• 关键警报渠道（相同渠道或短信）

反模式