1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ai-plugin-posthog |
| 作者/维护者 | PostHog（官方） |
| 来源链接 | https://github.com/PostHog/ai-plugin |
| 许可证 | MIT（数据来自仓库 .claude-plugin/plugin.json 与 README，明确标注） |
| GitHub Stars | 75（数据来自 GitHub API） |
| Forks | 14（数据来自 GitHub API） |
| 最新版本 | 1.1.57（数据来自 plugin.json） |
| 安装方式 | 各平台官方插件市场一条命令安装，见第 10 章 |
2. 功能介绍与亮点
PostHog 官方发布的 AI 编码工具插件，让 agent 直接连上你的 PostHog 工作区，处理产品分析、功能开关、A/B 实验、错误追踪、会话回放、问卷调查、LLM 分析、仪表盘与数据仓库等全部主要模块。内部由一个路由技能加 137 个任务型子技能组成，每个子技能只在明确命中对应场景时才加载（例如“创建实验”会先走三步澄清流程，再委派细节给专门的子技能），避免一次性把大量指令塞进上下文。
主要亮点：
- 官方出品，代码与技能内容完全开源可审计
- 内置写操作二次确认门：默认对功能开关变更、删除类操作、实验上线等敏感写操作重新弹出确认提示，避免一次授权后所有写操作静默放行
- 认证走 OAuth 浏览器登录，无需手工保存 API Key
- 维护极其活跃，每周随 PostHog 技能库自动同步更新
3. 适用场景
固定分类：集成与工作流自动化。
适合已经在用 PostHog 做产品分析、功能开关或 A/B 实验的开发者与产品经理——不用切出编码环境查后台，直接让 agent 查询指标、创建或调整实验、诊断 SDK 埋点问题、排查错误。
4. 跨 Agent 兼容性
- Claude Code：原生支持（官方 Claude Code 插件市场一条命令安装）
- Codex：原生支持（官方 Codex 插件市场一条命令安装）
- OpenClaw：未验证（仓库未提供对应清单，材料中无相关信息）
- Hermes Agent：未验证（仓库未提供对应清单，材料中无相关信息）
补充：仓库同时提供 Cursor、Gemini CLI、Grok 的官方安装方式，覆盖面超出上述四个目标生态。
5. 推荐理由
官方出品、多平台一条命令安装、覆盖 PostHog 全部主要模块，且对敏感写操作有专门的二次确认设计，是目前分析类 agent 集成里安全与完整度都突出的一个。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | PostHog 官方自主发布；Claude 官方插件市场页面显示该插件安装量 13,453 次（已抓取验证） |
| 可用性 | 8 | 一条命令安装 + OAuth 浏览器登录即可用，文档与示例完整，近一天内仍有提交，维护极活跃；需连接 PostHog 账号（含免费额度）才能使用 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单： ① Shell 命令执行：仅两个可选 hook 脚本，一个是写操作二次确认门（默认更严格，不放宽权限），另一个是可选关闭的会话遥测上报，均非核心功能必需 ② 联网外发：核心功能即调用 PostHog 官方 API，用途透明，与技能声明一致 ③ 凭据存储：OAuth 浏览器登录，不在本地明文保存 API Key；可选遥测功能才涉及一个环境变量形式的 API Key，且默认关闭 ④ 可疑指令：技能文本内容清晰专业，未发现提示注入迹象 ⑤ 作者信誉：PostHog 为知名产品分析公司，官方自主发布，无造假迹象 ⑥ License：MIT，仓库与插件清单均有明确声明 ⑦ 最近维护：近一天内有提交，按周自动同步
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| Sentry 官方技能（getsentry/sentry-for-ai） | 专注错误追踪与调试问题排查 | 只覆盖错误监控这一个切面，不涉及产品分析、功能开关或实验管理 |
| Datadog 可观测性技能 | 专注生产系统的监控告警与链路追踪 | 面向基础设施可观测性，不提供产品分析、用户行为洞察或 A/B 实验功能 |
| Mixpanel / Amplitude 等分析平台 | 主流产品分析工具，但通常无官方 agent 技能包 | 需要自行封装 API 调用才能接入 agent，缺少开箱即用的官方技能与安装渠道 |
8. 用户评价
该插件目前在 Reddit、Hacker News 等平台尚无具名用户评价。已验证的采用度信息：该插件在 Anthropic 官方 Claude Plugin 市场页面（claude.com/plugins/posthog）上架，页面显示安装量 13,453 次。
9. 其他补充
前身仓库 PostHog/posthog-for-claude（专注 Claude Code）已归档，README 注明内容已并入本仓库，是同一官方产品线的延续而非另起炉灶。
10. 安装使用方式
- Claude Code：
claude plugin install posthog，随后在会话中执行/mcp，按浏览器提示完成 PostHog OAuth 登录 - Codex：
codex plugin marketplace add PostHog/ai-plugin，再在 Codex 内执行/plugins选择 PostHog 安装 - Cursor：从 Cursor Marketplace 安装，或在 Cursor Settings > Plugins 手动添加
- Gemini CLI：
gemini extensions install https://github.com/PostHog/ai-plugin - Grok：
grok plugin install PostHog/ai-plugin --trust，首次使用工具时按提示完成 OAuth 授权
安装后注意：需要一个 PostHog 工作区账号（提供免费额度）完成 OAuth 授权后才能实际调用工具；无需重启，授权完成后即可在对话中使用。
11. 注意事项
- 使用前必须先有 PostHog 账号并完成 OAuth 连接，纯离线场景无法使用
- 可选的 Claude Code 会话遥测上报功能默认关闭，需要显式设置环境变量才会启用，启用前建议先确认是否符合自身隐私要求
- 技能库体量较大（137 个子技能一次性随插件安装），暂无按需选装单个子技能的官方选项