systematic-debugging · sammcj — скилл для Claude Code: отладка и установка
Скилл systematic-debugging для Claude Code пошагово разбирает стойкие баги по изменённой методике Fagan Inspection. Выявляет первопричину после нескольких неудачных попыток исправления.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill systematic-debugging -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/systematic-debugging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/systematic-debugging/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill systematic-debugging -a codex2Вручную: положить файлы
.agents/skills/systematic-debugging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill systematic-debugging -a cursor2Вручную: положить файлы
.cursor/skills/systematic-debugging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills/systematic-debugging/SKILL.md2Вручную: положить файлы
.github/skills/systematic-debugging/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill systematic-debugging -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/systematic-debuggingВручную: положить файлы
.devin/skills/systematic-debugging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.