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

doctor · rohitg00 — команда для Claude Code: диагностика конфигурации

Команда doctor проверяет здоровье установки pro-workflow и конфигурации Claude Code: хуки, база данных, контекст, MCP-серверы, гит-статус. Помогает отловить сломанные скрипты и конфликты настроек на ранней стадии.

MIT ★ 2 966 обновлён 2026-09-29

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

Что делает doctor

Команда doctor запускает цепочку диагностических проверок. Она проверяет, что команды pro-workflow на месте, база данных доступна, хуки активны и срабатывают корректно. Протестирует commit-validate, secret-scan и git-blast-radius на валидных и невалидных входах — каждый должен вернуть OK.

Смотрит контекст (если больше 90%, нужно запустить /compact), считает строки в CLAUDE.md (если больше 150 — пора разбить на модули), проверяет MCP-серверы (желательно меньше 10), гит-статус и конфликты между проектным и пользовательским settings.json. Для wiki и council показывает состояние без раскрытия значений переменных окружения.

В конце выдаёт сводку: установка OK/нужна, хуки активны/нет, контекст в процентах и статус, МСП-серверов и CLAUDE.md.

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

  • Проверить, что все скрипты хуков работают и блокируют опасные операции
  • Выявить конфликты между проектными и глобальными настройками Claude Code
  • Отследить размер контекста и CLAUDE.md перед критическими операциями
  • Убедиться, что pro-workflow установлен и база данных доступна
  • Диагностировать неактивные хуки и неправильные пути к скриптам

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

  • Запусти /doctor перед важным коммитом, чтобы убедиться, что хуки блокируют опасный код
  • Используй /doctor если контекст деградировал или Claude странно себя ведёт
  • Вызови /doctor после обновления pro-workflow, чтобы проверить, что ничего не сломалось

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

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

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

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

.claude/commands/pro-workflow-doctor.md

Встроенная /doctor перекрывает файл с тем же именем, поэтому файл назван иначе. Вызов — /pro-workflow-doctor. Для всех проектов — ~/.claude/commands/

Вопросы о doctor

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

Выполни /plugin marketplace add rohitg00/pro-workflow, затем /plugin install pro-workflow@pro-workflow и укажи файл .claude/commands/pro-workflow-doctor.md.

Что делает doctor?

Проверяет установку pro-workflow, активность хуков (commit-validate, secret-scan, git-blast-radius), размер контекста и CLAUDE.md, количество MCP-серверов, гит-статус и конфликты настроек. Выдаёт сводку и предлагает фиксы.

Что означает, если doctor показывает 'Hooks: INACTIVE'?

Хуки не срабатывают. Проверь, что hooks.json лежит в правильном месте, пути используют ${CLAUDE_PLUGIN_ROOT} или абсолютные, и скрипты имеют права на выполнение.

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

doctor.md · MIT
---
description: Diagnose pro-workflow setup and Claude Code configuration
---

# /doctor - Configuration Health Check

Run a diagnostic on your pro-workflow and Claude Code setup.

## Check These

### 1. Pro-Workflow Installation
```bash
ls -la ~/.claude/commands/wrap-up.md 2>/dev/null && echo "Commands: OK" || echo "Commands: MISSING"
ls -la ~/.pro-workflow/data.db 2>/dev/null && echo "Database: OK" || echo "Database: MISSING"
```

### 2. Hooks Status
Check if hooks.json is loaded and hooks are active. Run:
```bash
cat ~/.claude/settings.local.json 2>/dev/null | head -5
```

If hooks aren't firing, check:
- hooks.json is in the right location
- Script paths use `${CLAUDE_PLUGIN_ROOT}` or absolute paths
- Scripts have execute permissions

