PostHog 技能用于通过 PostHog API 进行产品分析，适合在用户提及 "PostHog"、"product analytics"、"event tracking" 或用户分析时调用。
用途
该技能面向 PostHog 产品分析 REST API 的操作与数据读取，帮助完成事件追踪数据查询、功能开关管理、实验管理、洞察与仪表盘维护、用户与人群分析等工作。
主要能力
- 组织与项目：列出组织、获取组织详情、列出项目、获取项目详情。
- 功能开关（Feature Flags）：列出、查看详情、创建、更新、删除。创建支持 key、name、active 及 filters（含 groups、properties、rollout_percentage）。
- 实验（Experiments）：列出、查看详情、创建，支持 feature_flag_key、parameters（含 feature_flag_variants 的 control/test 分配比例）与 filters（events）。
- 洞察（Insights）：列出已保存洞察、查看详情、创建趋势（TRENDS）与漏斗（FUNNELS）洞察、删除洞察。趋势示例使用 math 为 total、date_from 为 -30d；漏斗按 order 排列事件。
- 仪表盘（Dashboards）：列出、查看详情（含 tiles 与关联 insight 名称）、创建、删除。
- HogQL 查询：通过 query 端点执行自定义分析查询，示例包括按事件分组统计、按天计数、查询 persons。
- 事件（Events）：列出最近事件、按事件类型筛选（$ 需编码为 %24）。
- 用户（Persons）：列出、按关键词搜索、查看详情。
- 人群（Cohorts）：列出、创建（示例为行为型条件：performed_event，time_value 7、time_interval day、total_periods 3）。
- 注释（Annotations）：列出、创建（content、date_marker、scope）、删除。
- 动作（Actions）：列出、创建（基于 $autocapture 与元素属性条件）。
- 问卷（Surveys）：列出、创建（示例为 popover 类型的 NPS 评分题）。
- 事件定义与属性定义：列出已追踪的事件与可用属性，用于发现数据模型。
使用方式
所有示例均假设已设置 POSTHOG_TOKEN 环境变量，并以 Bearer 方式鉴权；需将 <project-id>、<org-id>、<flag-id>、<experiment-id>、<insight-id>、<dashboard-id>、<person-id>、<annotation-id> 等占位符替换为实际 ID。基础 URL 为 https://us.posthog.com/api；美国云使用 us.posthog.com，欧盟云使用 eu.posthog.com。多数请求为 curl 调用，创建/更新类请求将 JSON 写入 /tmp/posthog_request.json 后用 -d @/tmp/posthog_request.json 提交。
排障提示：若请求失败，可运行 zero doctor check-connector --env-name POSTHOG_TOKEN 或 zero doctor check-connector --url https://us.posthog.com/api/organizations/ --method GET。
适用场景与限制
适用场景包括在产品分析中读取事件与用户数据、管理功能开关与实验、创建与维护洞察和仪表盘、执行自定义 HogQL 分析、维护人群与注释等。
限制与注意事项：应先用 projects 端点获取项目 ID；接口返回使用 count、next、previous 字段分页，可用 ?limit=N&offset=M 分页；复杂分析使用 query 端点与 HogQL；PostHog 存在速率限制，遇到 429 需实现退避；内置事件以 $ 开头（如 $pageview、$autocapture），在查询参数中需将 $ URL 编码为 %24。关于计费、价格、平台支持范围及具体效果，资料暂未提供。