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

debug-loop — скилл для Claude Code: гипотезы вместо угадайки

Скилл debug-loop для пошагового отладки багов с реальными командами, не симуляциями. Формулирует гипотезы, проверяет их на живых данных, ищет корень проблемы и только потом правит код.

MIT 117 установок ★ 533 обновлён 2026-10-25

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

Что делает debug-loop

debug-loop работает в пять фаз. Сначала воспроизводит баг — запускает команду, которая его показывает. Потом выдвигает гипотезу о причине и проверяет её реальной командой: например, смотрит таблицы в SQLite или версии зависимостей. Каждый результат либо подтверждает гипотезу, либо подсказывает следующую. Только когда корень найден, скилл меняет код — минимально, целенаправленно.

После правки скилл запускает ту же команду, что в фазе один, и проверяет, что результат изменился. Потом гонит весь набор тестов (npm test), чтобы не сломать остальное. Если тесты падают, он их чинит перед коммитом.

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

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

  • найти корень ошибки в падающих тестах
  • отследить логику когда результат не совпадает с ожидаемым
  • понять, откуда берётся неправильное значение в переменной или БД
  • убедиться, что правка не сломала другой код
  • отделить настоящую проблему от симптома

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

  • Отладь падающий тест npm test -- users.test.js, вывод показывает неправильное число записей
  • Бэкенд возвращает 404 вместо данных, хотя endpoint правильный — найди причину
  • Скрипт миграции БД молчит и ничего не делает — разберись, где зависает

Как установить debug-loop

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a claude-code

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

~/.claude/skills/debug-loop/SKILL.md

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

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

Вопросы о debug-loop

Как установить debug-loop в Claude Code?

Запусти npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a claude-code, потом открой файл ~/.claude/skills/debug-loop/SKILL.md. Для других редакторов команда отличается: для Cursor — npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a cursor, для GitHub Copilot — gh skill install proffesor-for-testing/agentic-qe debug-loop.

Что делает debug-loop?

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

Что происходит, если скилл не может воспроизвести баг за пять попыток?

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

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

SKILL.md · MIT
---
name: debug-loop
description: "Use when debugging a failing test or runtime error with hypothesis-driven investigation, autonomous command validation, and systematic root cause elimination."
trust_tier: 0
domain: debugging
---

# Debug Loop

Autonomous hypothesis-driven debugging against real data. No guessing, no simulating.

## Arguments

- `<symptom>` — Description of the bug or unexpected behavior. If omitted, prompt the user.

## Phases

### Phase 1 — Reproduce
Run the exact command that shows the bug. Capture and display the REAL output. Confirm the bug is visible.

If the bug cannot be reproduced, stop and explain what was tried.

### Phase 2 — Hypothesize and Test (up to 5 iterations)
For each iteration:
1. State a specific hypothesis (e.g., "the query targets v2 tables but data is in v3 tables")
2. Run a REAL command to test it (e.g., `sqlite3 [db path] '.tables'` then `SELECT COUNT(*) FROM [table]`)
3. Record whether the hypothesis was confirmed or rejected
4. If rejected, form the next hypothesis based on what you learned

**Do NOT make code changes until you have a confirmed root cause.**

Important checks:
- Always check both v2 and v3 SQLite tables when data issues are suspected
- Check dependency versions (e.g., sqlite3 vs better-sqlite3)
- Check for hardcoded values that may have been missed

### Phase 3 — Fix
Make the minimal targeted fix. Explain:
- What the root cause was
- What you're changing and why
- What the blast radius is (which other code paths are affected)

Before applying, grep for ALL instances of the problematic pattern across the entire codebase.

### Phase 4 — Verify
Run the SAME reproduction command from Phase 1. The output must now show correct values. If it doesn't, go back to Phase 2.

Show before/after output comparison.

### Phase 5 — Regression
```bash
npm test
```
Run the full test suite. If tests fail, fix them before committing.

## Rules

- NEVER guess or simulate output — always run real commands
- NEVER make code changes before confirming root cause
- Always check for the pattern across the entire codebase, not just one file
- If blocked after 5 hypotheses, stop and ask the user for guidance

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

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

Все скиллы по теме «Код-ревью и рефакторинг» →
bug-fix bobmatnyc Скилл bug-fix задаёт системный процесс устранения багов: от воспроизведения и поиска первопричины до проверки исправления и написания регрессионных тестов. CX Codex +1 488установок fix-issue OrchestKit Скилл fix-issue разбирает GitHub issue, ищет корневую причину, вносит исправление с тестами и создаёт PR со ссылкой на issue. CX Codex +1 217установок thinking-scientific-method tjboudreaux Скилл thinking-scientific-method задаёт протокол научной отладки: агент формулирует проверяемые гипотезы сбоя и отсекает ложные самыми дешёвыми проверками. CX Codex +1 681установок debug-mantra thananon Скилл debug-mantra для Claude Code задаёт порядок отладки: воспроизвести сбой, найти путь ошибки, проверить гипотезы и сверить результаты. Запускается по /debug-mantra и при сообщениях об ошибках или поломках. CX Codex +1 5 100установок debug-my-harness zernie Скилл debug-my-harness для Claude Code. Разбирает сбои в агентной обвязке по локальному журналу .vigiles/runs.jsonl: показывает, какие хуки заблокировали или пропустили действие, где субагент вышел за пределы контракта. CX Codex +1 1 500установок debug cyrusagents Скилл debug для Claude Code разбирает баг от воспроизведения до минимального исправления. Он находит причину ошибки и проверяет результат. CX Codex +1 871установок

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

Весь набор →
test-data-management Скилл test-data-management для Claude Code генерирует тестовые данные, обезличивает PII и изолирует записи между тестами. Применяется в unit-, integration- и performance-тестах. CX Codex +1 118установок iterative-loop Скилл iterative-loop запускает циклы разработки «сборка-тест-исправление» до выполнения критериев готовности. Помогает доводить фичи по TDD и устранять баги без ручного контроля каждого шага. CX Codex +1 118установок shift-left-testing Скилл shift-left-testing для Claude Code переносит проверки на ранние этапы разработки: валидирует требования, помогает писать тесты до кода и запускать их в CI. Описывает ранний контроль качества и TDD. CX Codex +1 117установок test-environment-management Скилл test-environment-management для Claude Code помогает настраивать тестовую инфраструктуру и сближать её с production. Он включается при подготовке окружений, поиске различий между средами и сокращении расходов на тесты. CX Codex +1 117установок shift-right-testing Скилл shift-right-testing направляет агента при тестировании в продакшене через фиче-флаги, канареечные релизы и хаос-тесты. Пригодится при настройке прогрессивной доставки и SLO. CX Codex +1 115установок qe-contract-testing Скилл qe-contract-testing для проверки контрактов REST, GraphQL и event-driven API с валидацией схем. Ловит несовместимые изменения и гарантирует, что API не сломает клиентов. CX Codex +1 115установок security-visual-testing Скилл security-visual-testing проверяет вёрстку веб-страниц с контролем утечек данных, параллельным сравнением экранов и аудитом доступности WCAG. CX Codex +1 115установок enterprise-integration-testing Скилл enterprise-integration-testing для сквозного тестирования интеграций между SAP, WMS и шинами данных. Помогает проверять сценарии Order-to-Cash и выверять синхронизацию систем. CX Codex +1 113установок

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

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