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

systematic-debugging · sammcj — скилл для Claude Code: отладка и установка

Скилл systematic-debugging для Claude Code пошагово разбирает стойкие баги по изменённой методике Fagan Inspection. Выявляет первопричину после нескольких неудачных попыток исправления.

Apache-2.0 ★ 173 обновлён 2026-10-24

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

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

systematic-debugging разбивает разбор на четыре последовательные фазы. Сначала агент формулирует проблему, ожидаемое и фактическое поведение, симптомы и историю прошлых исправлений. Затем читает код построчно, отмечает дефекты в логике, граничных условиях, обработке ошибок, потоке данных и интеграциях, но пока ничего не исправляет.

После инспекции скилл ищет первопричину через технику «пяти почему», проверяет влияние окружения, зависимостей, таймингов и скрытых допущений. На последнем этапе он предлагает исправления, объясняет их связь с причиной, учитывает побочные эффекты и составляет план проверки: тесты, ручные шаги, логи и крайние случаи. Для критической оценки решений используется субагент, а сам разбор опирается на чтение файлов, поиск по коду, тесты и логи.

Для простых очевидных багов этот скилл не подходит: он рассчитан на существующие проблемы после нескольких неудачных попыток, а не на новые функции или явно инфраструктурные сбои.

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

  • найти первопричину бага после нескольких неудачных исправлений
  • разобрать код построчно и классифицировать дефекты
  • сопоставить симптомы с ошибками в потоке данных или интеграциях
  • проверить гипотезу через цепочку «пяти почему»
  • составить план исправления и верификации

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

  • Разбери этот стойкий баг по четырём фазам systematic-debugging и сначала не меняй код.
  • Проведи построчную инспекцию модуля src/api/client.ts, найди дефекты и укажи их категории.
  • После анализа предложи исправления, побочные эффекты и тесты для проверки первопричины.

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

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --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 sammcj/agentic-coding --skill systematic-debugging -a claude-code, затем используйте файл ~/.claude/skills/systematic-debugging/SKILL.md.

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

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

Когда systematic-debugging использовать не стоит?

Он не предназначен для простых очевидных багов, новых функций и явно инфраструктурных проблем, которым не требуется инспекция кода.

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

SKILL.md · Apache-2.0
---
name: systematic-debugging
description: Applies a modified Fagan Inspection methodology to resolve persistent bugs and complex issues. Use when several fix or debugging attempts have already failed and a methodical root-cause analysis warranting a Fagan inspection is needed. Do not use for simple troubleshooting.
---

# Systematic Debugging with Fagan Inspection

This skill applies a modified Fagan Inspection methodology for systematic problem resolution when facing complex problems or stubborn bugs that have resisted multiple fix attempts.

## Process Overview

Create tasks for each of the four phases, then work them to completion, marking each done before starting the next.

Follow these four phases sequentially. Do not skip phases or attempt fixes before completing the inspection.

### Phase 1: Initial Overview

Establish a clear understanding of the problem before analysis:

- **Explain the problem** in plain language without technical jargon
- **State expected behaviour** - what should happen
- **State actual behaviour** - what is happening instead
- **Document symptoms** - error messages, logs, observable failures
- **Context** - when does it occur, how often, under what conditions
- **Prior fix attempts** - list each attempt, what it changed, and why it failed; treat these as eliminated hypotheses that Phase 3 must account for

**Output:** A clear problem statement that anyone could understand.

### Phase 2: Systematic Inspection

Perform a line-by-line walkthrough as the "Reader" role in Fagan Inspection. **Identify defects without attempting to fix them yet** - this is pure inspection.

Check against these defect categories:

1. **Logic Errors**
2. **Boundary Conditions**
3. **Error Handling**
4. **Data Flow Issues**
5. **Integration Points**

Talk through the code step by step, as the Reader does in a Fagan inspection. For each section of code:
- State what the code is intended to do
- Identify any discrepancies between intent and implementation
- Flag assumptions or unclear aspects
- Use ultrathink to think deeper on complex sections

**Output:** A categorised list of identified defects with line numbers and specific descriptions.

### Phase 3: Root Cause Analysis

After identifying issues, trace back to find the fundamental cause - not just symptoms.

**Five Whys Technique:**
- Ask "why" repeatedly (at least 3-5 times) to get to the underlying issue
- State each "why" explicitly in your analysis
- Example:
  - Why did the API call fail? → Because the request was malformed
  - Why was it malformed? → Because the data wasn't serialised correctly
  - Why wasn't it serialised? → Because the serialiser expected a different type
  - Why did it expect a different type? → Because the schema was updated but code wasn't
  - Root cause: Schema versioning mismatch between services

**Consider:**
- Environmental factors (configuration, dependencies, runtime environment)
- Timing and concurrency (race conditions, async issues)
- Hidden assumptions in the code or system design
- Historical context (recent changes, migrations, updates)

**State assumptions explicitly:**
- "I'm assuming X because..."
- "This presumes that Y is always..."
- Flag any assumptions that need verification

