# Systematic Debugging

> Находить корневую причину бага системно — через сужение области, а не через угадывание и случайные правки. Используй при сообщениях "не работает", "падает с ошибкой", "неожиданное поведение", "баг", когда причина неочевидна из первого взгляда на стектрейс. Особенно важно применять вместо того, чтобы менять код наугад и смотреть, помогло ли.

- **Type:** Skill
- **Install:** `agentstack add skill-alex7develop-my-agent-skills-systematic-debugging`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Alex7develop](https://agentstack.voostack.com/s/alex7develop)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Alex7develop](https://github.com/Alex7develop)
- **Source:** https://github.com/Alex7develop/my-agent-skills/tree/main/skills/systematic-debugging
- **Website:** https://skills.sh/Alex7develop/my-agent-skills

## Install

```sh
agentstack add skill-alex7develop-my-agent-skills-systematic-debugging
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Systematic Debugging

Главная ловушка при отладке — начать менять код до того, как понята причина.
Это либо случайно "лечит" симптом, оставляя причину, либо создаёт новый баг.

## Процесс

1. **Воспроизвести надёжно.** Если баг не воспроизводится стабильно —
   сначала добиться стабильного воспроизведения (минимальный набор шагов/
   входных данных), иначе непонятно, исчез баг или просто не проявился.
2. **Сформулировать гипотезу явно.** Одно предложение: "я думаю, причина —
   X, потому что Y". Не переходить к правке кода без этого шага.
3. **Проверить гипотезу минимальным способом** — логом, брейкпоинтом,
   изолирующим тестом. Не чинить, пока гипотеза не подтверждена.
4. **Сузить область бинарным поиском**, если причина не очевидна:
   отключать/изолировать половину системы за раз, а не проверять компоненты
   по одному в случайном порядке.
5. **Найти корневую причину, не только точку симптома.** "Здесь падает
   NullPointerException" — это симптом. "Функция X не гарантирует
   инициализацию перед вызовом Y при условии Z" — это причина.
6. **Написать тест, который воспроизводит баг**, прежде чем чинить (см.
   навык `test-driven-development`) — это доказательство, что причина понята
   верно, и защита от регрессии.
7. **Исправить причину, не симптом.** Если фикс — это просто добавленная
   проверка `if x is None: return`, спросить себя, почему x стал None и
   не должен ли быть исправлен источник, а не место обнаружения.

## Сигналы, что вы гадаете, а не отлаживаете

- Меняете код и запускаете "чтобы посмотреть, поможет ли"
- Не можете сформулировать причину бага одним предложением
- Правка "работает", но вы не понимаете, почему баг исчез

Если заметили один из этих сигналов — вернуться на шаг 2 и явно
сформулировать гипотезу, прежде чем продолжать.

## Формат вывода при передаче результата

```
**Причина:** 
**Как воспроизвести:** 
**Тест, воспроизводящий баг:** 
**Фикс:** 
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Alex7develop](https://github.com/Alex7develop)
- **Source:** [Alex7develop/my-agent-skills](https://github.com/Alex7develop/my-agent-skills)
- **License:** MIT
- **Homepage:** https://skills.sh/Alex7develop/my-agent-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-alex7develop-my-agent-skills-systematic-debugging
- Seller: https://agentstack.voostack.com/s/alex7develop
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.