用途:该技能用于为应用添加 PostHog 错误追踪,捕获并监控异常,通常在实现功能后或审查 PR 时使用,确保错误带有完整堆栈和 source map。若尚未安装 PostHog,也涵盖初始 SDK 设置。支持任意平台或语言,包括 React、Next.js、Web(JavaScript)、Node.js、Python、PHP、Ruby、Ruby on Rails、Go、Elixir、Angular、Svelte、Nuxt、React Native、Flutter、iOS、Android、Hono。
主要能力与步骤:按顺序执行。1) 分析代码库并检测平台,查找依赖文件与锁文件确定语言、框架和包管理器,检查是否已有 PostHog 设置,已初始化则跳到第 4 步。2) 研究接入方式,匹配平台参考文件,无匹配则回退到通用知识与 posthog.com/docs 搜索。3) 安装并初始化 SDK,使用包管理器安装命令,不手动编辑 package.json。4) 启用异常自动捕获,自动捕获未处理异常。5) 添加手动错误捕获,在错误边界、catch 块和关键用户流程处添加 posthog.captureException() 或平台等价方法,不改变现有错误处理架构,改动最小化。6) 上传 source map(仅前端/移动端),使堆栈解析到原始源码。7) 设置环境变量,检查已有配置,缺失时可通过 PostHog MCP 的 projects-get 获取 api_token,host 按区域选择 https://us.i.posthog.com 或 https://eu.i.posthog.com,不确定时询问用户,不默认美国云。8) 验证与清理,检查类型或构建脚本,运行 linter 或 prettier 仅限本次编辑或创建的文件。
参考文件涵盖各平台安装、指纹、告警、监控、分配问题、上传 source map 及框架规则。
关键原则:始终用环境变量存 PostHog 密钥,不硬编码;最小改动,与现有错误处理并存;先自动捕获再手动捕获;上传 source map;在错误边界和 catch 块使用 captureException()。
限制:资料未提供具体收费、价格或效果数据;部分平台参考文件存在重复条目;实际可用性取决于对应 SDK 与项目环境。