🔄 Что это
Verification Loop — это автоматизированная система для многоэтапной проверки кода в сессиях Claude Code. Skill помогает разработчику убедиться, что изменения в проекте готовы к Pull Request: корректно собираются, проходят типизацию, линтинг, тесты, не содержат утечек секретов и лишних console.log. Особенно полезен после завершения фичи, рефакторинга или перед созданием PR.
Система разбита на 6 фаз — от сборки до инспекции изменений (diff) — и завершается сводным отчётом с итоговым вердиктом «PR: HAZIR / HAZIR DEĞİL» (готов / не готов).
⚙️ Как работает
Фаза 1: Build Doğrulaması (Проверка сборки)
Запускается стандартная команда сборки (npm run build или pnpm build). Если сборка падает — Skill останавливается и требует исправления. Это «ворота», через которые нельзя пройти, пока проект не компилируется.
Фаза 2: Tip Kontrolü (Проверка типов)
Для TypeScript — npx tsc --noEmit, для Python — pyright .. Все ошибки типов фиксируются; критические — блокируют дальнейшие фазы. Skill ожидает, что ошибки будут исправлены до продолжения.
Фаза 3: Lint Kontrolü (Проверка линтером)
Запускается ESLint (через npm run lint) для JS/TS или ruff check . для Python. Выводятся предупреждения и ошибки, но фаза не блокирует — отчёт накапливается.
Фаза 4: Test Paketi (Тестовый пакет)
Запускаются тесты с покрытием (npm run test -- --coverage). Целевой порог покрытия — минимум 80%. В отчёт включаются:
- общее количество тестов
- сколько прошло / упало
- процент покрытия
Фаза 5: Güvenlik Taraması (Сканирование безопасности)
Ищет потенциально опасные паттерны в исходниках:
- ключи API и секреты (по шаблону
sk-, api_key)
console.log в рабочем коде (в src/)
Каждый найденный инцидент попадает в итоговый отчёт как FAIL.
Фаза 6: Diff İncelemesi (Инспекция изменений)
Показывает статистику изменений (git diff --stat) и список файлов (git diff HEAD~1 --name-only). Разработчику предлагается проверить каждый изменённый файл на:
- нежелательные правки
- отсутствие обработки ошибок
- потенциальные edge case’ы
📋 Итоговый отчёт
После выполнения всех фаз формируется сводка:
DOĞRULAMA RAPORU
==================
Build: [PASS/FAIL]
Tipler: [PASS/FAIL] (X ошибок)
Lint: [PASS/FAIL] (X предупреждений)
Testler: [PASS/FAIL] (X/Y прошло, %Z coverage)
Güvenlik: [PASS/FAIL] (X проблем)
Diff: [X файлов изменено]
Genel: PR için [HAZIR/HAZIR DEĞİL]
Список проблем, требующих исправления, выводится отдельно.
🔁 Постоянный режим (Sürekli Mod)
Для длительных сессий Skill рекомендует запускать проверку каждые 15 минут или после каждого крупного изменения:
- после завершения функции
- после написания компонента
- перед переходом к следующей задаче
Можно вызвать командой /verify.
🪝 Интеграция с Hook’ами
Skill дополняет встроенные PostToolUse hook’ы: hook’ы ловят проблемы на лету, а Verification Loop выполняет глубокую многоэтапную проверку перед PR.
✅ Когда использовать
- сразу после завершения фичи или важного изменения кода
- перед созданием Pull Request
- после рефакторинга
- для проверки прохождения «качественных ворот» (quality gates)
- в длительных сессиях — в непрерывном режиме для поддержания качества
⚠️ Важно знать
- Первый этап критический: если сборка не проходит — Skill не продолжает.
- Тестовое покрытие: целевое значение 80%, но это можно менять.
- Поиск секретов: ищет только по шаблонам (
sk-, api_key), не заменяет полноценный SAST-сканер.
- Diff-инспекция: автоматизирована только статистика; содержательный анализ файлов — ответственность разработчика.
- Skill не вносит изменения сам — только проверяет и формирует отчёт.
Skill подходит для проектов на JavaScript/TypeScript и Python, с npm/pnpm или pip/ruff. Команды можно адаптировать под конкретный стек, заменив шаги в описании фаз.
Комментарии
Комментариев пока нет. Будьте первым.