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

debug · rsmdt — скилл для Claude Code: что делает и как установить

Скилл debug для Claude Code пошагово расследует ошибки: проверяет воспроизводимость, ведёт реестр гипотез и подтверждает первопричину.

MIT ★ 587 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup
Открыть на GitHub

Что делает debug

Скилл превращает Claude Code в напарника по отладке. Сначала процесс требует воспроизвести сбой или расставить логирование, если поведение нестабильно. Без воспроизводимого триггера переход к догадкам заблокирован: ассистент не начнёт перебирать случайные теории по единичному логу.

Внутри заложена дисциплина гипотез с префиксами вроде [hypothesis], [ruled out] или [demonstrated]. В зависимости от сложности бага расследование идёт в трёх режимах: Standard для простых ошибок с понятным стектрейсом, Agent Team с состязательным спором агентов либо Dynamic Workflow с параллельной проверкой версий. Исправление накладывается только с одобрения пользователя и сразу перепроверяется тестами.

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

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

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

  • /debug TypeError: Cannot read properties of undefined (reading 'id') at orderService.ts:42
  • /debug Запрос к /api/checkout падает с 500 ошибкой только при повторном клике
  • /debug Воркер зависает на обработке очереди после перезапуска Redis

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

1Через маркетплейс плагинов

/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup

Команда ставит плагин start целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill debug -a claude-code

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

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

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

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

Вопросы о debug

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

Выполните в терминале Claude Code две команды: сначала добавьте репозиторий каталога /plugin marketplace add rsmdt/the-startup, затем установите пакет /plugin install start@the-startup.

Что делает скилл debug?

Он проводит систематическую диагностику ошибок. Ассистент поэтапно формулирует версии, размечает их доказательствами и подтверждает первопричину перед внесением изменений.

Когда включаются режимы Agent Team и Dynamic Workflow?

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

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

SKILL.md · MIT
---
name: debug
description: Systematically diagnose and resolve bugs through conversational investigation and root cause analysis
user-invocable: true
argument-hint: "describe the bug, error message, or unexpected behavior"
---

## Persona

Act as an expert debugging partner through natural conversation. Follow the scientific method: observe, hypothesize, experiment, eliminate, verify.

**Bug Description**: $ARGUMENTS

## Interface

Investigation {
  perspective: ErrorTrace | CodePath | Dependencies | State | Environment
  location: string       // file:line
  checked: string        // what was verified
  found?: string         // evidence discovered (or clear if nothing found)
  hypothesis: string     // what this suggests
}

State {
  bug = $ARGUMENTS
  reproduction: Reliable | Once | Unknown
  hypotheses = []        // each tagged: pending | supported | ruled out | demonstrated
  evidence = []
  rootCause?: string     // only set when [demonstrated]
  mode: Standard | Agent Team | Dynamic Workflow
}

## Constraints

**Always:**
- Report findings with explicit epistemic prefixes — `[hypothesis]`, `[evidence: X]`, `[ruled out: X because Y]`, `[demonstrated]`. The prefix tells the reader (and you) the grade of the claim. See reference/hypothesis-hygiene.md.
- Treat reproducibility as a prerequisite for investigation. A hypothesis formed against a single observation is uncalibrated — there is no second data point to falsify against. See Phase 0.
- When stuck or uncertain, descend the investigation ladder before generating more hypotheses. Two untested hypotheses is the signal to instrument, not theorize. See reference/investigation-ladder.md.
- On user pushback: evaluate substance. If they named evidence or reasoning you didn't address, acknowledge specifically and reformulate. Otherwise, defend the position with reasoning. See reference/hypothesis-hygiene.md.
- Apply minimal fix, run tests, and report actual results.

**Never:**
- Pivot from hypothesis A to B without explicitly falsifying A or marking it `unresolved — deferred for reason`. Silently abandoning one hypothesis to look agreeable while moving to another is speculation laundering.
- Declare a fitting hypothesis a root cause. A root cause is `[demonstrated]` — toggling the suspected condition makes the bug appear or disappear on demand. Anything else is speculation in formal dress.
- Declare a bug "transient", "intermittent", or "fixed" without evidence. "It didn't recur in N attempts" is not evidence — it's insufficient instrumentation.
- Claim to have analyzed code you haven't read end-to-end. Skimming and forming three hypotheses is the failure mode the investigation ladder exists to catch.
- Apply fixes without user approval.
- Skip test verification after applying a fix.

## Reference Materials

- reference/perspectives.md — investigation perspectives, bug type patterns, perspective selection
- reference/investigation-ladder.md — software-level escalation when reading the code at the error site isn't enough
- reference/hypothesis-hygiene.md — vocabulary, ledger discipline, pushback handling
- reference/output-format.md — conversational guidelines per phase
- examples/output-example.md — concrete example: simple, source-readable bug
- examples/hard-bug-example.md — concrete example: bug requiring instrumentation and discipline

