# pr-reference

Скилл pr-reference для Claude Code собирает коммиты и дифы между ветками в структурированный XML. Данные используются для описания PR, code review и анализа изменений в проекте.

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

## Что делает

Скилл запрашивает git метаданные коммитов и выводит объединённые дифы, затем сохраняет всё в XML. Работает на macOS и Linux через bash, на Windows нужен PowerShell 7+. По умолчанию сравнивает текущую ветку с `origin/main`, но можно указать другую базовую ветку или использовать `git merge-base` для трёхстороннего сравнения.

В параметрах фильтруются расширения файлов (исключить yml, json, png) и пути (например, папки документации). Вывод сохраняется в `.copilot-tracking/pr/pr-reference.xml`. Результат — XML с историей коммитов и дифами каждого файла. Для работы требуется, чтобы ветка имела хотя бы один коммит, отличающийся от базовой ветки.

В комплекте утилиты: `list-changed-files` извлекает список изменённых файлов с фильтрацией по типам (добавлены, изменены, удалены), `read-diff` показывает содержимое дифа с разбивкой на чанки для больших изменений.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill pr-reference -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill pr-reference -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill pr-reference -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/hve-core .github/skills/shared/pr-reference
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/hve-core --skill pr-reference -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/microsoft/hve-core --path .github/skills/shared/pr-reference
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/hve-core/tree/HEAD/.github/skills/shared/pr-reference/SKILL.md

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

## Примеры запросов агенту
- Сгенерируй PR reference для текущей ветки против main, исключив yml и json
- Выведи список добавленных файлов из последнего PR reference в формате markdown
- Покажи дифф конкретного файла из сохранённого XML

## Похожие
- [lesson-learned](https://affpapa.org/nevibecode/skills/lesson-learned.md) — скилл · 3000 установок
- [code-review](https://affpapa.org/nevibecode/commands/community-code-review.md) — команда · ★ 2003 у репозитория
- [thermos](https://affpapa.org/nevibecode/skills/thermos.md) — скилл · 2400 установок
- [code-reviewer](https://affpapa.org/nevibecode/agents/anthropic-code-reviewer.md) — субагент · 31050 установок
- [role-info](https://affpapa.org/nevibecode/skills/role-info.md) — скилл · 46 установок
- [skd-decompile](https://affpapa.org/nevibecode/skills/skd-decompile.md) — скилл · 40 установок

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

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

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