# signals-scout-ai-observability

Скилл signals-scout-ai-observability отслеживает аномалии в PostHog AI observability: всплески расходов, рост задержек, ошибки и сбои в трейсах LLM.

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

## Что делает

Агент анализирует трейсы LLM в PostHog и ищет устойчивые регрессии. Скилл проверяет метрики затрат, задержки p50, p90 и p99 по отдельным моделям, скачки ошибок `$ai_is_error` и аномалии объёма запросов вроде зацикливаний. Если проблема подтверждается выборкой трейсов, агент сам оформляет или обновляет отчёт через инструменты `scout-emit-report` и `scout-edit-report`.

Каждый запуск начинается с проверки активности. Если за последние 7 дней событий `$ai_*` не было, а расходы близки к нулю, скаут сохраняет запись в скретчпад и мгновенно завершает работу. Повторные отчёты по уже известным инцидентам исключены. Вместо дубликатов агент находит открытый тикет в инбоксе и обновляет его статус.

Для работы требуются инструменты семейства signals-scout и PostHog MCP со скоупами на чтение аналитики и запись отчётов (`signal_scout_report:write`). Без поступающих событий `$ai_generation` или `$ai_trace` запуск завершится пустым результатом.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- выявить двукратный рост расходов на вызовы LLM по моделям
- локализовать скачки задержек p90 и p99 в трейсах генерации
- отследить всплеск ошибок `$ai_is_error` и HTTP-статусов
- обновить существующий отчёт об инциденте в инбоксе без дублирования

## Примеры запросов агенту
- Проверь трейсы PostHog за последнюю неделю на скачки стоимости LLM.
- Найди модели с выросшей задержкой p95 и p99 в наших запросах `$ai_generation`.
- Просканируй инбокс сигналов и обнови статус по ошибкам генерации.

## Похожие
- [signals-scout-apm](https://affpapa.org/nevibecode/skills/signals-scout-apm.md) — скилл · 202 установки
- [agent-observability-trace-rca](https://affpapa.org/nevibecode/skills/agent-observability-trace-rca.md) — скилл · 688 установок
- [agent-observability](https://affpapa.org/nevibecode/skills/agent-observability.md) — скилл · 373 установки
- [observability-scout](https://affpapa.org/nevibecode/agents/observability-scout.md) — субагент · ★ 730 у репозитория
- [observability-llm-obs](https://affpapa.org/nevibecode/skills/observability-llm-obs.md) — скилл · 4400 установок
- [ai-observability-engineer](https://affpapa.org/nevibecode/agents/ai-observability-engineer.md) — субагент · ★ 6505 у репозитория

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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