Systematic Debugging
Находить корневую причину бага системно — через сужение области, а не через угадывание и случайные правки. Используй при сообщениях "не работает", "падает с ошибкой", "неожиданное поведение", "баг", когда причина неочевидна из первого взгляда на стектрейс. Особенно важно применять вместо того, чтобы менять код наугад и смотреть, помогло ли.
Install
$ agentstack add skill-alex7develop-my-agent-skills-systematic-debugging ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Links to your public security report.[](https://agentstack.voostack.com/security/report/skill-alex7develop-my-agent-skills-systematic-debugging) Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Systematic Debugging
Главная ловушка при отладке — начать менять код до того, как понята причина. Это либо случайно "лечит" симптом, оставляя причину, либо создаёт новый баг.
Процесс
- Воспроизвести надёжно. Если баг не воспроизводится стабильно —
сначала добиться стабильного воспроизведения (минимальный набор шагов/ входных данных), иначе непонятно, исчез баг или просто не проявился.
- Сформулировать гипотезу явно. Одно предложение: "я думаю, причина —
X, потому что Y". Не переходить к правке кода без этого шага.
- Проверить гипотезу минимальным способом — логом, брейкпоинтом,
изолирующим тестом. Не чинить, пока гипотеза не подтверждена.
- Сузить область бинарным поиском, если причина не очевидна:
отключать/изолировать половину системы за раз, а не проверять компоненты по одному в случайном порядке.
- Найти корневую причину, не только точку симптома. "Здесь падает
NullPointerException" — это симптом. "Функция X не гарантирует инициализацию перед вызовом Y при условии Z" — это причина.
- Написать тест, который воспроизводит баг, прежде чем чинить (см.
навык test-driven-development) — это доказательство, что причина понята верно, и защита от регрессии.
- Исправить причину, не симптом. Если фикс — это просто добавленная
проверка 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
- Source: 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.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.