**Output:** A clear statement of the root cause, the chain of reasoning that led to it, and any assumptions that need validation.

### Phase 4: Solution & Verification

Now propose specific fixes for each identified issue.

**For each proposed solution:**
1. **Describe the fix** - what code/configuration changes are needed
2. **Explain why it resolves the root cause** - connect it back to Phase 3 analysis
3. **Consider side effects** - what else might this change affect
4. **Define verification steps** - how to confirm the fix works

**Verification Planning:**
- Specific test cases that would have caught this bug
- Manual verification steps
- Monitoring or logging to add
- Edge cases to validate

**Use a sub-agent** as a sounding board to provide critical feedback on your proposed solutions and verification plan.

**Output:** A summary of findings (key defects and root cause), a prioritised list of proposed fixes with rationale, and a verification plan for confirming the fixes work.

## Important Guidelines

- **Complete each phase thoroughly** before moving to the next
- **Flag unclear aspects** rather than guessing - if something is uncertain, say so
- **Use available tools** - read files, search code, run tests, check logs
- **Focus on systematic analysis** over quick fixes
- **Validate flagged aspects** - after completing all phases, revisit any unclear points and verify them with tools

## Final Output

After completing all four phases, unless the user indicates otherwise, proceed to implement the proposed solutions.

## When This Skill Should NOT Be Used

- For simple, obvious bugs with clear fixes
- When the first debugging attempt is still underway
- For new features (this is for debugging existing code)
- When the problem is clearly environmental (config, infrastructure) and doesn't require code inspection

© sammcj · Apache-2.0 · sammcj/agentic-coding

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

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — 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 siviter-xyz Скилл debugging для Claude Code пошагово ищет первопричину сбоев и ошибок в коде. Помогает локализовать баг и подготовить минимальное исправление. CX Codex +1 151установок debug cyrusagents Скилл debug для Claude Code разбирает баг от воспроизведения до минимального исправления. Он находит причину ошибки и проверяет результат. CX Codex +1 871установок debug-systematic travisjneuman Скилл debug-systematic для Claude Code ведёт агента через четыре фазы отладки: воспроизведение, локализацию, поиск причины и проверку исправления. Разбирает сложные и плавающие ошибки. CX Codex +1 152установок debugging-and-error-recovery addyosmani Скилл debugging-and-error-recovery для Claude Code помогает найти первопричину сбоя и проверить исправление. Он включается при падении тестов, ошибках сборки и неожиданном поведении кода. CX Codex +1 79 600установок debugging-toolkit-debugger Seth Hobson Субагент debugging-toolkit-debugger разбирает ошибки, падения тестов и неожиданное поведение: ищет первопричину, предлагает небольшой фикс и проверяет результат. CX Codex ★ 42 780звёзд репо Debug Mode Instructions официальный github Субагент Debug Mode Instructions для GitHub Copilot ведёт отладку по фазам: воспроизвести баг, найти причину, починить и проверить. Берётся за ошибки, которые плавают и не имеют очевидной точки входа. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
liteparse Скилл liteparse извлекает текст и структуру из PDF, DOCX, PPTX, XLSX и картинок в markdown локально, без облаков и LLM. CX Codex +1 ★ 173звёзд репо analyse-design Скилл analyse-design для Claude Code анализирует код и скриншоты приложения, сайта или документа и описывает дизайн-систему. Помогает провести аудит интерфейса и создать согласованные компоненты. CX Codex +1 ★ 173звёзд репо invokeai-image-gen Скилл invokeai-image-gen для генерации изображений через локальный API InvokeAI с поддержкой FLUX.2 Klein, Z-Image Turbo и SDXL. Автоматически подбирает параметры под модель, сохраняет результат в файл. CX Codex +1 ★ 173звёзд репо qa-to-issues Скилл qa-to-issues превращает баг-репорты в готовые задачи на GitHub через диалог. Скилл опрашивает вас, изучает репозиторий и сам публикует тикеты без лишних деталей реализации. CX Codex +1 ★ 173звёзд репо personal-genomics Скилл personal-genomics разбирает сырые файлы ДНК локально: фармакогеномика, риски болезней, носительство, происхождение и признаки. Генетические данные не покидают машину. CX Codex +1 ★ 173звёзд репо markedit-tools Скилл markedit-tools помогает обновлять macOS-редактор MarkEdit, подключать расширения и менять настройки программы через Claude Code. CX Codex +1 ★ 173звёзд репо raspberry-pi-pico2 Помогает настраивать сборку и отладку Raspberry Pi Pico 2 и Pi Debug Probe. Охватывает RP2350, SDK, OpenOCD и GDB. CX Codex +1 ★ 173звёзд репо prompt-enhancer Скилл prompt-enhancer для Claude Code превращает неточные промпты в запросы, составленные по образцу экспертной коммуникации. Улучшает собственные запросы и переписывает их для другой ИИ-системы. CX Codex +1 ★ 173звёзд репо

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

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