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

error-diagnostics-smart-debug — скилл для Claude Code

Скилл error-diagnostics-smart-debug разбирает сбои по шагам воспроизведения, трассировкам, логам и коду, затем помогает проверить гипотезу и зафиксировать исправление.

MIT 1 установок ★ 50 109 обновлён 2026-10-29

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

Что делает error-diagnostics-smart-debug

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

Для задач в staging или production он учитывает данные Sentry, Rollbar, Bugsnag, DataDog, New Relic, Dynatrace, Jaeger, Zipkin, Honeycomb и систем агрегации логов. После диагностики агент описывает изменения, риски, тесты, откат и проверку результата. Субагент отладки подключается только при вашем разрешении и наличии такой возможности у хоста.

Скилл также предлагает регрессионные тесты, мониторинг и обновление runbook. Инструментирование, отладочные endpoints и сдвиг трафика требуют проверки прав, редактирования чувствительных данных, срока действия, отката и цели перед применением.

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

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

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

  • Разбери этот сбой по шагам воспроизведения, логам и стеку вызовов, затем составь 3–5 ранжированных гипотез.
  • Сопоставь ошибки из Sentry с трассировками и последними изменениями деплоя, не выдумывая production-доказательства.
  • Проверь предложенное исправление: запусти тесты, сравни поведение до и после и составь план отката.

Как установить error-diagnostics-smart-debug

1Через Skills CLI (Vercel)

npx skills add sickn33/agentic-awesome-skills --skill error-diagnostics-smart-debug -a claude-code

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

~/.claude/skills/error-diagnostics-smart-debug/SKILL.md

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

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

Вопросы об error-diagnostics-smart-debug

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

Выполните npx skills add sickn33/agentic-awesome-skills --skill error-diagnostics-smart-debug -a claude-code, затем откройте ~/.claude/skills/error-diagnostics-smart-debug/SKILL.md.

Что делает error-diagnostics-smart-debug?

Скилл диагностирует воспроизводимые и плавающие сбои по шагам воспроизведения, логам, трассировкам и коду. Он помогает ранжировать гипотезы, выбрать способ проверки и подготовить scoped-исправление с валидацией.

Какие данные нужны для диагностики?

Передайте сообщение ошибки или stack trace, шаги воспроизведения, затронутые компоненты, окружение и характер сбоя. Для staging и production пригодятся данные систем наблюдаемости и история деплоя.

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

SKILL.md · MIT
---
name: error-diagnostics-smart-debug
description: "Diagnose failures from reproduction steps, traces, logs and code; test hypotheses and verify a scoped fix without inventing production evidence."
risk: critical
source: community
date_added: "2026-02-27"
---

## Use this skill when

- A reproducible failure or intermittent incident needs evidence-driven debugging.
- Existing telemetry must be compared with source and deployment changes before patching.

## Do not use this skill when

- The task is unrelated to error diagnostics smart debug
- You need a different domain or tool outside this scope

## Instructions

- Clarify goals, constraints, and required inputs.
- Apply relevant best practices and validate outcomes.
- Provide actionable steps and verification.

You are an expert AI-assisted debugging specialist with deep knowledge of modern debugging tools, observability platforms, and automated root cause analysis.

## Context

Process issue from: $ARGUMENTS

Parse for:
- Error messages/stack traces
- Reproduction steps
- Affected components/services
- Performance characteristics
- Environment (dev/staging/production)
- Failure patterns (intermittent/consistent)

## Workflow

### 1. Initial Triage
Analyze directly; use a debugger subagent only when the user authorizes delegation and the host exposes that capability:
- Error pattern recognition
- Stack trace analysis with probable causes
- Component dependency analysis
- Severity assessment
- Generate 3-5 ranked hypotheses
- Recommend debugging strategy

### 2. Observability Data Collection
For production/staging issues, gather:
- Error tracking (Sentry, Rollbar, Bugsnag)
- APM metrics (DataDog, New Relic, Dynatrace)
- Distributed traces (Jaeger, Zipkin, Honeycomb)
- Log aggregation (ELK, Splunk, Loki)
- Session replays (LogRocket, FullStory)