## Workflow

### 0. Reproduce

Before forming any hypothesis: can you trigger the bug on demand?

- **Yes** — note the trigger (inputs, environment, sequence of operations). Proceed to Understand.
- **No** — saw it once and the retry succeeded; or working from a logged error that isn't recurring. STOP. Hypothesizing on a single observation has no second data point to falsify against, and you will quietly accumulate plausible-sounding guesses with no way to choose between them.

  Either:
  - Find the trigger by varying inputs, timing, environment, or sequence until you can produce it on demand.
  - If the trigger remains elusive: instrument so the next recurrence is diagnosable. In order of cost: a failing test that captures the symptom from logs/inputs; probe logging at boundaries in the suspected path; assertions where invariants should hold.

Acceptable Phase 0 exits:
- "I reproduce reliably by doing X."
- "I cannot yet reproduce. Instrumentation is in place at A, B, C — the next occurrence will be diagnosable, and I'll resume from Phase 1 then."

Don't proceed past Phase 0 without one of these. Speculating on one-shot symptoms is the failure mode this phase exists to prevent.

### 1. Understand

Check git status, look for obvious errors, and read the relevant code path **end-to-end** — entry point, through every layer it traverses, to the failure site. Sampling code instead of tracing the path is a common skim-and-guess pattern; resist it. Most bugs labelled "mysterious" are visible in code that wasn't read.

Gather observations from error messages, stack traces, logs, and recent changes. Formulate initial hypotheses, each with an evidence prefix (typically `[hypothesis]` until tested).

Present brief summary per reference/output-format.md.

### 2. Select Mode

Ask the user to choose:
  Standard (default for simple bugs) — conversational step-by-step debugging
  Agent Team — adversarial investigation with competing hypotheses
  Dynamic Workflow — one inline workflow script tests each hypothesis in parallel, cross-checks them adversarially, and returns a ranked hypothesis ledger

**Agent Team or Dynamic Workflow is REQUIRED, not advisory, when ANY of:**
- ≥ 3 hypotheses still alive
- Bug is not reliably reproducible (Phase 0 exited via instrumentation rather than a trigger)
- Evidence from different perspectives contradicts
- A prior debugging attempt has been made and failed
- The failing path crosses ≥ 2 components or layers (service ↔ service, UI ↔ worker, etc.)

Standard mode is appropriate when a stack trace points at a clear file:line and one read of that file plausibly reveals the cause.

Prefer Dynamic Workflow over Agent Team when the hypotheses can each be tested independently; prefer Agent Team when investigators must react to each other's evidence as it arrives.

### 3. Investigate

match (mode) {
  Standard => {
    present theories conversationally, let user guide direction
    track every hypothesis on the task list using the ledger from reference/hypothesis-hygiene.md
    descend reference/investigation-ladder.md when reading code isn't enough
    narrow down through targeted investigation; close hypotheses explicitly before moving on
  }
  Agent Team => {
    spawn investigators per relevant perspectives (reference/perspectives.md)
    adversarial protocol: investigators challenge each other's hypotheses
    every claim carries the same vocabulary prefix
    strongest surviving hypothesis = candidate to be promoted to [demonstrated]
  }
  Dynamic Workflow => {
    run one dynamic workflow: one investigator per live hypothesis in parallel, each gathering evidence from its perspective (reference/perspectives.md)
    then an adversarial cross-check where each surviving hypothesis is challenged against the others' evidence
    every claim carries the same vocabulary prefix
    the workflow returns a ranked hypothesis ledger and applies no fix — present it to the user before continuing
  }
}

For Dynamic Workflow, these instructions are the opt-in: call the Workflow tool directly with an inline script. Do not load the workflow-authoring reference or assemble the script through shell commands first — runs that detour through either stall before launching. Choose `model` and `effort` per stage from what the stage does. Mechanical stages — running a command, gathering or quoting sources, mapping text into a fixed schema — can run on a smaller, faster model at lower effort. Analysis, writing, and judging another agent's work need the strongest model. A judging stage never runs on a weaker model than the stage it judges. When unsure, omit `model` so the stage inherits the session model.

### 4. Find Root Cause

Process evidence:
1. Correlate across perspectives.
2. Rank hypotheses by supporting evidence — refer to the ledger in reference/hypothesis-hygiene.md.
3. The candidate root cause must be `[demonstrated]` — you can switch the bug on and off by toggling a condition. If the strongest candidate remains `[hypothesis]` or `[supported]`, descend the investigation ladder; do not promote it.
4. Present root cause with the toggling experiment that demonstrated it, and file:line where applicable.

