pr-reference — скилл для Claude Code: генерация PR с дифами
Скилл pr-reference для Claude Code собирает коммиты и дифы между ветками в структурированный XML. Данные используются для описания PR, code review и анализа изменений в проекте.
MIT ★ 1 627 обновлён 2026-10-25
npx skills add microsoft/hve-core --skill pr-reference -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/pr-reference/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pr-reference/
1Через Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill pr-reference -a codex2Вручную: положить файлы
.agents/skills/pr-reference/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill pr-reference -a cursor2Вручную: положить файлы
.cursor/skills/pr-reference/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/hve-core .github/skills/shared/pr-reference2Вручную: положить файлы
.github/skills/pr-reference/SKILL.md1Через Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill pr-reference -a gemini-cli2Командой платформы
gemini skills install https://github.com/microsoft/hve-core --path .github/skills/shared/pr-referenceВручную: положить файлы
.devin/skills/pr-reference/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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