# review-walkthrough

Собирает из диффа текущей ветки HTML-страницу с пошаговым разбором изменений и замечаниями по коду. Вызывается вручную, когда нужно пройти ревью глазами.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 671 установка · ★ 7805
- Автор: trailofbits
- Лицензия: CC-BY-SA-4.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/trailofbits/skills/tree/HEAD/plugins/review-walkthrough/skills/review-walkthrough/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/review-walkthrough

## Что делает

Скилл берёт патч ветки и раскладывает его на шаги: связанные файлы в одну группу, определения раньше мест, где их используют, тесты рядом с тем, что они проверяют. Порядок коммитов при этом не важен — скилл сам выбирает, как читать удобнее. К каждому шагу идёт пояснение на 50–150 слов и список найденных проблем с уровнем серьёзности.

Базовую ветку скилл определяет так: сначала открытый PR, если метаданные доступны, иначе ветка по умолчанию из `git symbolic-ref --quiet --short refs/remotes/origin/HEAD`. `main` он не подставляет наугад — если база неоднозначна, спросит. Патч сохраняется во временный файл вне репозитория, а рендер идёт через `uv run --no-project {baseDir}/scripts/render_walkthrough.py`. Значит, `uv` должен быть в системе: без него страница не соберётся.

Ревью остаётся только чтением. Скилл не запускает тесты проекта и не ставит зависимости, ветки не переключает. Незакоммиченные правки в разбор не попадают, о них он просто сообщит. Метаданные GitHub нужны лишь для экспорта комментариев: страница даёт скопировать команду `gh api`, но сама ничего не публикует.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill review-walkthrough -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/review-walkthrough/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/review-walkthrough/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill review-walkthrough -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/review-walkthrough/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill review-walkthrough -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/review-walkthrough/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install trailofbits/skills review-walkthrough
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/review-walkthrough/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill review-walkthrough -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/trailofbits/skills --path plugins/review-walkthrough/skills/review-walkthrough
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/review-walkthrough/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill review-walkthrough -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/trailofbits/skills/tree/HEAD/plugins/review-walkthrough/skills/review-walkthrough/SKILL.md

## Когда брать
- разложить большой дифф на читаемые шаги
- объяснить назначение изменений по файлам
- найти проблемы в коде с уровнем серьёзности
- привязать замечание к конкретной строке диффа
- подготовить разбор ветки перед ревью коллеги

## Примеры запросов агенту
- /review-walkthrough:review-walkthrough
- $review-walkthrough
- сделай walkthrough по текущей ветке, база — ветка релиза

## Похожие
- [difit-review](https://affpapa.org/nevibecode/skills/difit-review.md) — скилл · 1900 установок
- [hunk-review](https://affpapa.org/nevibecode/skills/hunk-review.md) — скилл · 1800 установок
- [fallow-review](https://affpapa.org/nevibecode/skills/fallow-review.md) — скилл · 885 установок
- [code-review](https://affpapa.org/nevibecode/skills/waybarrios-code-review.md) — скилл · 468 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [bmad-walkthrough](https://affpapa.org/nevibecode/skills/bmad-walkthrough.md) — скилл · 11200 установок

Из того же набора: [trailofbits/skills](https://affpapa.org/nevibecode/by/trailofbits/skills.md) — 77 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md