managing-reminders

リマインダーの管理

このスキルでは、PostHog のリマインダーの作成と管理について説明します。 リマインダーは、設定したスケジュールでアプリ内通知を送る、自分専用の人のペースに合わせたリマインドです。 条件は付けず、任意で PostHog のリソースにリンクできます。

このスキルを使うタイミング

次のような場合にこのスキルを使います。

• ユーザーが「〜するようにリマインドして」「念押しして」「通知して」「忘れないようにして」などと言った場合
• 特定の日時に一度だけリマインドしてほしい場合
• 定期的なリマインダー（毎日、毎週、毎週月曜日、平日、毎月など）を設定したい場合
• 特定のダッシュボード、インサイト、実験、フラグ、アンケート、ノートブック、リプレイ、またはエラーの確認をリマインドしてほしい場合
• 設定済みのリマインダーを確認、変更、またはキャンセルしたい場合

リマインダー、アラート、サブスクリプションの違い

この3つは似ていますが、用途が異なります。適切なものを選んでください。

• リマインダー — 条件なしで、自分自身に人のペースに合わせたリマインドを送ります。設定したスケジュールでアプリ内通知を送るだけです（「毎週月曜日にローンチダッシュボードを確認するようリマインドして」）。 ユーザーが**「〜するようにリマインドして」**と言った場合は、リマインダーです。
• アラート — インサイトの指標をスケジュールに従って監視し、しきい値や異常の条件を満たした場合にのみ通知します（「サインアップ数が100を下回ったら教えて」）。
• サブスクリプション — インサイトまたはダッシュボードのエクスポート／スナップショットを、メール、Slack、または Webhook でスケジュールに従って配信します（「このダッシュボードを毎朝メールで送って」）。

評価する条件がある場合はアラートです。配信するエクスポートがある場合はサブスクリプションです。単に人に時間を知らせるリマインドであれば、リマインダーです。

必須フィールド

すべての reminder-create 呼び出しには、必ず title を含めてください。これは通知のタイトルとして表示される短いテキストです。ユーザーの依頼をもとに記述します（「ローンチダッシュボードを確認するようリマインドして」の場合は、"Review the launch dashboard" を使います）。

organization は省略してください。サーバーがアクティブな組織から設定します。

ユーザーが別の組織を指定し、その ID も伝えた場合に限り、organization を指定します。組織名は伝えられたものの ID がない場合は、先に ID を尋ねてください。値を推測したり、フィールドを省略したりしないでください。organization を省略すると、ユーザーが指定した組織ではなく、アクティブな組織にリマインダーが設定されます。

プロジェクトが分かっている場合は、team（数値のプロジェクト ID）も設定してください。リソースを関連付ける場合に必須であり、プロジェクトのタイムゾーンがデフォルトになります。

スケジュールの形式

リマインダーでは、scheduled_at、recurrence_interval、cron_expression のうちいずれか1つだけを使用します。0個または複数指定すると、リクエストは拒否されます。

1回限り

scheduled_at に、未来の ISO 8601 タイムスタンプを設定します。リマインダーは1回だけ送信され、その後 completed になります。

ユーザーの発言	フィールド
"remind me tomorrow at 3pm"	scheduled_at: <tomorrow 15:00 in the user's tz>
"remind me on Jan 5 at 9am"	scheduled_at: "2026-01-05T09:00:00" (+ timezone)

プリセットの繰り返し

recurrence_interval に、daily、weekly、monthly、yearly のいずれかを設定します。

ユーザーの発言	フィールド
"every day"	recurrence_interval: "daily"
"every week"	recurrence_interval: "weekly"
"every month"	recurrence_interval: "monthly"
"every year"	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日の正午」	cron_expression: "0 12 1 * *"

リマインダーの通知は1日に最大4回までです。それより頻度の高い cron（例：1時間ごと）は拒否されます。

タイムゾーン

ユーザーの 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 を解決します（例：インサイトを取得して short_id を確認します）。リンクされたリソースのない単独のリマインダーでは、両方のフィールドを省略してください。

プライバシーとライフサイクル

• リマインダーは作成したユーザーだけが参照でき、組織に属し、任意で1つのプロジェクトにスコープを設定できます。他のユーザーには表示されません。
• 通知はアプリ内通知として送信されます。メール、Slack、Webhook ではありません。
• 一回限りのリマインダーは、通知が発火すると completed になります。
• 繰り返しのリマインダーは、削除されるまで、または任意の end_date を過ぎるまで active のままです（その後 completed になります）。
• 配信が恒久的に失敗した一回限りのリマインダーは errored になります。ユーザーのリマインダーについて報告する際は、reminders-list でこの状態を確認してください。

MCP ツール

• reminder-create — リマインダーを作成する
• reminders-list — ユーザーのリマインダーを一覧表示する（スケジュール、ステータス、次回の通知時刻）
• reminder-get — ID でリマインダーを1件取得する
• reminder-update — タイトル、メッセージ、スケジュール、タイムゾーン、終了日、または添付リソースを更新する（スケジュールを変更すると、次回の通知時刻が再計算されます）
• reminder-delete — リマインダーを削除し、通知を停止する

使用例

ユーザー：「ローンチダッシュボードを毎週月曜日の午前9時に確認するよう、リマインドしてください。」

1. アクティブなプロジェクトからプロジェクト ID を取得します。
2. ダッシュボード ID を解決します（例：dashboard 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 を使用）と、ユーザーが削除するまで毎週通知が発火し続けることをユーザーに伝えてください。