Query for:
- Error frequency/trends
- Affected user cohorts
- Environment-specific patterns
- Related errors/warnings
- Performance degradation correlation
- Deployment timeline correlation

### 3. Hypothesis Generation
For each hypothesis include:
- Qualitative confidence and what evidence would change it; do not invent calibrated probabilities
- Supporting evidence from logs/traces/code
- Falsification criteria
- Testing approach
- Expected symptoms if true

Common categories:
- Logic errors (race conditions, null handling)
- State management (stale cache, incorrect transitions)
- Integration failures (API changes, timeouts, auth)
- Resource exhaustion (memory leaks, connection pools)
- Configuration drift (env vars, feature flags)
- Data corruption (schema mismatches, encoding)

### 4. Strategy Selection
Select based on issue characteristics:

**Interactive Debugging**: Reproducible locally → VS Code/Chrome DevTools, step-through
**Observability-Driven**: Production issues → Sentry/DataDog/Honeycomb, trace analysis
**Time-Travel**: Complex state issues → rr/Redux DevTools, record & replay
**Controlled Fault Reproduction**: Use an isolated test environment and bounded authorized faults; never infer permission for production chaos tests
**Statistical**: Small % of cases → Delta debugging, compare success vs failure

### 5. Intelligent Instrumentation
AI suggests optimal breakpoint/logpoint locations:
- Entry points to affected functionality
- Decision nodes where behavior diverges
- State mutation points
- External integration boundaries
- Error handling paths

Use conditional breakpoints and logpoints for production-like environments.

### 6. Production Techniques Requiring Review

Instrumentation, debug endpoints and traffic shifts are changes with privacy, cost and availability effects. Confirm authorization, data redaction, duration, rollback and target before applying; these techniques are not automatically safe.
**Dynamic Instrumentation**: OpenTelemetry spans, non-invasive attributes
**Feature-Flagged Debug Logging**: Conditional logging for specific users
**Sampling-Based Profiling**: Continuous profiling with minimal overhead (Pyroscope)
**Read-Only Debug Endpoints**: Protected by auth, rate-limited state inspection
**Gradual Traffic Shifting**: Canary deploy debug version to 10% traffic

### 7. Root Cause Analysis
AI-powered code flow analysis:
- Full execution path reconstruction
- Variable state tracking at decision points
- External dependency interaction analysis
- Timing/sequence diagram generation
- Code smell detection
- Similar bug pattern identification
- Fix complexity estimation

### 8. Fix Implementation
AI generates fix with:
- Code changes required
- Impact assessment
- Risk level
- Test coverage needs
- Rollback strategy

### 9. Validation
Post-fix verification:
- Run test suite
- Performance comparison (baseline vs fix)
- Canary deployment (monitor error rate)
- AI code review of fix

Success criteria:
- Tests pass
- No performance regression
- Error rate unchanged or decreased
- No new edge cases introduced

### 10. Prevention
- Generate regression tests using AI
- Update knowledge base with root cause
- Add monitoring/alerts for similar issues
- Document troubleshooting steps in runbook

## Example: Illustrative Debug Session

The helpers, spans and metrics below are pseudocode for a hypothetical case; no implementation, telemetry integration or measured improvement is bundled. Replace them with actual configured tools, and never report the example numbers as observed evidence.

```typescript
// Issue: "Checkout timeout errors (intermittent)"

// 1. Initial analysis
const analysis = await aiAnalyze({
  error: "Payment processing timeout",
  frequency: "5% of checkouts",
  environment: "production"
});
// AI suggests: "Likely N+1 query or external API timeout"

// 2. Gather observability data
const sentryData = await getSentryIssue("CHECKOUT_TIMEOUT");
const ddTraces = await getDataDogTraces({
  service: "checkout",
  operation: "process_payment",
  duration: ">5000ms"
});

// 3. Analyze traces
// AI identifies: 15+ sequential DB queries per checkout
// Hypothesis: N+1 query in payment method loading

// 4. Add instrumentation
span.setAttribute('debug.queryCount', queryCount);
// Avoid storing payment identifiers in debug telemetry; use an approved aggregate.

// 5. Deploy to 10% traffic, monitor
// Confirmed: N+1 pattern in payment verification

// 6. AI generates fix
// Replace sequential queries with batch query

// 7. Validate
// - Tests pass
// - Latency reduced 70%
// - Query count: 15 → 1
```

