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

troubleshoot — команда для Claude Code: что делает и как установить

Команда troubleshoot находит причины ошибок в коде, сборок, просадок скорости и проблем деплоя. По умолчанию только собирает диагностику и не трогает файлы без флага --fix.

MIT ★ 23 950 обновлён 2026-09-27

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/troubleshoot.md
Открыть на GitHub

Что делает troubleshoot

Команда /sc:troubleshoot запускает пошаговую диагностику неполадок в проекте. Она разбирает падения тестов, рантайм-исключения, ошибки компиляции TypeScript, просадки отзывчивости API и сбои сервисов при деплое. Для сбора информации инструмент использует Read для логов, Bash для запуска системных команд и Grep для поиска сигнатур ошибок.

Процесс состоит из пяти шагов: сбор сведений о системе, поиск первопричины через проверку гипотез, отладка, подготовка решений и внесение правок. Итогом работы становится отчёт с описанием корня сбоя, вариантами решений и оценкой рисков для каждого из них.

Главное ограничение — режим работы «сначала диагностика». Без явного указания флага --fix команда ни при каких обстоятельствах не редактирует файлы и не трогает код. Даже если передать --fix, утилита сначала спросит подтверждение у разработчика и только после одобрения применит изменения, проверив их тестами.

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

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

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

  • /sc:troubleshoot "Null pointer exception в сервисе пользователей" --type bug --trace
  • /sc:troubleshoot "Сбой сборки TypeScript" --type build --fix
  • /sc:troubleshoot "Деградация времени ответа API" --type performance

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

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

.claude/commands/troubleshoot.md

Вызов — /troubleshoot. Для всех проектов — ~/.claude/commands/

Вопросы о troubleshoot

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

Добавьте файл команды в проект по пути .claude/commands/troubleshoot.md. После сохранения файла команда будет доступна как /sc:troubleshoot.

Что делает команда troubleshoot?

Она исследует сбои в коде, сборке или конфигурации с помощью утилит Read, Bash и Grep. На выходе формируется отчёт с описанием корня проблемы, вариантами исправлений и оценкой рисков.

Меняет ли команда код без разрешения?

Без флага --fix команда только проводит анализ и вообще не трогает файлы. Если передать --fix, она всё равно запросит подтверждение перед правками и проверит результат тестами.

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

troubleshoot.md · MIT
---
name: troubleshoot
description: "Diagnose and resolve issues in code, builds, deployments, and system behavior"
category: utility
complexity: basic
mcp-servers: []
personas: []
---

# /sc:troubleshoot - Issue Diagnosis and Resolution

## Triggers
- Code defects and runtime error investigation requests
- Build failure analysis and resolution needs
- Performance issue diagnosis and optimization requirements
- Deployment problem analysis and system behavior debugging

## Usage
```
/sc:troubleshoot [issue] [--type bug|build|performance|deployment] [--trace] [--fix]
```

## Behavioral Flow
1. **Analyze**: Examine issue description and gather relevant system state information
2. **Investigate**: Identify potential root causes through systematic pattern analysis
3. **Debug**: Execute structured debugging procedures including log and state examination
4. **Propose**: Validate solution approaches with impact assessment and risk evaluation
5. **Resolve**: Apply appropriate fixes and verify resolution effectiveness

Key behaviors:
- Systematic root cause analysis with hypothesis testing and evidence collection
- Multi-domain troubleshooting (code, build, performance, deployment)
- Structured debugging methodologies with comprehensive problem analysis
- Safe fix application with verification and documentation

## Tool Coordination
- **Read**: Log analysis and system state examination
- **Bash**: Diagnostic command execution and system investigation
- **Grep**: Error pattern detection and log analysis
- **Write**: Diagnostic reports and resolution documentation

## Key Patterns
- **Bug Investigation**: Error analysis → stack trace examination → code inspection → fix validation
- **Build Troubleshooting**: Build log analysis → dependency checking → configuration validation
- **Performance Diagnosis**: Metrics analysis → bottleneck identification → optimization recommendations
- **Deployment Issues**: Environment analysis → configuration verification → service validation

## Examples

### Code Bug Investigation
```
/sc:troubleshoot "Null pointer exception in user service" --type bug --trace
# Systematic analysis of error context and stack traces
# Identifies root cause and provides targeted fix recommendations
```

### Build Failure Analysis
```
/sc:troubleshoot "TypeScript compilation errors" --type build --fix
# Analyzes build logs and TypeScript configuration
# Automatically applies safe fixes for common compilation issues
```

### Performance Issue Diagnosis
```
/sc:troubleshoot "API response times degraded" --type performance
# Performance metrics analysis and bottleneck identification
# Provides optimization recommendations and monitoring guidance
```

### Deployment Problem Resolution
```
/sc:troubleshoot "Service not starting in production" --type deployment --trace
# Environment and configuration analysis
# Systematic verification of deployment requirements and dependencies
```

