Заголовок и описание PR

Пишет или обновляет заголовок PR в формате Sentry и короткое описание для ревьюеров без шаблонных разделов и логов тестов, затем открывает черновик или правит PR. Для случаев, когда открывают PR или новые коммиты поменяли его объём.

Git и PRПак: Скиллы Sentry160 строкpr-writer
Автор
Источник
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 подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
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
Codex, Cursor — macOS, Linux
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
Claude Code — Windows PowerShell
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 }
Codex, Cursor — Windows PowerShell
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, or address 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, or Test Plan sections.
  • 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 и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Sentry

AGENTS.md и CLAUDE.md для проекта

Делает короткий AGENTS.md до 60 строк: команды, соглашения и ссылки на документы репозитория, с проверкой путей, а CLAUDE.md превращает в ссылку на него. Для случаев, когда агенту нужны инструкции по проекту или старый файл разросся и устарел.

Аудит настроек Claude Code

Делает список разрешений для settings.json в Claude Code: по стеку репозитория подбирает только читающие команды нужных инструментов, домены документации и MCP Sentry или Linear. Для случаев, когда настраиваете или проверяете разрешения Claude Code.

Код-ревью по практикам Sentry

Делает ревью изменения по правилам Sentry: ошибки выполнения, производительность и N+1, побочные эффекты, совместимость, безопасность, архитектура и тесты, с вежливым тоном и одобрением при мелочах. Для случаев, когда нужно отревьюить PR или ветку.

Упрощение и выравнивание кода

Делает недавно изменённый код проще, не меняя поведения: меньше вложенности, без вложенных тернарников, понятные имена, без лишних абстракций, по соглашениям из CLAUDE.md. Для случаев, когда код работает, но читается тяжелее, чем нужно.

Коммиты в формате Conventional Commits

Делает коммиты в стиле Sentry по Conventional Commits: ветка вместо main, тема с типом до 70 символов с заглавной буквы, подвал Fixes или Refs, без персональных данных. Для случаев, когда нужно закоммитить или составить сообщение коммита.

Ревью доступа в Django

Делает ревью контроля доступа в Django и DRF: разбирает модель авторизации, прослеживает каждый эндпоинт от ID до запроса и сообщает только подтверждённые дыры с исправлением в коде. Для случаев, когда проверяете IDOR, права или изоляцию тенантов.

Поиск багов в изменениях ветки

Проверяет коммиты текущей ветки на дыры в безопасности, баги и проблемы качества по чек-листу из одиннадцати пунктов и выдаёт подтверждённые находки с файлом, строкой, уровнем и исправлением, не трогая код. Для случаев, когда нужен проход перед PR.

Ревью безопасности GitHub Actions

Ищет в воркфлоу GitHub Actions атаки, доступные постороннему без прав на запись: pwn request, инъекции через выражения, команды из комментариев, кражу токенов, подмену конфигов агентов. Для случаев, когда проверяют безопасность CI или меняют воркфлоу.

Доводка PR до зелёного CI

Доводит открытый PR до зелёного: чинит упавший CI и важные замечания ревью, проверяет локально, коммитит, пушит и повторяет, а на одобрении человека или черновике останавливается. Для случаев, когда PR красный или ждёт разбора комментариев.

Оптимизация промптов

Пишет, чинит или переносит системные промпты и промпты агентов по небольшому набору тестов: сравнивает варианты на одних случаях и проверяет лучший на отложенных. Для случаев, когда промпт ненадёжен, переезжает на другую модель или ему нужны тесты.

Утечки секретов через сериализацию

Находит секреты, которые утекают, когда секретное поле в dataclass, модели pydantic или объекте JS встречает код, пишущий объекты целиком в логи или спаны; вторую половину ищет по всему репозиторию. Для случаев, когда изменение добавляет такое поле или код.

SECURITY_MODEL.md для инструментов ревью

Делает SECURITY_MODEL.md: описывает для инструментов ревью безопасности доступность системы, инварианты, классы находок и подтверждённые владельцем исключения. Для случаев, когда репозиторий готовят к автоматическому ревью безопасности.

Проверка скиллов на угрозы

Проверяет скилл до установки: статический скан на промпт-инъекции, скрытые символы, секреты, опасные скрипты и ловушки в структуре, затем разбор намерений и прав с вердиктом. Для случаев, когда скилл взят из чужого источника.

Скиллы по спецификации Agent Skills

Пишет и дорабатывает скиллы по процессу Sentry: источники с происхождением, самая простая форма исполнения, SPEC.md и SOURCES.md, проверка точности после правок и структурный валидатор. Для случаев, когда скилл будет поддерживать команда.

Ревью безопасности от Sentry

Ищет в файле, диффе или компоненте эксплуатируемые уязвимости по справочникам OWASP, изучает кодовую базу до вывода и сообщает только о находках с входом от атакующего. Для случаев, когда нужно ревью безопасности без шума.

Ревью производительности Django

Ищет в коде на Django и DRF N+1-запросы, неограниченные querysets, недостающие индексы и запись в цикле, проверяя объём таблиц и горячие пути. Для случаев, когда тормозит view или эндпоинт либо правка касается больших таблиц.