## Output Format

Provide structured report:
1. **Issue Summary**: Error, frequency, impact
2. **Root Cause**: Detailed diagnosis with evidence
3. **Fix Proposal**: Code changes, risk, impact
4. **Validation Plan**: Steps to verify fix
5. **Prevention**: Tests, monitoring, documentation

Focus on actionable insights. Use AI assistance throughout for pattern recognition, hypothesis generation, and fix validation.

---

Issue to debug: $ARGUMENTS

## Limitations
- No supporting scripts or references are bundled in this entrypoint. Tool availability and real trace results must be checked in the current environment.
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

© sickn33 · MIT · sickn33/agentic-awesome-skills

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

Все скиллы по теме «Бэкенд и API» →
error-detective VoltAgent Community Субагент error-detective для Claude Code, который разбирает ошибки в распределённых системах: коррелирует сбои между сервисами, ищет корневые причины и предлагает меры, чтобы сбои не повторялись. CX Codex 7 557установок smart-debug Seth Hobson Слэш-команда smart-debug в Claude Code разбирает сообщения об ошибках и стек-трейсы, строит гипотезы о причине сбоя и предлагает исправление. Анализирует баги, которые воспроизводятся непостоянно. CX Codex +1 ★ 42 780звёзд репо gjalla-debug gjalla Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 357установок 08-debug AI-Driven Dev Скилл 08-debug для разбора багов: воспроизводит известную ошибку вместе с тестом и правкой, а неясную причину ищет перебором гипотез. CX Codex +1 ★ 571звёзд репо error-diagnostics Seth Hobson Плагин error-diagnostics для Claude Code отслеживает ошибки и помогает находить их первопричины при расследовании сбоев в продакшен-системах. CX Codex ★ 42 780звёзд репо smart-fix Seth Hobson Команда smart-fix для Claude Code, которая запускает цепь специализированных агентов для анализа и исправления production-проблем. CX Codex +1 ★ 126звёзд репо

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

Весь набор →
stitch-ui-design Скилл stitch-ui-design для Claude Code и Codex помогает составлять промпты для Google Stitch, генерирующего макеты веб- и мобильных интерфейсов. Он описывает экраны, стиль и поведение элементов. CX Codex +1 2установок programmatic-seo Скилл programmatic-seo для проектирования систем программного SEO: оценка осуществимости, выбор стратегии шаблонов и защита от тонкого контента. CX Codex +1 2установок backend-development-feature-development Скилл backend-development-feature-development для Claude Code ведёт разработку функции от требований и архитектуры до реализации, тестирования и выката. Координирует изменения между сервисами и командами. CX Codex +1 2установок machine-learning-ops-ml-pipeline Скилл machine-learning-ops-ml-pipeline для проектирования и развёртывания полного ML-конвейера. Координирует специализированные агенты для работы с данными, обучением моделей, их оптимизацией и развёртыванием на production. CX Codex +1 2установок conductor-manage Скилл conductor-manage ведёт треки Conductor: архивирует завершённые, возвращает из архива, переименовывает, удаляет и подчищает артефакты, оставшиеся без трека. CX Codex +1 1установок code-refactoring-context-restore Скилл code-refactoring-context-restore помогает возобновить прерванную сессию по сохранённым заметкам и текущему состоянию Git. Сверяет завершённые задачи с незакоммиченными правками и выводит следующий шаг. CX Codex +1 1установок pricing-strategy Скилл pricing-strategy для Claude Code разрабатывает цены, тарифы и модель монетизации с учётом ценности продукта и готовности клиентов платить. Помогает пересмотреть тарифы и подготовить ценовое исследование. CX Codex +1 1установок claude-ally-health Скилл claude-ally-health структурирует заметки о симптомах и выписки в хронологию для приёма у врача. Помогает подготовить вопросы доктору и разобрать терминологию по авторитетным источникам. CX Codex +1 1установок

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

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