Doctor
SomeStay07/claude-doctor-skillСкилл для Claude Code, который проводит полный аудит проекта: безопасность, CI/CD, тесты, хуки, конфигурация. Автоопределяет стек (20+ языков), адаптирует оценку под зрелость проекта, предлагает конкретные исправления. Без зависимостей.
Установка
git clone https://github.com/SomeStay07/claude-doctor-skill.gitREADME
Doctor
46 автоматических проверок по 6 слоям. Адаптивная оценка. Проверено на реальных проектах.
Скилл для Claude Code, который аудирует любой проект — утечки секретов, сломанные хуки, отсутствие тестов, неправильно настроенный CI. Автоматически определяет стек (20+ языков), адаптирует оценку под уровень зрелости и предлагает конкретные исправления со ссылками на источники.
Что делает · Адаптивная оценка · 6 слоёв · Установка · Использование · Как работает · Пример вывода · FAQ
Установка за 5 секунд:
curl -sSL https://raw.githubusercontent.com/SomeStay07/claude-doctor-skill/main/install.sh | bashПроблема
Вы настраиваете Claude Code и начинаете разработку. Всё кажется нормальным — пока не обнаруживаете:
- Секреты попали в историю git
- Файлы
.envдоступны всем на чтение (права644) - Нет pre-commit хуков, которые ловят сломанный код
- CI не запускает тесты автоматически
- Claude не помнит прошлых решений
- Нет доменных правил — Claude повторяет одни и те же ошибки
Вы не знаете, чего не знаете. Doctor выяснит это за вас.
Что делает
Doctor — набор .md-файлов, который превращает Claude Code в аудитор проекта. Запустите /doctor и получите полный отчёт о состоянии проекта с уровнями серьёзности, объяснениями и исправлениями в один клик.
Что такое скилл для Claude Code? Файл
.mdв директории.claude/skills/, который задаёт Claude специализированное поведение. Никаких плагинов, никаких API-ключей — только текстовые файлы. Подробнее
Каждая находка специфична для проекта (не шаблон) и объясняет ПОЧЕМУ это важно, со ссылкой на источник.
/doctor scan — Диагностика
/doctor fix — Рекомендации и применение
Кратко
| 46 проверок по 6 слоям безопасности и автоматизации | 20+ стеков определяются автоматически при запуске |
| Адаптивная оценка — 4 уровня зрелости | 14 правил фильтрации ложных срабатываний — без лишнего шума |
| Самопроверка перед выводом (10-точечная проверка) | Реагирование на инциденты — 9-шаговое восстановление при утечке секретов |
Без зависимостей — только .md-файлы | Двуязычный — английский и русский |
| Проверено на практике — 89 багов найдено и исправлено за 4 итерации на реальных проектах | Устойчивость к сбоям — корректно работает при отсутствии git, тестов, переполнении контекста |
Адаптивная оценка
Doctor автоматически определяет зрелость проекта и адаптируется — какие проверки учитываются, веса слоёв, пороги оценки и даже терминология. Каждый получает справедливую оценку.
| Уровень | Определяется когда | Проверок | Описание |
|---|---|---|---|
| Starter | Нет git, или нет тестов/CI/линтера | 18 | Только базовые проверки — безопасность и основы |
| Growing | Git + зависимости + (тесты или линтер) | 27 | Добавляет проверки quality gate |
| Mature | Тесты + линтер + (CI или env) | 34 | Добавляет продвинутые практики |
| Pro | Mature + автоматизация Claude Code | 46 | Все проверки, включая специфичные для CC |
Взвешенная оценка по слоям
| Слой | Starter | Growing | Mature | Pro |
|---|---|---|---|---|
| Security | 50% | 30% | 25% | 20% |
| Foundation | 35% | 25% | 20% | 15% |
| Quality | 15% | 30% | 25% | 20% |
| Intelligence | — | 5% | 10% | 15% |
| Context | — | 5% | 10% | 15% |
| DX | — | 5% | 10% | 15% |
— = слой отображается как бонус, вес 0%. Проверки выше вашего уровня отображаются как Bonus (видны, но не влияют на оценку).
/doctor quick — Аудит за 30 секунд
QUICK AUDIT (Growing)
========================
Core score: 15/19 (79%)
TOP-3 PRIORITIES:
1. chmod 600 .env — secrets are world-readable
2. Add pre-commit hook — broken code reaches git
3. Add .env.example — new devs can't onboard
> /doctor for full audit (46 checks)
6 слоёв, 46 проверок
Слои упорядочены по приоритету — нельзя работать над DX, если сломана Security:
| Слой | Название | Проверок | Что охватывает |
|---|---|---|---|
| 0 | Security | 13 | Секреты в git, SAST, .gitignore, права .env, безопасность Docker, ключи на клиенте, защита от перерасхода AI API, стратегия резервного копирования, реагирование на инциденты |
| 1 | Foundation | 7 | CLAUDE.md, README.md, манифест зависимостей, скрипты сборки, структура проекта, актуальность зависимостей, миграции БД |
| 2 | Quality Gates | 12 | Линтер, хуки PostToolUse/PreToolUse, покрытие тестами, типизация, форматирование, проверка документации |
| 3 | Intelligence | 6 | Память Claude, доменные правила, контекст принятых решений |
| 4 | Context | 4 | Актуальность контекста, согласованность правил |
| 5 | DX | 4 | Скорость онбординга, удобство локальной разработки |