SuperAPI AI 工具集

instrument-repo

智能体与模型

查看项目

更新于 10-16 03:41

技能介绍

用途:为任意仓库添加生产可观测性,自动检测技术栈、安装 SDK、写入配置文件并发起 PR。

主要能力:集成 Sentry(错误追踪)、PostHog(产品分析)、Helicone(LLM 成本追踪)。通过检测语言(TypeScript、Go、Python、Swift、Rust 等)与框架(Next.js、Hono、Express、React Native)决定添加内容;检测是否使用 LLM SDK 以判断是否接入 Helicone;检测已有埋点进入审计模式。

使用方式:在仓库中执行 /instrument-repo,流程包括检测语言/框架/LLM 使用/已有埋点,创建分支 infra/observability,按需通过 mcp__sentry__create_project 创建 Sentry 项目,安装对应包(如 pnpm add @sentry/nextjs posthog-js posthog-node、go get github.com/getsentry/sentry-go、pip install sentry-sdk、sentry = "0.35"),写入模板配置,更新 .env.example,构建校验后提交并创建 PR。支持 --audit 标志进行配置审计并修复。

适用场景:任何应用或服务(必装 Sentry)、面向用户的 Web 应用(加 PostHog)、含 LLM SDK 的项目(加 Helicone)、CLI 工具(Sentry 必装、PostHog 不加)。GitHub Action 或库不适用。

限制与注意:默认采样率 tracesSampleRate 0.1、replaysSessionSampleRate 0、replaysOnErrorSampleRate 1.0;避免 tracesSampleRate 1、缺失 PII 清洗、sendDefaultPii: true、PostHog 未做 /ingest 重写、Helicone 密钥暴露于客户端、硬编码 DSN、PostHog 未设 respect_dnt: true。所有仓库共用一个 PostHog 项目,每个仓库有独立 Sentry 项目。具体 DSN、密钥与部署平台值需按实际环境填写。