SuperAPI AI 工具集

check-posthog

数据与分析

查看项目

更新于 10-16 03:41

技能介绍

用途:审计项目中的 PostHog 集成,输出结构化发现报告,按 P0-P3 优先级排序。该技能只做调查与报告,不修改代码;如需创建 GitHub issue 可用 /log-posthog-issues,修复可用 /fix-posthog。

主要能力:检查 SDK 配置(posthog-js 是否安装、环境变量是否配置、Provider 是否存在);检查事件追踪健康度;检查隐私合规(是否配置 mask_all_text/maskAllInputs、identify 调用中是否含 PII);检查功能开关(列出全部 flag,识别 30 天以上未评估、0%/100% 灰度、缺少描述的 flag);检查反向代理设置。

使用方式:先运行环境检测脚本 ~/.claude/skills/posthog/scripts/detect-environment.sh;再通过 grep 检查 package.json、.env.local、next.config.* 等文件;事件与功能开关检查通过 PostHog MCP 工具完成,如 mcp__posthog__event-definitions-list、mcp__posthog__query-run、mcp__posthog__list-errors、mcp__posthog__feature-flag-get-all。

输出格式:按 P0 严重(SDK 未初始化、API key 缺失、事件未流动)、P1 必要(无反向代理、缺隐私掩码、identify 含 PII)、P2 重要(无标准事件、生产环境 debug 模式、过期 flag)、P3 可选(服务端追踪、会话录制、错误追踪集成)分组,并给出当前状态与汇总。

适用场景:上线前或定期审计 PostHog 埋点质量与隐私合规。限制:仅报告不修复;依赖本地脚本与 MCP 工具可用;具体检测结果取决于项目实际配置。