К основному содержанию
скилл CX Codex

pr-reference — скилл для Claude Code: генерация PR с дифами

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

MIT ★ 1 627 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add microsoft/hve-core --skill pr-reference -a claude-code
Открыть на GitHub

Что делает 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 показывает содержимое дифа с разбивкой на чанки для больших изменений.

Какие задачи решает

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

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

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

Как установить pr-reference

1Через Skills CLI (Vercel)

npx skills add microsoft/hve-core --skill pr-reference -a claude-code

2Вручную: положить файлы

~/.claude/skills/pr-reference/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pr-reference/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pr-reference

Как установить pr-reference в Claude Code?

Выполни команду npx skills add microsoft/hve-core --skill pr-reference -a claude-code, затем открой ~/.claude/skills/pr-reference/SKILL.md.

Что делает pr-reference?

Собирает коммиты и дифы между ветками git в XML с возможностью фильтровать файлы по расширениям и путям. Помогает готовить PR, code review и анализировать изменения.

Какие требования для работы скилла?

На macOS и Linux нужен bash (установлен по умолчанию), на Windows — PowerShell 7+. Ветка должна содержать хотя бы один коммит, отличающийся от базовой ветки.

Исходный текст

SKILL.md · MIT
---
name: pr-reference
description: 'Generates PR reference XML with commit history and unified diffs between branches, with extension and path filtering. Use when creating pull request descriptions, preparing code reviews, analyzing branch changes, discovering work items from diffs, or generating structured diff summaries.'
license: MIT
user-invocable: true
compatibility: 'Requires git available on PATH'
metadata:
  authors: "microsoft/hve-core"
  spec_version: "1.0"
  last_updated: "2026-03-16"
---

# PR Reference Generation Skill

## Overview

Queries git for commit metadata and diff output, then produces a structured XML document. Both bash and PowerShell implementations are provided.

Use cases:

* PR description generation from commit history
* Code review preparation with structured diff context
* Work item discovery by analyzing branch changes
* Security analysis of modified files

After successful generation, include a file link to the absolute path of the XML output in the response.

## Prerequisites

The repository must have at least one commit diverging from the base branch.

| Platform       | Runtime              |
|----------------|----------------------|
| macOS / Linux  | Bash (pre-installed) |
| Windows        | PowerShell 7+ (pwsh) |
| Cross-platform | PowerShell 7+ (pwsh) |

## Quick Start

Run the following command to generate a PR reference with default settings (compares against `origin/main`):

```bash
scripts/generate.sh
scripts/generate.sh --base-branch auto --merge-base --exclude-ext yml,json
```

```powershell
scripts/generate.ps1
scripts/generate.ps1 -BaseBranch auto -MergeBase -ExcludeExt yml,json
```

Output saves to `.copilot-tracking/pr/pr-reference.xml` by default.

## Parameters Reference

| Parameter          | Flag (bash)      | Flag (PowerShell)      | Default                                    | Description                                                                                                |
|--------------------|------------------|------------------------|--------------------------------------------|------------------------------------------------------------------------------------------------------------|
| Base branch        | `--base-branch`  | `-BaseBranch`          | `origin/main` (bash) / `main` (PowerShell) | Target branch for comparison. Use `auto` to detect remote default.                                         |
| Merge base         | `--merge-base`   | `-MergeBase`           | false                                      | Use `git merge-base` for three-way comparison                                                              |
| Exclude markdown   | `--no-md-diff`   | `-ExcludeMarkdownDiff` | false                                      | Exclude markdown files (*.md) from the diff                                                                |
| Exclude extensions | `--exclude-ext`  | `-ExcludeExt`          | (none)                                     | Comma-separated extensions to exclude (e.g., `yml,yaml,json,png`)                                          |
| Exclude paths      | `--exclude-path` | `-ExcludePath`         | (none)                                     | Comma-separated path prefixes to exclude (for example, documentation and GitHub configuration directories) |
| Output path        | `--output`       | `-OutputPath`          | `.copilot-tracking/pr/pr-reference.xml`    | Custom output file path                                                                                    |

Both defaults resolve to the same remote comparison. The PowerShell script automatically resolves `origin/<branch>` when a bare branch name is provided.

## Additional Scripts Reference

After generating the PR reference, use these utility scripts to query the XML.

### List Changed Files

Run the list script to extract file paths from the diff:

```bash
scripts/list-changed-files.sh                              # all changed files
scripts/list-changed-files.sh --type added                  # filter by single type
scripts/list-changed-files.sh --type added,modified,renamed  # filter by multiple types
scripts/list-changed-files.sh --exclude-type deleted         # exclude specific types
scripts/list-changed-files.sh --format markdown              # output as markdown table
```

```powershell
scripts/list-changed-files.ps1                             # all changed files
scripts/list-changed-files.ps1 -Type Added                  # filter by single type
scripts/list-changed-files.ps1 -Type Added,Modified,Renamed # filter by multiple types
scripts/list-changed-files.ps1 -ExcludeType Deleted          # exclude specific types
scripts/list-changed-files.ps1 -Format Json                  # output as JSON
```

