在需要按固定计划向邮箱/Slack/Teams 发送…

用 PostHog 订阅按固定时间表投递洞察快照、仪表盘快照或 AI 提示报告，并处理收件人、计划、测试、暂停与删除。

适用场景

解决思路

1. 在选择或更改资源类型前，先阅读 references/subscription-types.md。
2. 在创建或更改投递目标前，先阅读 references/destinations.md。
3. 阅读 references/operations.md 了解计划、限制、计费、投递检查与失败处理。
4. 需要创建 AI 提示报告的详细流程时，使用 creating-ai-subscription 技能。
5. 固定投递（如“每周一发送此仪表盘”）用订阅；条件触发（如“转化率低于 10% 时通知我”）用产品告警；用户想稍后私下检查资源用提醒；需要由 agent 判断什么值得报告时用 Signals scout。
6. 注意订阅不评估阈值、恢复、连续违规或免打扰时段；快照订阅即使保存结果未变化，也会在每个计划时间点尝试投递。
7. 可用工具：posthog:subscriptions-list 查找订阅；posthog:subscriptions-retrieve 读取单个订阅；posthog:subscriptions-create 创建订阅；posthog:subscriptions-partial-update 更改、暂停或恢复订阅；posthog:subscriptions-test-delivery-create 发送测试投递；posthog:subscriptions-deliveries-list 列出投递尝试；posthog:subscriptions-deliveries-retrieve 读取单次投递；posthog:subscriptions-delete 停止所有未来投递；posthog:integrations-list 查找 Slack 集成；posthog:integrations-channels-retrieve 查找 Slack 频道；posthog:dashboard-get 读取仪表盘卡片；posthog:insight-get 解析洞察 ID。
8. 创建订阅：1) 调用 posthog:subscriptions-list 检查重复；2) 从 subscription-types.md 选择一种资源类型；3) 按 destinations.md 解析投递目标；4) 按 operations.md 解析计划；5) 询问用户是否要立即投递；6) 将 send_test_now 设为用户选择；7) 调用 posthog:subscriptions-create；8) 读取已保存订阅并核对每个请求字段；9) 若用户同意立即投递，检查其投递记录。
9. 若创建超时或结果不确定，先列出匹配的订阅再重试；创建不是幂等的，盲目重试可能创建重复订阅并发送重复的立即投递。
10. 不要推断缺失的收件人、频道、时间或时区；创建前必须向用户询问这些值。
11. 查找已有订阅时可用过滤条件：resource_type 为 insight、dashboard 或 ai_prompt；target_type 为 email、slack 或 teams；insight 或 insights 为一个洞察 ID 或逗号分隔的 ID 列表；dashboard 为一个仪表盘 ID；dashboard_tiles 为某仪表盘上实时卡片的洞察订阅；created_by 为一个创建者 UUID。
12. 检查重复：当用户提供标题、洞察名、仪表盘名或提示文本时使用 search；提示订阅匹配其标题和提示文本；比较资源、目标类型、目标、计划和启用状态。
13. Teams 结果只包含 webhook 主机；一个主机可服务多个频道，不要用主机判断重复；对可能的 Teams 匹配展示标题、计划、创建者和创建日期；当这些字段能识别订阅时让用户选择；没有字段能识别目标频道时创建新订阅。
14. 创建后核对字段：resource_type 匹配 insight、dashboard 或 ai_prompt；target_type 与安全目标标签匹配请求；enabled 为 true；next_delivery_date 匹配计划与时区；AI 与投递选项匹配用户选择。
15. 更改订阅：每次更新前调用 posthog:subscriptions-retrieve；在可能发送投递的更新前，先列出当前投递 ID；然后用变更字段调用 posthog:subscriptions-partial-update。
16. 在可能发送立即投递的更新前询问用户；MCP 更新工具无法为这些更改抑制立即投递；若用户不批准投递，则不要执行更新。
17. 暂停投递设 enabled: false；恢复投递设 enabled: true；更改收件人时发送完整的新目标；更改目标类型时同时发送 target_type 和 target_value；省略 target_value 可保留已保存的 Teams webhook URL；替换 Teams webhook URL 时发送完整的新 URL。
18. 资源类型不能更改；用户想要不同资源类型时创建新订阅。
19. 计划更新后检查新的 next_delivery_date；已耗尽的计划在用户延长或移除结束条件前无法恢复。
20. 在会发送投递的更新后，轮询新的 target_change 投递 ID；读取该投递直到最终状态；然后检索订阅并检查最终 enabled 值。
21. 测试与检查投递：1) 除非用户已要求测试，否则先请求批准；2) 列出当前投递 ID；3) 调用 posthog:subscriptions-test-delivery-create；4) 轮询新的手动投递 ID；5) 当列表结果需要更多细节时读取新投递。
22. 轮询之间等待，两分钟后停止；若投递未达到最终状态，报告最后状态并建议稍后再查。
23. 测试会发送真实消息；工具在排队投递后返回 202；当另一个测试正在进行或订阅已禁用时返回 409。
24. 投递状态有 starting、completed、failed、skipped；调查失败时按 status 过滤投递列表；排队的工作流不证明已投递；已完成的投递可能包含部分收件人失败；MCP 工具隐藏每个收件人的结果；不要声称每个收件人都成功。
25. 停止订阅：确认订阅 ID 和安全目标标签；除非用户已要求删除或退订，否则请求批准；然后调用 posthog:subscriptions-delete。
26. 通过 MCP 删除是单向软删除；它停止未来投递并释放一个计划名额；用户若再次需要则创建新订阅。
27. 报告结果：说明资源类型、目标类型、计划和下次投递日期；说明订阅是否启用；说明 AI 功能是否会消耗 AI 积分；除非用户确认需要，不要重复邮箱地址；绝不重复 Teams webhook URL。
28. 相关技能：creating-ai-subscription 从自由文本 AI 提示创建报告；building-a-dashboard 先创建仪表盘再订阅；adding-product-alerting 在数据满足条件时通知用户；managing-reminders 安排私下提示检查资源；understanding-billing-usage 调查 PostHog AI 积分使用。

适用边界 · 注意事项

• 投递必须依赖阈值或异常时，应使用产品告警而不是订阅。
• 用户想要私下提示稍后检查资源时，应使用提醒而不是订阅。
• 需要由 agent 判断什么值得报告时，应使用 Signals scout 而不是订阅。