review-walkthrough

Что делает навык

Генерирует самодостаточный HTML-обзор (walkthrough) изменений в текущей ветке, разбивая дифф на логические шаги с объяснениями и результатами критического анализа кода. Используется для структурированной проверки изменений перед мёржем.

Когда применять

• Необходимость получить структурированный обзор изменений в коде с пояснениями и выявленными рисками.
• Проверка pull request на наличие багов, проблем безопасности или архитектурных компромиссов.
• Подготовка материалов для ревью, где важно показать логику изменений, а не просто сырой дифф.
• Анализ сложных изменений, требующих понимания контекста и связей между файлами.

Как работает

1. Определить базовую ветку (PR base, default branch или указанную пользователем) и вычислить merge base с текущей HEAD.
2. Захватить полный дифф (patch) между merge base и HEAD, сохранив его во временный файл.
3. Сгруппировать изменённые файлы в логические шаги, сохраняя порядок чтения для понимания (определения до потребителей, тесты рядом с кодом).
4. Для каждого шага написать объяснение (50–150 слов) и список замечаний (bugs, security, API, performance) с указанием severity.
5. Сформировать JSON-объект с полями title, steps, explanations, reviews, pr_meta и сохранить его.
6. Запустить рендерер scripts/render_walkthrough.py для создания HTML-файла, открыть его в браузере или сообщить путь.

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

Что понадобится

• Git (для работы с ветками, diff, merge-base)
• uv (для запуска рендерера render_walkthrough.py)
• Доступ к метаданным PR (опционально, для GitHub)

Описание составлено по SKILL.md навыка, сверено 15.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.