Заголовок и описание PR
Пишет или обновляет заголовок PR в формате Sentry и короткое описание для ревьюеров без шаблонных разделов и логов тестов, затем открывает черновик или правит PR. Для случаев, когда открывают PR или новые коммиты поменяли его объём.
pr-writer- Автор
- Sentry
- Источник
- getsentry/skills/skills/pr-writer @ a582c51
- Лицензия
- Apache-2.0 · Copyright 2025 Functional Software, Inc. dba Sentry
Об этом скилле
Что делает
Скилл пишет или обновляет заголовок и описание PR как короткую записку для ревьюеров: сначала что изменилось в поведении и что это затрагивает, потом, если это помогает, — зачем, риски и миграция. Он смотрит уже открытый PR, коммиты и весь дифф относительно базы, а не только последний коммит. Если вы на main или master, сначала создаёт ветку под фичу.
Заголовок — по правилу Sentry <type>(<scope>): <subject> с фиксированным списком типов; ! — только когда ломается внешний контракт, а размытые темы вроде «update» запрещены. Для описания выбирается самая простая подходящая форма: абзац для мелкой правки, первопричина для фикса, примеры «до/после» и заметки о миграции для смены контракта, подсказка, с чего начать, для широкого изменения. Диаграмма Mermaid или план выката добавляются, только если экономят ревьюеру время.
По умолчанию в описание не попадают разделы Summary и Test Plan, вставленные команды и логи CI, списки коммитов, пересказ по файлам, имена клиентов и персональные данные. Ссылки на задачи — только проверенные, шаблоны PR репозитория игнорируются. Новый PR открывается черновиком, существующий переписывается под весь дифф через gh api, без пересказа раундов ревью.
SPEC.md — контракт для мейнтейнеров; в EVAL.md и evals/ лежит регрессионный сценарий AXIS для Codex (npx @netlify/axis), рассчитанный на структуру репозитория Sentry. Для работы скилла ни то ни другое не нужно.
Когда включать и когда не надо
При открытии PR и после коммитов, которые поменяли его объём, — по спецификации скилл тогда обновляет PR и без просьбы. Нужен авторизованный gh.
Не подойдёт, если команда требует свой шаблон PR или раздел Test Plan: скилл выбрасывает и то и другое. Коммиты, release notes и починка CI — не его задачи.
Как поставить и вызвать
Команда установки ниже скачивает папку. Агент сам подхватывает скилл по описанию. Вызвать вручную:
- Claude Code:
/pr-writerили попросить скилл по имени. - Codex:
$pr-writer. - Cursor: наберите
/в чате Agent и выберитеpr-writer.
Пример: /pr-writer Обнови заголовок и описание PR 812 после сегодняшних коммитов.
Чем отличается от похожих
Описание PR из нашего каталога заполняет шаблон репозитория или свои разделы «зачем», «что меняется», «как проверено», «риски», а PR открывает только по просьбе. pr-writer держится прозы, логи тестов выкидывает и сам открывает черновик. Коммиты в формате Conventional Commits из того же набора использует тот же список типов, так что заголовки PR и коммиты совпадают по стилю.
Установка
Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
curl -fsSL --create-dirs -o ~/.claude/skills/pr-writer/SKILL.md https://anymodel.org/en/skills/sentry/pr-writer/SKILL.md -o ~/.claude/skills/pr-writer/EVAL.md https://anymodel.org/en/skills/sentry/pr-writer/EVAL.md -o ~/.claude/skills/pr-writer/LICENSE https://anymodel.org/en/skills/sentry/pr-writer/LICENSE -o ~/.claude/skills/pr-writer/SPEC.md https://anymodel.org/en/skills/sentry/pr-writer/SPEC.md -o ~/.claude/skills/pr-writer/evals/axis.config.json https://anymodel.org/en/skills/sentry/pr-writer/evals/axis.config.json -o ~/.claude/skills/pr-writer/evals/scenarios/concise-docs-pr.json https://anymodel.org/en/skills/sentry/pr-writer/evals/scenarios/concise-docs-pr.json
curl -fsSL --create-dirs -o ~/.agents/skills/pr-writer/SKILL.md https://anymodel.org/en/skills/sentry/pr-writer/SKILL.md -o ~/.agents/skills/pr-writer/EVAL.md https://anymodel.org/en/skills/sentry/pr-writer/EVAL.md -o ~/.agents/skills/pr-writer/LICENSE https://anymodel.org/en/skills/sentry/pr-writer/LICENSE -o ~/.agents/skills/pr-writer/SPEC.md https://anymodel.org/en/skills/sentry/pr-writer/SPEC.md -o ~/.agents/skills/pr-writer/evals/axis.config.json https://anymodel.org/en/skills/sentry/pr-writer/evals/axis.config.json -o ~/.agents/skills/pr-writer/evals/scenarios/concise-docs-pr.json https://anymodel.org/en/skills/sentry/pr-writer/evals/scenarios/concise-docs-pr.json
foreach ($f in 'SKILL.md','EVAL.md','LICENSE','SPEC.md','evals/axis.config.json','evals/scenarios/concise-docs-pr.json') { $p = Join-Path "$HOME\.claude\skills\pr-writer" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/sentry/pr-writer/$f" -UseBasicParsing -OutFile $p }foreach ($f in 'SKILL.md','EVAL.md','LICENSE','SPEC.md','evals/axis.config.json','evals/scenarios/concise-docs-pr.json') { $p = Join-Path "$HOME\.agents\skills\pr-writer" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/sentry/pr-writer/$f" -UseBasicParsing -OutFile $p }Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/sentry/pr-writer/SKILL.md
SKILL.md
PR Writer
Write the PR body as a cover note for reviewers, not a changelog, template, validation log, or file-by-file summary.
Inspect the Change
Requires authenticated gh. Inspect the current branch, working tree, PR,
base branch, commits, and full diff:
git branch --show-current
git status --porcelain
gh pr view --json number,title,body,url,baseRefName,headRefName
gh repo view --json defaultBranchRef
If gh pr view reports that no PR exists, continue with first-time PR
creation. For an existing PR, use its baseRefName; otherwise use the
repository default branch. Set BASE, then inspect:
git log "$BASE"..HEAD --oneline
git diff "$BASE"...HEAD
If on main or master, create a feature branch first. Ensure intended
changes are committed and review the whole branch diff, not only the latest
commit or existing PR text.
Core Rules
- Describe concrete changed behavior, affected surfaces, and reviewer impact before implementation detail.
- Explain motivation, risk, tradeoffs, migration, or review focus only when useful.
- Use the smallest structure that makes the change easier to review.
- Replace internal prompt or process terminology with specific behavior.
- When refreshing a PR, rewrite around the current full diff without narrating review history.
Titles
Use <type>(<scope>): <subject> or <type>: <subject>.
Allowed types: feat, fix, ref, perf, docs, test, build,
ci, chore, style, meta, license, and revert.
- Describe the dominant full-branch change with the narrowest accurate type and scope.
- Use
!only when the change breaks an external contract, and explain the affected surface in the body. - Avoid vague subjects such as
update,cleanup,misc,fix stuff, oraddress feedback. Do not add a trailing period. - Keep an existing title only when it still describes the whole diff.
Body Shape
Choose the minimum useful shape:
| Change | Include |
|---|---|
| Small or obvious | One concise paragraph without headings. |
| Feature, bug fix, or refactor | Changed behavior and effect; add root cause, unchanged behavior, or non-obvious approach when relevant. |
| Contract or breaking change | Affected API, schema, payload, config, permission, storage, or CLI surface; include compatibility and migration guidance. |
| Operational, visual, or workflow change | User/operator effect, measured impact, failure modes, or flow when useful. |
| Broad, generated, or cross-cutting change | Organizing principle, why the breadth is necessary, and where review should start. |
Default:
<What changed and what effect it has.>
<Why the approach, risk, migration, or review focus matters, if not obvious.>
For review-feedback updates, describe the resulting PR as a whole rather than the sequence of revisions.
Reviewer Aids
Use an aid only when it reduces reviewer reconstruction work:
- A compact before/after or interface example for changed contracts.
- A small Mermaid diagram for async flows or state transitions.
- A screenshot or recording note when visual evidence exists.
- A rollout, compatibility, risk, or review-order note when reviewers or adopters need it.
Introduce an artifact with one sentence explaining what reviewers should notice. Omit it when prose is clearer.
Boundaries
- Do not add default
Summary,Changes, orTest Plansections. - Omit routine validation unless it changes risk assessment or explains meaningful regression coverage. For docs, skills, copy, or config changes, omit it by default.
- Do not paste commands, CI logs, validation dumps, commit logs, placeholders, or exhaustive file lists.
- Never include customer or organization names, user emails, support ticket contents, secrets, or PII.
- Use issue references only when verified from user input, branch names,
commits, PR discussion, or tracker output.
Fixes <issue>closes;Refs <issue>only links.
Create or Update
Create new PRs as drafts. Write the body to a temporary Markdown file, then run:
gh pr create --draft --title '<title>' --body-file /tmp/pr-body.md
Update existing PRs with gh api:
gh api -X PATCH repos/{owner}/{repo}/pulls/PR_NUMBER \
-f title='<title>' \
-F body=@/tmp/pr-body.md
Refresh the title and body when follow-up commits materially change scope, approach, breaking behavior, risk, migration, or review expectations. Skip typo-only, formatting-only, and rename-only follow-ups.
Examples
Small change:
The AI Customizations section now starts collapsed so it does not consume
sidebar space before users need it. Expanding it preserves the existing saved
preference behavior.
Breaking contract:
Run logs now emit chunk-level records instead of one skill-level record.
Consumers that read top-level `findings` must iterate over
`chunk.findings` for each record.
Before:
```json
{"skill": "security-review", "findings": [...]}
```
After:
```json
{"schemaVersion": 1, "chunk": {"index": 1, "findings": [...]}}
```
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel