# troubleshooting-guide

Собирает документ с диагностическими процедурами, частыми сбоями и командами для проверки системы. Пригодится, когда нужно описать, как чинить сервис.

- команда · `type=command` · Claude Code · 397 установок
- Автор: davila7
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/documentation/troubleshooting-guide.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/troubleshooting-guide

## Что делает

Команда `troubleshooting-guide` проходит по вашему проекту и пишет руководство по диагностике. Сначала она смотрит на контекст: ищет `docker-compose.yml` или каталог `k8s/`, определяет тип развёртывания, находит каталоги с логами, проверяет упоминания Prometheus, Grafana и Datadog, вытаскивает эндпоинты здоровья. Дальше на основе этих данных строится структура: обзор архитектуры, категории типовых проблем, порядок изоляции сбоя, уровни серьёзности и пути эскалации.

Внутри — готовые блоки с командами. Проверка ресурсов через `top`, `df -h`, `free -m`, `netstat -tuln`; работа с логами через `tail -f` и `journalctl`; проверка соединения с базой через `mysql` и `psql`. Отдельные разделы под медленные ответы API, ошибки подключения к базе, проблемы с сетью и SSL, утечки памяти в Java и Node.js, сбои контейнеров и подов Kubernetes, отказы аутентификации. Есть справочник кодов ошибок HTTP и матрица эскалации с уровнями P1 и выше.

Команда объявляет доступ к `Read`, `Write`, `Edit` и `Bash`, поэтому она читает файлы проекта и выполняет команды оболочки. Аргумент задаёт область: можно передать конкретный компонент системы или один из флагов `--application`, `--database`, `--network`, `--deployment`, `--comprehensive`. Без аргумента команда не знает, на чём сосредоточиться, так что имя компонента или флаг лучше указать сразу.

## Установка

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

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --command documentation/troubleshooting-guide
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/troubleshooting-guide.md` — Вызов — /troubleshooting-guide. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/troubleshooting-guide.md` — Вызов — /prompts:troubleshooting-guide. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/troubleshooting-guide.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/troubleshooting-guide.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/documentation/troubleshooting-guide.md

## Когда брать
- описать порядок диагностики для нового сервиса
- собрать в одном файле команды проверки ресурсов и логов
- разложить частые сбои по категориям и симптомам
- зафиксировать уровни серьёзности и пути эскалации
- подготовить справочник кодов ошибок HTTP для команды

## Примеры запросов агенту
- /troubleshooting-guide --database
- /troubleshooting-guide --deployment
- /troubleshooting-guide payment-service

## Похожие
- [developer-troubleshooting-docs](https://affpapa.org/nevibecode/skills/developer-troubleshooting-docs.md) — скилл · 10300 установок
- [troubleshooting-astro-deployments](https://affpapa.org/nevibecode/skills/troubleshooting-astro-deployments.md) — скилл · 622 установки
- [omc-doctor](https://affpapa.org/nevibecode/skills/omc-doctor.md) — скилл · 838 установок
- [troubleshooting-efs](https://affpapa.org/nevibecode/skills/troubleshooting-efs.md) — скилл · 5900 установок
- [gke-workload-troubleshooting](https://affpapa.org/nevibecode/skills/gke-workload-troubleshooting.md) — скилл · 4600 установок
- [bigquery-troubleshooting](https://affpapa.org/nevibecode/skills/bigquery-troubleshooting.md) — скилл · 1400 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 205 карточек

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

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