managing-reminders

管理提醒

此技能将指导你创建和管理 PostHog 提醒。 提醒是向自己发送的私人提示，节奏由你掌控：它会按计划触发应用内通知， 且不附带任何条件。你还可以选择将其关联到 PostHog 资源。

何时使用此技能

用户有以下需求时，请使用此技能：

• 说“提醒我……”“提示我一下”“给我发个提醒”或“别让我忘了”
• 想在特定日期/时间收到一次性提醒
• 想设置重复提醒（每天、每周、每周一、工作日、每月等）
• 想收到提醒，以便查看特定的仪表板、洞察、实验、标记、问卷、笔记本、回放或错误
• 想查看、更改或取消已设置的提醒

提醒、告警和订阅的区别

这三者看起来相似，但用途不同。请选择合适的类型：

• 提醒 — 向自己发送的提示，节奏由你掌控，且没有条件。它只会按计划触发 应用内通知（“提醒我每周一查看发布仪表板”）。 如果用户说**“提醒我……”**，这就是提醒。
• 告警 — 按计划监控洞察中的指标，并且只有在满足阈值或异常条件时才通知 （“如果注册量低于 100，就告诉我”）。
• 订阅 — 按计划通过电子邮件、Slack 或 webhook 发送洞察或仪表板的导出内容/快照 （“每天早上把这个仪表板发给我”）。

如果需要评估条件，就是告警。如果需要发送导出内容，就是订阅。如果只是按时提醒某个人，就是提醒。

必填字段

每次调用 reminder-create 都必须包含 title。这是通知中显示的简短标题。根据用户的请求撰写（对于“提醒我查看发布仪表板”，使用 "Review the launch dashboard"）。

省略 organization。服务端会根据当前激活的组织填写该字段。

只有当用户指定了其他组织并提供了其 ID 时，才传入 organization。如果用户指定了组织但未提供 ID，请先询问 ID，再继续操作。不要猜测该值，也不要改为省略此字段：省略 organization 会将提醒添加到当前激活的组织，而不是用户指定的组织。

如果你知道项目，还应设置 team（数字项目 ID）。关联资源时必须提供此字段；此外，它还会将项目时区设为默认时区。

计划类型

提醒必须且只能使用 scheduled_at、recurrence_interval 或 cron_expression 中的一个。未提供或提供多个都会被拒绝。

一次性提醒

将 scheduled_at 设为未来的 ISO 8601 时间戳。提醒触发一次后会变为 completed。

用户说	字段
“明天下午 3 点提醒我”	scheduled_at: <tomorrow 15:00 in the user's tz>
“1 月 5 日上午 9 点提醒我”	scheduled_at: "2026-01-05T09:00:00"（+ timezone）

预设重复提醒

将 recurrence_interval 设为 daily、weekly、monthly、yearly 之一。

用户说	字段
“每天”	recurrence_interval: "daily"
“每周”	recurrence_interval: "weekly"
“每月”	recurrence_interval: "monthly"
“每年”	recurrence_interval: "yearly"

Cron 循环提醒

当频率是特定星期或时间，且预设无法表达时，将 cron_expression 设置为 5 字段 cron 字符串（min hour day-of-month month day-of-week）。

用户说	字段
“每周一上午 9 点”	cron_expression: "0 9 * * 1"
“工作日上午 8:30”	cron_expression: "30 8 * * 1-5"
“每月 1 日中午 12 点”	cron_expression: "0 12 1 * *"

提醒每天最多触发 4 次——更频繁的 cron（例如每小时一次）会被拒绝。

时区

已知用户的 IANA 时区时，始终传入 timezone（例如 "America/New_York"），以便像“上午 9 点”这样的当地时间能解析为正确时刻。若省略，当设置了 team 时会默认为项目时区，否则默认为 UTC。Cron 和预设计划会按此时区解析；scheduled_at 是绝对时刻，因此请包含时区偏移，或依赖同一时区。

关联资源

要将提醒关联到 PostHog 对象，请同时设置 resource_type、resource_id 和 team。触发的通知会深度链接到该对象。资源必须已存在于该项目中。即使 ID 是数字，也始终将 resource_id 作为字符串传入（"67"，而不是 67）。

resource_type	resource_id 是……
dashboard	数字 ID
insight	short_id
experiment	数字 ID
feature_flag	数字 ID
survey	ID
notebook	short_id
replay	session_id
error_tracking	issue ID

如果用户提供的是名称或 URL，请先解析 ID（例如，获取 insight 以取得其 short_id）。对于没有关联资源的独立提醒，请省略这两个字段。

隐私与生命周期

• 提醒仅创建者可见，并归属于某个组织，也可以选择限定到某个项目。其他用户永远看不到这些提醒。
• 提醒以应用内通知的形式触发，不会通过电子邮件、Slack 或 webhook 发送。
• 单次提醒触发后会变为 completed。
• 循环提醒会保持 active，直到被删除，或其可选的 end_date 到期（之后会变为 completed）。
• 如果单次提醒的发送永久失败，则会变为 errored——向用户汇报提醒情况时，通过 reminders-list 呈现此状态。

MCP 工具

• reminder-create — 创建提醒
• reminders-list — 列出用户的提醒（计划、状态、下次触发时间）
• reminder-get — 按 ID 获取一条提醒
• reminder-update — 更新标题、消息、计划、时区、结束日期或关联资源（更改计划会重新计算下次触发时间）
• reminder-delete — 删除提醒，停止其触发

示例

用户：“提醒我每周一上午 9 点查看发布仪表板。”

1. 从当前项目获取项目 ID。
2. 解析仪表板 ID（例如，仪表板 67）。
3. 选择计划形式：特定星期 + 时间 → cron。
4. 已知用户时区时，将其传入。
5. 使用必填的 title 调用 reminder-create：

{
  "team": 12345,
  "title": "Review the launch dashboard",
  "resource_type": "dashboard",
  "resource_id": "67",
  "cron_expression": "0 9 * * 1",
  "timezone": "America/New_York"
}

根据响应中的 next_fire_at 告知用户下次触发时间，并确认提醒会每周持续触发，直到用户将其删除。