### 2a. Deterministic Hook Sanity
Verify each hook script on both happy and failing inputs:
```bash
# commit-validate: valid passes, bad format blocks (exit 2)
echo '{"tool_input":{"command":"git commit -m \"feat: x\""}}' | node "$CLAUDE_PLUGIN_ROOT/scripts/commit-validate.js" && echo "commit-validate pass: OK"
echo '{"tool_input":{"command":"git commit -m \"not conventional\""}}' | node "$CLAUDE_PLUGIN_ROOT/scripts/commit-validate.js" 2>&1; test $? -eq 2 && echo "commit-validate block: OK"

# secret-scan: clean passes, hardcoded key blocks
echo '{"tool_input":{"content":"hello"}}' | node "$CLAUDE_PLUGIN_ROOT/scripts/secret-scan.js" && echo "secret-scan pass: OK"
echo '{"tool_input":{"content":"key=\"AKIAIOSFODNN7EXAMPLE\""}}' | node "$CLAUDE_PLUGIN_ROOT/scripts/secret-scan.js" 2>&1; test $? -eq 2 && echo "secret-scan block: OK"

# git-blast-radius: safe passes, destructive blocks
echo '{"tool_input":{"command":"git status"}}' | node "$CLAUDE_PLUGIN_ROOT/scripts/git-blast-radius.js" && echo "git-blast-radius pass: OK"
echo '{"tool_input":{"command":"git reset --hard"}}' | node "$CLAUDE_PLUGIN_ROOT/scripts/git-blast-radius.js" 2>&1; test $? -eq 2 && echo "git-blast-radius block: OK"
```
Every line should print an `OK`. Missing any means the script is silently broken.

### 2b. Git Safety Override
If you need to run a blocked git operation deliberately (e.g. intentional
`git reset --hard` during recovery), export `PRO_WORKFLOW_ALLOW_UNSAFE_GIT=1`
for the shell that will run it. Never set it globally.

### 3. Context Health
```text
/context
```
- Usage < 70%: Healthy
- Usage 70-90%: Consider `/compact`
- Usage > 90%: Compact immediately or start fresh

### 4. MCP Servers
Check active MCPs. Target: <10 servers, <80 tools.

### 5. CLAUDE.md Size
```bash
wc -l CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found"
```
- < 60 lines: Ideal
- 60-150 lines: Acceptable
- > 150 lines: Too long, split into modules

### 6. Git Status
```bash
git status --short
git stash list
```
- Uncommitted changes? Commit or stash.
- Stale stashes? Clean up.

### 7. Settings Validation
```bash
cat .claude/settings.json 2>/dev/null | head -3
cat ~/.claude/settings.json 2>/dev/null | head -3
```
- Check for conflicting settings between project and user level
- Verify permission rules are correct

### 8. Wiki Knowledge Base
```bash
node $PRO_WORKFLOW_ROOT/skills/wiki-builder/scripts/wiki-cli.js list 2>/dev/null
node $PRO_WORKFLOW_ROOT/skills/wiki-research-loop/scripts/research-loop.js status 2>/dev/null
ls -1 ~/.pro-workflow/STOP 2>/dev/null && echo "KILL SWITCH ACTIVE — no research runs"
tail -5 ~/.pro-workflow/tick.log 2>/dev/null
```
- List of wikis · seed counts per status · kill-switch state · last cron-tick activity
- Embeddings require an OpenAI or Voyage key configured for this plugin. BM25 search remains local and needs no key. Never print environment values or read credential files.

### 9. Council Providers

In a plugin session, call `run_provider_task` on the `providers` MCP server with `{"task":"council","args":["providers"]}`. It reports configured status without revealing values. The command below is for standalone CLI use.
```bash
node $PRO_WORKFLOW_ROOT/skills/llm-council/scripts/council.js providers 2>/dev/null
```
- Shows which pro-workflow credentials are configured (Anthropic/OpenAI/OpenRouter/Fireworks/custom), without exposing values.

## Quick Fixes

| Issue | Fix |
|-------|-----|
| Commands missing | `cp -r /path/to/pro-workflow/commands/* ~/.claude/commands/` |
| Database missing | `mkdir -p ~/.pro-workflow && npm run build` (in plugin dir) |
| Hooks not firing | Check paths in hooks.json use absolute paths |
| Context degraded | Run `/compact` or start fresh session |
| Too many MCPs | Disable unused: `disabledMcpjsonServers` in settings |
| CLAUDE.md too long | Split into root + package-level files |

## Report

