К основному содержанию
скилл CX Codex

systematic-debugging · vstorm-co — скилл для Claude Code: отладка по шагам

Скилл systematic-debugging для Claude Code ведёт агента по пяти шагам: от воспроизведения ошибки до проверки исправления. Помогает разбирать ошибки без правок наугад.

MIT ★ 1 125 обновлён 2026-10-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add vstorm-co/pydantic-deepagents --skill systematic-debugging -a claude-code
Открыть на GitHub

Что делает systematic-debugging

Скилл задаёт жёсткий цикл: воспроизвести ошибку, изолировать минимальный вход, поставить диагноз, починить, проверить. Перескакивать нельзя, и угадывать наугад тоже — так написано в самом файле.

Внутри рабочая мелочёвка, которая обычно и решает, сколько живёт баг. Какую строку читать в стектрейсе (для сегфолта смотрят на последнюю функцию, для Python на самый внутренний кадр). Какие отладочные вставки добавлять в C и в Python и что потом их надо убрать. Короткий список частых причин: выход за границы массива на единицу, несовпадение знаковых и беззнаковых типов, UTF-8 приняли за байты, относительный путь сломался при смене рабочей папки.

Три неудачных попытки с одним подходом означают, что неверен подход, а не детали. Скилл велит бросить его и зайти с другой стороны. Сам он ничего не запускает: SKILL.md — это текст, который держит агента в рамках, когда тот начинает метаться.

Какие задачи решает

  • Найти минимальный вход, на котором воспроизводится падение
  • Прочитать стектрейс и понять, с какого кадра начинать
  • Отличить первую ошибку компиляции от каскада следующих
  • Разобраться, почему код считает верно на малых данных и висит на больших
  • Объяснить падение теста, которого нет при локальном прогоне

Примеры запросов агенту

  • Разберись, почему падает pytest tests/test_parse.py, и иди по шагам из systematic-debugging.
  • Не угадывай: сначала воспроизведи ошибку и покажи полный вывод с кодом возврата.
  • Третья попытка не помогла — смени подход, как велит systematic-debugging.

Как установить systematic-debugging

1Через Skills CLI (Vercel)

npx skills add vstorm-co/pydantic-deepagents --skill systematic-debugging -a claude-code

2Вручную: положить файлы

~/.claude/skills/systematic-debugging/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/systematic-debugging/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о systematic-debugging

Как установить systematic-debugging в Claude Code?

Выполните npx skills add vstorm-co/pydantic-deepagents --skill systematic-debugging -a claude-code. Файл скилла появится по пути ~/.claude/skills/systematic-debugging/SKILL.md.

Что делает systematic-debugging?

Ведёт агента по циклу из пяти шагов: воспроизведение, изоляция, диагностика, исправление, проверка. На каждом шаге сказано, что смотреть и какие отладочные вставки добавлять.

Что делать, если исправление не сработало несколько раз?

После трёх неудачных попыток с одним подходом скилл требует бросить его и выбрать другую стратегию вместо перебора вариантов.

Исходный текст

SKILL.md · MIT
---
name: systematic-debugging
description: "Systematic approach to diagnosing and fixing errors"
tags: [debugging, errors, benchmark]
version: "1.0.0"
---

# Systematic Debugging

A structured approach to finding and fixing bugs.

## The Debugging Loop

```
1. REPRODUCE → 2. ISOLATE → 3. DIAGNOSE → 4. FIX → 5. VERIFY
```

Never skip steps. Never guess-and-check repeatedly.

## Step 1: Reproduce

- Run the exact command that fails
- Capture FULL output (stdout AND stderr)
- Note: exit code, error message, stack trace
- If intermittent, identify what changes between runs

## Step 2: Isolate

- What's the MINIMAL input that triggers the error?
- Which specific line/function fails? (read the traceback bottom-up)
- Is it a compile error, runtime error, or wrong output?
- Does it fail on all inputs or specific ones?

## Step 3: Diagnose

### Read the error message carefully

| Error type | Where to look |
|-----------|---------------|
| Compile error | The FIRST error (later ones are often cascading) |
| Segfault | Last function in the stack trace, check array bounds and null pointers |
| Python traceback | The innermost frame (bottom), but also check the middle for context |
| Wrong output | Diff expected vs actual: `diff <(expected) <(actual)` |
| Timeout/hang | Is it an infinite loop? Deadlock? I/O bound? Add a timer or counter |

### Add minimal instrumentation

- C: `fprintf(stderr, "reached checkpoint %d\n", __LINE__);`
- Python: `print(f"DEBUG: {var=}", file=sys.stderr)`
- Check intermediate values, not just final output
- Remove debug prints after fixing

## Step 4: Fix

- Change ONE thing at a time
- If the same approach fails 3 times → completely different strategy
- Don't add workarounds — fix the root cause
- Common root causes:
  - Off-by-one errors (loop bounds, array indexing)
  - Type mismatches (int vs float, signed vs unsigned)
  - Encoding issues (UTF-8 vs bytes)
  - Path errors (relative vs absolute, missing trailing slash)
  - Race conditions (file not written yet, process not started)

## Step 5: Verify

- Run the same command that failed before
- Test with multiple inputs, not just the one that was failing
- Check edge cases: empty input, single element, very large input
- Run any existing test suite

## Common Failure Patterns

