用途:修复项目中的可观测性缺口。它先调用 /check-observability 审计监控,找出最高优先级问题,只修复这一个问题,然后验证并报告结果;需要继续处理时再次运行。完整搭建可改用 /observability。
主要能力与优先级:P0 为缺少错误追踪、缺少健康检查端点;P1 为 Sentry 配置、结构化日志、告警;P2 为分析埋点、控制台清理;P3 为性能监控。
使用方式:先创建分支 git checkout -b infra/observability-$(date +%Y%m%d)。缺少错误追踪时可用 pnpm add @sentry/nextjs 与 npx @sentry/wizard@latest -i nextjs,或运行 ~/.claude/skills/sentry-observability/scripts/init_sentry.sh。缺少健康端点时创建 app/api/health/route.ts。Sentry 配置需在 .env.local 添加 NEXT_PUBLIC_SENTRY_DSN、SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT。结构化日志可 pnpm add pino 并创建 lib/logger.ts。告警可用 ~/.claude/skills/sentry-observability/scripts/create_alert.sh。PostHog 分析需 pnpm add posthog-js,按模板创建 lib/analytics/posthog.ts 与 components/providers/PostHogProvider.tsx,在 app/layout.tsx 包裹 children,并配置 NEXT_PUBLIC_POSTHOG_KEY、NEXT_PUBLIC_POSTHOG_HOST。
验证:运行 ~/.claude/skills/sentry-observability/scripts/verify_setup.sh,或用 curl -s http://localhost:3000/api/health | jq 检查健康端点。
限制:每次只修一个问题,便于独立测试与排查;具体项目结构、依赖版本和平台支持等资料未提供。