After running checks, summarize:
```text
Pro-Workflow Health Check
  Installation:  OK / NEEDS SETUP
  Hooks:         ACTIVE / INACTIVE
  Context:       XX% (healthy/warning/critical)
  MCPs:          X active (OK / TOO MANY)
  CLAUDE.md:     XX lines (OK / SPLIT RECOMMENDED)
  Git:           clean / X uncommitted files
```

© Rohit Ghumare · MIT · rohitg00/pro-workflow

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

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →

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

doctor Son Nguyen Команда doctor для Claude Code проверяет связь с панелью Agent Monitor и состояние её API. Она запускает две проверки и выводит краткий отчёт. CX Codex +1 ★ 1 198звёзд репо maxxing-doctor makushingu Скилл maxxing-doctor для Claude Code диагностирует и исправляет ошибки в установках Harness Maxxing. Инструмент запускается при сбоях интерфейса, проблемах с сессиями или зависании заданий. CX Codex +1 ★ 285звёзд репо groove-admin-doctor andreadellacorte Скилл groove-admin-doctor для Claude Code проверяет состояние Groove: репозиторий, версии, субскиллы, companions, symlinks и хуки. Помогает найти проблемы перед работой. CX Codex +1 573установок groove-utilities-task-doctor andreadellacorte Скилл groove-utilities-task-doctor проверяет состояние бэкенда задач: конфигурацию, CLI, авторизацию и доступность. Подходит для диагностики перед работой с задачами. CX Codex +1 552установок jetson-diagnostic Jetson Team Скилл jetson-diagnostic для Claude Code снимает состояние Jetson: модель, память, GPU, температуру, питание, диск, сервисы и процессы. Проверяет устройство по живым данным. CX Codex +1 1 300установок tool-foundation-sprint-readiness product-on-purpose Скилл tool-foundation-sprint-readiness для Claude Code оценивает готовность команды перед Foundation Sprint и помогает решить, запускать его сейчас, отложить или сначала закрыть пробелы. Занимает 30–45 минут. CX Codex +1 705установок clinical-diagnostic-reasoning curiositech Скилл clinical-diagnostic-reasoning помогает находить когнитивные искажения во врачебных решениях, проверять диагнозы на предвзятость и разбирать клинические ошибки. Пригодится при составлении плана обследования и лечения. CX Codex +1 178установок

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

Весь набор →
design-engineering Скилл design-engineering для Claude Code — проектирует анимации и состояния интерфейса, разбирает UI-код компонентов, переходов и модальных окон. CX Codex +1 ★ 2 966звёзд репо permission-tuner Скилл permission-tuner для Claude Code анализирует запросы на разрешение и отказы автомода, генерируя правила, которые сокращают прерывания. Включайте его, если разрешения мешают работе. CX Codex +1 ★ 2 966звёзд репо batch-orchestration Скилл batch-orchestration разбивает массовые однотипные изменения в коде на независимые части и запускает параллельных агентов в изолированных git worktree. CX Codex +1 ★ 2 966звёзд репо insights Команда insights в Claude Code считает статистику сессий: правки файлов, самоисправления агента и сработавшие правила. Показывает повторяющиеся ошибки. CX Codex +1 ★ 2 966звёзд репо thoroughness-scoring Скилл thoroughness-scoring обязывает ассистента оценивать инженерные решения по шкале от 1 до 10 и предпочитать надёжный код быстрым костылям. CX Codex +1 ★ 2 966звёзд репо skill-optimizer Скилл skill-optimizer анализирует накопленные исправления и предлагает правки для SKILL.md. Изменения проходят проверку на отложенных примерах, прежде чем попасть в файл. CX Codex +1 ★ 2 966звёзд репо agent-teams Скилл agent-teams для Claude Code объединяет несколько сессий в команду с общими задачами, сообщениями и блокировками файлов. Координатор делегирует работу над разными частями кода. CX Codex +1 ★ 2 966звёзд репо sprint-status Скилл sprint-status организует отслеживание параллельных сессий Claude Code через строки статуса и явное указание проекта, ветки и задачи. CX Codex +1 ★ 2 966звёзд репо

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

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