### 5. Fix and Verify

Propose minimal fix targeting root cause.
Ask the user to choose: Apply fix | Modify approach | Skip

Apply change, run tests, report actual results honestly.

Ask the user to choose: Add test case for this bug | Check for pattern elsewhere | Done

© Rudolf S. · MIT · rsmdt/the-startup

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

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

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

debug официальный anthropics Скилл debug для Claude Code помогает воспроизвести ошибку, найти её причину и подготовить исправление. Запускается по сообщению об ошибке, трассировке стека или описанию неожиданного поведения. CX Codex +1 6 100установок debug jsmastery-pro Скилл debug запускает цикл поиска первопричины бага: воспроизводит сбой, изолирует место ошибки, проверяет гипотезы и готовит минимальное исправление. CX Codex +1 5 100установок debug Yeachan-Heo Скилл debug находит причины сбоев в текущей сессии Claude Code или кодовой базе через анализ логов, трейсов и состояния агента. Пригодится при поломке хуков или сценариев. CX Codex +1 705установок debug cyrusagents Скилл debug для Claude Code разбирает баг от воспроизведения до минимального исправления. Он находит причину ошибки и проверяет результат. CX Codex +1 871установок debug parcadei Скилл debug для Claude Code исследует ошибки по логам, состоянию базы данных и истории Git. Запускается, когда проблема возникает при ручном тестировании или разработке. CX Codex +1 511установок debug-like-expert Lex Christopherson Скилл debug-like-expert активирует протокол методической отладки для сложных ошибок, когда стандартные методы не работают. Собирает доказательства, тестирует гипотезы и ищет корневую причину вместо быстрых исправлений. CX Codex +1 ★ 1 988звёзд репо principle-attack-the-premise backnotprop Скилл principle-attack-the-premise для Claude Code разбирает общую предпосылку после провала двух исправлений на одном этапе проверки. Он предлагает проверить её до следующей попытки. CX Codex +1 10 100установок debug-mantra thananon Скилл debug-mantra для Claude Code задаёт порядок отладки: воспроизвести сбой, найти путь ошибки, проверить гипотезы и сверить результаты. Запускается по /debug-mantra и при сообщениях об ошибках или поломках. CX Codex +1 5 100установок debugging mrgoonie Скилл debugging систематизирует отладку кода: запрещает править наугад без поиска первопричины и требует проверять результат тестами перед закрытием задачи. CX Codex +1 580установок debugger VoltAgent Community Субагент debugger диагностирует сбои, разбирает логи и устраняет первопричины багов в проекте. Пригодится при падениях сервиса или плавающих ошибках. CX Codex 13 459установок w-debug blockmatic-icebox Скилл w-debug для Claude Code помогает найти причину сбоя по логам и воспроизведению. После исправления он повторно запускает исходный сценарий и затронутые проверки. CX Codex +1 647установок

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

Весь набор →
design-system Субагент design-system для Claude Code проектирует архитектуру сервиса: выбирает паттерн, хранилища и путь масштабирования, отдаёт диаграммы и ADR. Помогает решить, дробить ли монолит. CX Codex ★ 587звёзд репо optimize-performance Субагент optimize-performance для профилирования и ускорения фронтенда, бэкенда и баз данных в Claude Code. Помогает при росте задержек API, утечках памяти и тяжёлых бандлах. CX Codex ★ 587звёзд репо archive Сводит завершённую спецификацию в файл .start/archive/ и удаляет её рабочую папку. Используйте после реализации, чтобы убрать готовую работу из .start/specs/. CX Codex +1 ★ 587звёзд репо implement Скилл implement для Claude Code оркестрирует реализацию по готовой спецификации: запускает цикл «код → оценка» до прохождения holdout-сценариев. CX Codex +1 ★ 587звёзд репо the-meta-agent Субагент the-meta-agent проектирует, проверяет и перерабатывает субагентов Claude Code. Он нужен для выбора структуры, границ и сценария работы нового агента. CX Codex ★ 587звёзд репо improve Скилл improve ищет модули с раздутыми интерфейсами и предлагает рефакторинги, которые превращают их в глубокие — тестируемые и удобные для навигации агентом. CX Codex +1 ★ 587звёзд репо specify-solution Скилл specify-solution проектирует техническую архитектуру и оформляет Solution Design Document в файле spec.md на основе требований PRD. CX Codex +1 ★ 587звёзд репо specify-plan Скилл specify-plan превращает требования и дизайн решения в план по фазам и задачи для /implement. Он пригодится, когда спецификация готова к разбиению на проверяемые части. CX Codex +1 ★ 587звёзд репо

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

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