## Boundaries

**Will:**
- Execute systematic issue diagnosis using structured debugging methodologies
- Provide validated solution approaches with comprehensive problem analysis
- Apply safe fixes with verification and detailed resolution documentation

**Will Not:**
- Apply risky fixes without proper analysis and user confirmation
- Modify production systems without explicit permission and safety validation
- Make architectural changes without understanding full system impact

## CRITICAL BOUNDARIES

**DIAGNOSE FIRST - FIXES REQUIRE `--fix` FLAG**

This command is DIAGNOSIS-FIRST by default.

**Default behavior (no `--fix` flag)**:
- Diagnose the issue
- Identify root cause
- Propose solution options
- **STOP and present findings to user** - do not apply any fixes

**With `--fix` flag**:
- After diagnosis, prompt user for confirmation before applying
- Apply fix only after user explicitly approves
- Verify fix with tests

**Explicitly Will NOT** (without `--fix` flag):
- Apply any code changes
- Modify any files
- Execute fixes automatically

**Output**: Diagnostic report containing:
- Issue description
- Root cause analysis
- Proposed solutions (ranked)
- Risk assessment for each solution

**Next Step**: User reviews diagnosis, then either:
- Re-run with `--fix` flag to apply recommended fix
- Use `/sc:improve` for broader refactoring

© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework

Похожие слэш-команды

Все слэш-команды по теме «Тесты и QA» →
troubleshooting-guide davila7 Команда troubleshooting-guide для Claude Code генерирует документацию по устранению неисправностей: процедуры диагностики, частые проблемы и решения. Запускается с компонентом или флагом, например --database. CX Codex +1 397установок dynamo-troubleshoot Dan Gil Скилл dynamo-troubleshoot для Claude Code разбирает сбои в развёртываниях Dynamo. Он подключается, когда ломаются поды, PVC, модельный кэш, воркеры, эндпоинты или бенчмарки. CX Codex +1 1 900установок troubleshoot-ssi datadog-labs Скилл troubleshoot-ssi для Claude Code находит причины отсутствия APM-трейсов Datadog и сбоев Single Step Instrumentation в Kubernetes. Диагностирует цепочку, когда агент настроен, но трейсы не поступают. CX Codex +1 472установок network-troubleshoot PatrickJS Правило network-troubleshoot ведёт агента через безопасную диагностику сетевых сбоев: от сбора ошибки до проверки результата. CX Codex +1 ★ 41 178звёзд репо nvshmem-troubleshoot-and-report-bugs NVIDIA NVSHMEM Team Скилл nvshmem-troubleshoot-and-report-bugs помогает разбирать сбои NVSHMEM по выводу всех PE и готовить текст отчёта об ошибке. Запрос на диагностику сам по себе не разрешает менять состояние системы. CX Codex +1 ★ 4 106звёзд репо troubleshoot-observability Microsoft Скилл troubleshoot-observability для Claude Code координирует поиск неисправностей в Azure. Направляет агента при анализе ошибок выполнения, задержек и настройке мониторинга. CX Codex +1 ★ 3 232звёзд репо

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

Весь набор →
research Команда research для исследования сложных вопросов за пределами knowledge cutoff. Самостоятельно разбивает задачу на подзадачи, ищет параллельно и собирает доказательства с указанием источников. CX Codex +1 ★ 23 950звёзд репо reflect Слэш-команда reflect анализирует ход сессии и сверяет выполненную работу с целями через Serena MCP. Пригодится перед закрытием задач и контролем качества. CX Codex +1 ★ 23 950звёзд репо explain Команда explain для структурированного объяснения кода, архитектуры и концепций на нужном уровне сложности. Помогает разобраться в чужом коде или научить других. CX Codex +1 ★ 23 950звёзд репо index Команда index для Claude Code автоматически сканирует архитектуру проекта и создаёт базу знаний, API-документацию или README с перекрёстными ссылками. CX Codex +1 ★ 23 950звёзд репо spawn Команда spawn для разбора больших многодоменных операций на иерархию скоординированных задач. Анализирует, декомпозирует, назначает исполнителей — сама не пишет код, только планирует. CX Codex +1 ★ 23 950звёзд репо cleanup Команда cleanup находит мёртвый код, удаляет неиспользуемые импорты и приводит структуру проекта в порядок без риска сломать публичный интерфейс. CX Codex +1 ★ 23 950звёзд репо deep-research-agent Субагент deep-research-agent для Claude Code исследует тему от поиска источников до выводов с доказательствами. Синтезирует информацию по сложным вопросам и запросам о текущих событиях. CX Codex ★ 23 950звёзд репо improve Команда improve устраняет технический долг, ускоряет выполнение участков кода и закрывает бреши в безопасности. Применяется при рефакторинге компонентов или наведении порядка в проекте. CX Codex +1 ★ 23 950звёзд репо

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

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