SuperAPI AI 工具集

fix-posthog

通用与其它

查看项目

更新于 10-16 03:41

技能介绍

用途:fix-posthog 用于修复 PostHog 集成中的问题。它会先运行 /check-posthog 识别问题,然后挑选最高优先级的未修复问题,实施修复、验证修复是否生效,并报告修复内容。每次调用只修复一个问题,需多次运行才能修复多个问题。

主要能力与修复范围:按优先级处理常见问题。P0 包括 SDK 未初始化(initPostHog() 未调用或缺少 PostHogProvider)和 API Key 缺失(NEXT_PUBLIC_POSTHOG_KEY 未设置)。P1 包括未配置反向代理(直连 PostHog 主机易被广告拦截器拦截)、缺少隐私掩码(mask_all_text 与 maskAllInputs 未配置)、identify() 调用中包含 PII(如邮箱、姓名)。P2 包括缺少标准事件(未定义类型化事件 schema)。

使用方式:运行 /fix-posthog 触发流程。修复时可能使用 codex exec --full-auto 执行具体改动,例如创建 lib/analytics/posthog.ts、添加 PostHogProvider、在 next.config 中添加 /ingest/* 反向代理重写、更新 posthog.init 使用 api_host: '/ingest'、添加隐私设置、移除 identify 中的 PII、添加类型化事件 schema 等。API Key 缺失时需从 PostHog 仪表板获取密钥,写入 .env.local,并通过 vercel env add NEXT_PUBLIC_POSTHOG_KEY production 添加到 Vercel 生产环境。

验证:修复后可通过 MCP 使用 mcp__posthog__query-run 查询最近 1 小时趋势,或用 mcp__posthog__list-errors 检查错误;也可在浏览器 DevTools 的 Network 中筛选 ingest 或 posthog,触发操作后确认请求成功,并在 PostHog Live Events 中确认事件出现。

适用场景与限制:适合使用 PostHog 的 Next.js 项目进行集成审计与增量修复。每次仅修复一个问题,需重复调用;具体修复命令与参考文件路径来自资料,实际可用性取决于项目环境与权限。其他未在资料中说明的功能、收费或平台支持暂未提供。