project-health-check — команда для Claude Code
Команда собирает метрики репозитория и формирует отчёт о состоянии проекта с оценкой от 0 до 100. Пригодится перед релизом или планированием спринта.
npx claude-code-templates@latest --command project-management/project-health-checkЧто делает project-health-check
Команда запускает проверку кодовой базы через встроенные инструменты Read, Bash, Grep и Glob. Скрипт выполняет git log, проверяет авторов коммитов через git shortlog и считывает файлы зависимостей вроде package.json, Cargo.toml или requirements.txt.
Итоговый markdown-отчёт оценивает качество кода, командную динамику и свежесть библиотек. Для проверки уязвимостей вызывается npm audit или аналогичный сканер пакетов. Если в репозитории мало коммитов, проверка разницы через git diff выдаст предупреждение «Not enough history», поэтому для пустого проекта команда бесполезна.
Какие задачи решает
- оценить активность коммитов и распределение работы среди авторов
- найти уязвимости в зависимостях через npm audit или аналоги
- получить общую оценку здоровья кодовой базы от 0 до 100
- проверить число устаревших библиотек в манифестах проекта
Примеры запросов агенту
- /project-health-check --30-days
- /project-health-check --sprint
- /project-health-check --quarter
Как установить project-health-check
1Через claude-code-templates
npx claude-code-templates@latest --command project-management/project-health-check2Вручную: положить файлы
.claude/commands/project-health-check.mdВызов — /project-health-check. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/project-health-check.mdВызов — /prompts:project-health-check. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/project-health-check.prompt.mdВручную: положить файлы
.gemini/commands/project-health-check.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о project-health-check
Как установить project-health-check в Claude Code?
Выполните команду npx claude-code-templates@latest --command project-management/project-health-check. Файл команды запишется в .claude/commands/project-health-check.md.
Что делает команда project-health-check?
Она анализирует активность в git, зависимости и метрики качества, формируя markdown-отчёт с общей оценкой проекта от 0 до 100.
За какой период проверяются данные?
Период можно задать аргументами --30-days, --sprint или --quarter. Если параметр не передан, анализ по умолчанию берёт последние 30 дней.
Исходный текст
project-health-check.md · MIT
--- allowed-tools: Read, Bash, Grep, Glob argument-hint: "[evaluation-period] | --30-days | --sprint | --quarter" description: Analyze overall project health and generate comprehensive metrics report --- # Project Health Check Analyze overall project health and metrics: **$ARGUMENTS** ## Current Project State - Git activity: !`git log --oneline --since="30 days ago" | wc -l` - Contributors: !`git shortlog -sn --since="30 days ago" | head -5` - Branch status: !`git branch -r | wc -l` remote branches - Code changes: !`git diff --stat HEAD~30 2>/dev/null || echo "Not enough history"` - Dependencies: @package.json or @requirements.txt or @Cargo.toml (if exists) ## Task Generate a comprehensive project health report analyzing: **Evaluation Period**: Use $ARGUMENTS or default to last 30 days **Health Dimensions**: 1. **Code Quality Metrics** - Test coverage and trends - Code complexity analysis - Security vulnerabilities (run npm audit or equivalent) - Technical debt indicators 2. **Delivery Performance** - Sprint velocity trends (if task management tools available) - Cycle time analysis - Bug vs feature ratio - On-time delivery metrics 3. **Team Health Indicators** - PR review turnaround time - Commit frequency distribution - Work distribution balance - Knowledge concentration risk 4. **Dependency Health** - Outdated packages assessment - Security audit results - License compliance check - External service dependencies **Health Report Format**: - Overall health score (0-100) with color-coded status - Executive summary with key findings - Detailed metrics tables with current vs target values - Trend analysis and risk assessment - Actionable recommendations prioritized by impact **Output**: Generate markdown report with charts, metrics tables, and specific action items for improving project health.
© davila7 · MIT · davila7/claude-code-templates