| Parameter    | Flag (bash)      | Flag (PowerShell) | Default | Description                                                           |
|--------------|------------------|-------------------|---------|-----------------------------------------------------------------------|
| Input path   | `--input`, `-i`  | `-InputPath`      | (auto)  | Path to pr-reference.xml                                              |
| Type filter  | `--type`, `-t`   | `-Type`           | `all`   | Change types to include (comma-separated: added, modified, etc.)      |
| Exclude type | `--exclude-type` | `-ExcludeType`    | (none)  | Change types to exclude. Mutually exclusive with `--type` (non-`all`) |
| Format       | `--format`, `-f` | `-Format`         | `plain` | Output format: plain, json, or markdown                               |

### Read Diff Content

Run the read script to inspect diff content with chunking for large diffs:

```bash
scripts/read-diff.sh --info             # chunk info (count, line ranges)
scripts/read-diff.sh --chunk 1          # read a specific chunk
scripts/read-diff.sh --file src/main.ts  # extract diff for one file
scripts/read-diff.sh --summary          # file stats summary
```

```powershell
scripts/read-diff.ps1 -Info              # chunk info
scripts/read-diff.ps1 -Chunk 1           # read a specific chunk
scripts/read-diff.ps1 -File "src/main.ts" # extract diff for one file
```

## Output Format

The generated XML wraps commit metadata and unified diff output in a `<commit_history>` root element. See the [reference guide](references/REFERENCE.md) for the complete XML schema, element reference, output path variations, and workflow integration patterns.

## Troubleshooting

| Symptom                         | Cause                                 | Resolution                                                                |
|---------------------------------|---------------------------------------|---------------------------------------------------------------------------|
| "No commits found" or empty XML | No diverging commits from base branch | Verify the branch has commits ahead of the base with `git log base..HEAD` |
| "Branch not found" error        | Base branch ref missing locally       | Run `git fetch origin` to update remote tracking refs                     |
| "git: command not found"        | git is not on PATH                    | Install git or verify PATH includes the git binary directory              |

© microsoft · MIT · microsoft/hve-core

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
lesson-learned softaworks Скилл lesson-learned разбирает последние изменения в git-истории и формулирует инженерные уроки на основе реального кода. Пригодится, чтобы извлечь полезный опыт из недавних коммитов или рабочей ветки. CX Codex +1 3 000установок code-review Community Команда code-review запускает ревью свежих изменений в репозитории через git-контекст. Помогает найти уязвимости, проблемы с читаемостью и пробелы в тестах перед отправкой кода. CX Codex +1 ★ 2 003звёзд репо thermos cursor Скилл thermos запускает двух ревью-субагентов параллельно в фоне и сводит их находки в один отчёт с приоритетами. CX Codex +1 2 400установок code-reviewer официальный Anthropic Субагент code-reviewer проверяет изменения в коде по правилам проекта из CLAUDE.md и ищет существенные дефекты. Запускайте перед коммитом или созданием PR. CX Codex 31 050установок role-info Nikolay Shirokov Скилл role-info парсит файл Rights.xml роли 1С и собирает компактную выжимку прав, RLS и шаблонов ограничений без лишней XML-разметки. CX Codex +1 46установок skd-decompile Nikolay Shirokov Скилл skd-decompile разбирает схему компоновки данных 1С из Template.xml в JSON-черновик для генератора skd-compile. Помогает собрать новый отчёт по готовому образцу. CX Codex +1 40установок

Из того же набора148

Весь набор →
c4-architecture Скилл c4-architecture строит диаграммы C4 по коду существующей системы или требованиям к новой. Помогает описать архитектуру на нужном уровне и подготовить исходник для Mermaid. CX Codex +1 ★ 1 627звёзд репо Code Review Readiness Субагент Code Review Readiness проверяет pull request как сдаваемый результат: упаковку, описание, доказательства проверок, чекбоксы и изменённую документацию. Запускает его оркестратор Code Review, сам по себе он не вызывается. CX Codex +1 ★ 1 627звёзд репо standards-mapping Правило standards-mapping связывает компоненты архитектуры со стандартами OWASP, NIST, CIS и облачными фреймворками при формировании планов безопасности в Claude Code. CX Codex +1 ★ 1 627звёзд репо Accessibility Surface Inventory Accessibility Surface Inventory — субагент Claude Code, который изучает маршруты, элементы и состояния интерфейса и создаёт конфиг для проверок доступности. Включается при подготовке проекта к runtime-пробам. CX Codex +1 ★ 1 627звёзд репо skill-security-model Правило skill-security-model ставит рамки для модели угроз STRIDE у скиллов. Правило проверяет скрипты, требует файл SECURITY.md и пресекает утечки внутренних путей в документацию. CX Codex +1 ★ 1 627звёзд репо Functional Planner Субагент Functional Planner разбирает PRD и готовит иерархию задач для Azure DevOps, GitHub или Jira без изменений в трекере. CX Codex +1 ★ 1 627звёзд репо ADO Backlog Executor Субагент ADO Backlog Executor исполняет готовый пакет операций с work items в Azure DevOps: создаёт, обновляет, связывает и комментирует элементы одного подтверждённого проекта. CX Codex +1 ★ 1 627звёзд репо risk-register Скилл risk-register создаёт качественный реестр рисков проекта с матрицей вероятность × последствие, назначает владельцев, описывает стратегии смягчения и планы на случай срабатывания. CX Codex +1 ★ 1 627звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой