SuperAPI AI 工具集

check-observability

部署与运维

查看项目

更新于 10-16 03:41

技能介绍

用途:审计项目的可观测性基础设施,输出结构化、按优先级排序的发现报告,供后续创建 issue 或修复使用。该技能本身是基础原语,只调查和报告,不执行修复。

主要能力:检查错误追踪(Sentry 是否安装、DSN 是否配置、source maps 配置);检查日志基础设施(是否使用 pino/winston/bunyan 等结构化日志、console 语句数量、是否存在 logger 工具);检查健康端点(是否存在 app/api/health 路由、是否包含数据库/redis 等深度检查);检查分析工具(PostHog 是否安装与配置);检查告警(Sentry 告警、uptime 监控引用);并通过 observability-advocate 代理检测静默失败,如空 catch 块、被吞掉的错误、缺失错误边界、未处理的 promise rejection。

输出:按 P0(生产盲区,如无错误追踪、无健康端点)、P1(必需,如 Sentry 未配置 DSN、无结构化日志、健康检查过浅、无告警、面向用户应用无 PostHog)、P2(重要,如 console 滥用、无 uptime 监控)、P3(可选,如性能监控)分级,并给出当前状态与摘要。

使用方式:以 /check-observability 调用。相关技能包括 /log-observability-issues(据发现创建 GitHub issue)、/fix-observability(修复缺口)、/observability(完整配置流程)、/triage(生产事故响应)。

限制与说明:资料明确不推荐 Vercel Analytics,理由是它无 API、无 CLI、无 MCP server,无法程序化查询,不适合 AI 工作流;PostHog 被视为唯一可接受的分析方案。部分检查依赖本地脚本与 token 配置,未配置时可能无法检查 Sentry 告警。具体安装命令与脚本路径以资料为准。