# diff-computation

Правило diff-computation задаёт порядок код-ревью: сначала вычисляет дифф, затем читает файлы. Находки ограничены изменёнными строками, большие патчи читаются порциями.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1627 у репозитория
- Автор: microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/code-review/diff-computation.instructions.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/diff-computation

## Что делает

Правило задаёт порядок: дифф получают до того, как агент откроет хоть один файл исходников. Сначала идут `git branch --show-current` и `git status --short`, дальше — дерево решений из пяти случаев: обзор ветки или PR, незакоммиченные правки на `main`, выделенный код, отдельный коммит и «ревьюить нечего». Для ветки вызывается скилл pr-reference: `generate.sh --base-branch auto --merge-base --exclude-ext min.js,min.css,map --output .copilot-tracking/pr/pr-reference.xml`, затем список изменённых файлов и чтение диффа порциями через `read-diff.sh --chunk N`.

Область проверки зафиксирована. Находки берутся только со строк, которые дифф добавляет или меняет, полные файлы читаются ради контекста, а старые проблемы в неизменённом коде уходят в отдельную таблицу и не влияют на вердикт. Крупные диффы разбираются по размеру: меньше 20 файлов целиком, от 20 до 50 по каталогам, больше 50 партиями по 5-10 файлов; если изменений больше 2000 строк или 500 в одном файле, правило советует смотреть коммиты по одному.

Из ревью выпадают lock-файлы, минифицированные бандлы, source maps, бинарники и каталоги сборки. Работает это на скриптах скилла pr-reference; когда их нет или они падают, дифф считается вручную через `git merge-base` и `git diff`. Сам файл в `.claude/rules/` ничего не подключает: в `code-review.agent.md` правило попадает только через импорт `#file:`, иначе агент его не увидит.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/instructions/diff-computation.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/diff-computation.md` — Поле paths во frontmatter ограничивает файлы: applyTo из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/diff-computation.mdc` — Во frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/diff-computation.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/diff-computation.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/code-review/diff-computation.instructions.md

## Когда брать
- получить дифф ветки раньше, чем агент откроет исходники
- разложить дифф на 2000 строк и больше на порции для анализа
- выкинуть lock-файлы и минифицированные бандлы из ревью
- отделить коммиты своей ветки от незакоммиченных правок на `main`
- не тащить в вердикт замечания к неизменённым строкам

## Примеры запросов агенту
- Проверь ветку `feature/login`: сначала посчитай дифф по правилу diff-computation, потом читай файлы.
- Сделай ревью незакоммиченных правок на `main`, неотслеживаемые файлы тоже включи.
- Дифф большой — пройди его по частям через `read-diff.sh --chunk N` и пропусти lock-файлы.

## Похожие
- [understand-diff](https://affpapa.org/nevibecode/skills/understand-diff.md) — скилл · 4200 установок
- [diff-context](https://affpapa.org/nevibecode/skills/diff-context.md) — скилл · ★ 34 у репозитория
- [diff-analyze](https://affpapa.org/nevibecode/skills/diff-analyze.md) — скилл · 753 установки
- [diff-scanning-with-aws-security-agent](https://affpapa.org/nevibecode/skills/diff-scanning-with-aws-security-agent.md) — скилл · 1600 установок
- [security-diff-scan](https://affpapa.org/nevibecode/skills/security-diff-scan.md) — скилл · 30 установок
- [explain-diff](https://affpapa.org/nevibecode/skills/nick-nisi-explain-diff.md) — скилл · ★ 114 у репозитория

Из того же набора: [microsoft/hve-core](https://affpapa.org/nevibecode/by/microsoft/hve-core.md) — 148 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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