# signals-scout-apm

Скилл signals-scout-apm ловит регрессии в трассировках PostHog: доля ошибок и p95 по сервисам, новые сигнатуры ошибок, обрывы трафика. Отчёт пишет, только когда сдвиг подтверждён.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 202 установки · ★ 101 у репозитория
- Автор: PostHog
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/signals-scout-apm/SKILL.md
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/signals-scout-apm

## Что делает

Скилл смотрит на спаны OpenTelemetry в PostHog и ищет регрессии по каждой операции внутри сервиса. Считает долю ошибок и p95, сравнивает с тем же окном неделю назад. Сигналом считает рост доли, а не абсолютного числа: всплеск ошибок вместе с всплеском трафика — это объём, а не поломка.

Отчёт скилл пишет сам через канал отчётов (`emit_report`, `edit_report`). Если регрессия уже в инбоксе и продолжает двигаться, он правит существующий отчёт, а не заводит новый. Второй режим — постоянные издержки: N+1, тяжёлые запросы, кандидаты на кеш. Его включают, только когда первый канал молчит, и паттерн должен быть виден и сейчас, и неделю назад на живой трассе.

Работает внутри PostHog Signals agent в песочнице Claude: нужны доступ на чтение аналитики, запись в scratchpad и канал отчётов, семейство инструментов `apm-*` и вложенный скилл `exploring-apm-traces`. Без спанов в проекте прогон закрывается пустым: скилл проверяет `apm-services-list` и число спанов за сутки, оставляет заметку в scratchpad и дальше не идёт. События `$ai_*` и поток логов он не трогает, потому что это чужая территория.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/signals-scout-apm/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/signals-scout-apm/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/signals-scout-apm/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/signals-scout-apm/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/signals-scout-apm
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/signals-scout-apm/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-apm
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/signals-scout-apm/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/signals-scout-apm/SKILL.md

## Когда брать
- поймать рост доли ошибок на операции после выката
- сравнить p95 задержки с тем же окном неделю назад
- отличить настоящую регрессию от всплеска трафика
- найти сигнатуры ошибок, которых у сервиса раньше не было
- выписать операции с N+1 и дорогими запросами под кеш

## Примеры запросов агенту
- Прогони APM-скаут за последние сутки и сравни с прошлой неделей: есть ли регрессии по ошибкам или p95?
- Проверь трассировки за сутки на новые сигнатуры ошибок и обрывы трафика по сервисам
- Покажи операции, где N+1 или тяжёлые запросы тянутся и сейчас, и неделю назад

## Похожие
- [exploring-apm-traces](https://affpapa.org/nevibecode/skills/exploring-apm-traces.md) — скилл · 387 установок
- [signals-scout-ai-observability](https://affpapa.org/nevibecode/skills/signals-scout-ai-observability.md) — скилл · 317 установок
- [dd-apm](https://affpapa.org/nevibecode/skills/dd-apm.md) — скилл · 2200 установок
- [app-observability](https://affpapa.org/nevibecode/skills/app-observability.md) — скилл · 4800 установок
- [observability-and-instrumentation](https://affpapa.org/nevibecode/skills/observability-and-instrumentation.md) — скилл · 70700 установок
- [sentry-otel-exporter-setup](https://affpapa.org/nevibecode/skills/sentry-otel-exporter-setup.md) — скилл · 2500 установок

Из того же набора: [posthog/ai-plugin](https://affpapa.org/nevibecode/by/posthog/ai-plugin.md) — 82 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