### "It compiles but gives wrong output"
1. Print all intermediate values
2. Compare with a known-correct reference implementation
3. Check: integer overflow, floating point precision, endianness

### "It works on small input but times out on large"
1. Check algorithm complexity — O(n²) on 1M items = timeout
2. Profile: which loop/function takes the most time?
3. Restructure: hash maps, sorting, streaming

### "It works locally but fails in the test"
1. Check: absolute vs relative paths
2. Check: different working directory
3. Check: different input format than expected
4. Read the test script to understand what it actually checks

© vstorm-co · MIT · vstorm-co/pydantic-deepagents

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — systematic-debugging от других авторов.

systematic-debugging Jesse Vincent Скилл systematic-debugging для Claude Code и Codex блокирует фиксы до завершения анализа первопричины. Включается при падении тестов, баге или неожиданном поведении. CX Codex +1 306 118установок systematic-debugging spencerpauly Скилл systematic-debugging для Claude Code и других агентов: заставляет искать причину бага по шагам вместо случайных правок. Держит под контролем баги, которые проявляются только в продакшене. CX Codex +1 604установок systematic-debugging bobmatnyc Скилл systematic-debugging для Claude Code ведёт агента от воспроизведения ошибки до проверки исправления. Выявляет причину сбоя или неожиданного поведения. CX Codex +1 400установок systematic-debugging ChrisWiles Скилл systematic-debugging задаёт четырёхэтапный протокол отладки с упором на первопричину бага. Скилл пригодится при расследовании падений тестов или внезапных сбоев рантайма без поверхностных правок. CX Codex +1 ★ 6 091звёзд репо systematic-debugging GanyuanRan Скилл systematic-debugging помогает разбирать ошибки, сбои тестов и неожиданное поведение до правок. Он прослеживает причину до места, которое действительно нужно исправить. CX Codex +1 ★ 1 450звёзд репо debugging-toolkit-debugger Seth Hobson Субагент debugging-toolkit-debugger разбирает ошибки, падения тестов и неожиданное поведение: ищет первопричину, предлагает небольшой фикс и проверяет результат. CX Codex ★ 42 780звёзд репо gaia-debugging ruvnet Скилл gaia-debugging разбирает, почему задача из бенчмарка GAIA провалилась: достаёт трейс, классифицирует ошибку и предлагает исправление. Запускается, когда gaia-bench run вернул failed или неверный ответ для task_id. CX Codex +1 436установок n8n-debugging-official n8n-io Скилл n8n-debugging-official для Claude Code разбирает сбои в сценариях n8n, находит причины ошибок выполнения и восстанавливает корректный поток данных через инспекцию графа, анализ ошибок и валидацию конфигурации узлов. CX Codex +1 2 600установок debugging-mwaa-workflow aws Скилл debugging-mwaa-workflow находит причину падения воркфлоу в Amazon MWAA (Provisioned и Serverless). Читает логи CloudWatch, вызывает REST API через aws mwaa invoke-rest-api, собирает контекст и даёт команды для починки. CX Codex +1 1 700установок debug-systematic travisjneuman Скилл debug-systematic для Claude Code ведёт агента через четыре фазы отладки: воспроизведение, локализацию, поиск причины и проверку исправления. Разбирает сложные и плавающие ошибки. CX Codex +1 152установок laravel-systematic-debugging iSerter Скилл laravel-systematic-debugging для Claude Code помогает найти причину ошибки Laravel до предложения исправления. Разбирает сбои тестов, проблемы с Eloquent и неожиданное поведение приложения. CX Codex +1 110установок

Из того же набора14

Весь набор →
environment-discovery Скилл учит агента систематически исследовать незнакомое окружение перед тем, как начинать работу. Проверяет структуру файлов, форматы данных, установленные инструменты и существующий код — это экономит время на отладку. CX Codex +1 ★ 1 125звёзд репо report-writing Скилл report-writing задаёт правила оформления аналитических отчётов: структуру разделов, вводное резюме и сквозные ссылки на источники. CX Codex +1 ★ 1 125звёзд репо build-and-compile Скилл build-and-compile для Claude Code определяет способ сборки по файлам проекта и помогает разбирать ошибки компиляции и зависимостей. Разбирает случаи, когда проект не собирается или инструкции неясны. CX Codex +1 ★ 1 125звёзд репо research-methodology Скилл research-methodology с методикой для организованного исследования: от поиска и оценки источников до структурированных заметок с указанием надёжности данных. CX Codex +1 ★ 1 125звёзд репо performant-code Скилл performant-code для Claude Code задаёт правила оптимизации кода для больших файлов и жёстких лимитов памяти, помогая избежать таймаутов при обработке гигабайтов. CX Codex +1 ★ 1 125звёзд репо data-formats Скилл data-formats для Claude Code исследует неизвестные файлы и выбирает способ их разбора. Определяет подход к чтению, даже если тип и структура данных заранее неясны. CX Codex +1 ★ 1 125звёзд репо verification-strategy Скилл verification-strategy задаёт для Claude Code протокол проверки выполненной работы: сверку путей, кодов возврата, форматов вывода и граничных случаев перед отчётом о готовности. CX Codex +1 ★ 1 125звёзд репо diagram-design Скилл diagram-design для Claude Code создаёт исследовательские схемы на холсте Excalidraw через MCP: сравнения, процессы, архитектуры и хронологии. CX Codex +1 ★ 1 125звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой