debug-loop — скилл для Claude Code: гипотезы вместо угадайки
Скилл debug-loop для пошагового отладки багов с реальными командами, не симуляциями. Формулирует гипотезы, проверяет их на живых данных, ищет корень проблемы и только потом правит код.
MIT 117 установок ★ 533 обновлён 2026-10-25
npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/debug-loop/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/debug-loop/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a codex2Вручную: положить файлы
.agents/skills/debug-loop/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a cursor2Вручную: положить файлы
.cursor/skills/debug-loop/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install proffesor-for-testing/agentic-qe assets/skills/debug-loop2Вручную: положить файлы
.github/skills/debug-loop/SKILL.md1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a gemini-cli2Командой платформы
gemini skills install https://github.com/proffesor-for-testing/agentic-qe --path assets/skills/debug-loopВручную: положить файлы
.devin/skills/debug-loop/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill debug-loop -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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