codex-pr-body

Официальный skill Codex для подготовки содержимого одного или нескольких pull request. Он нужен, когда требуется привести заголовок и описание PR в соответствие с фактическим изменением ветки или набора коммитов. Skill не предлагает универсальный шаблон без контекста: сначала нужно понять, какой PR относится к текущей работе, а затем редактировать именно его. Если номер pull request передан явно, используется он. В обычном Git-сценарии связь с PR определяется по текущей ветке или коммиту: для этого может понадобиться посмотреть ветку через git и получить номер PR командой gh pr view с указанием ветки и репозитория. Для stacked pull requests важно учитывать не отдельный коммит, а итоговое изменение всей последовательности. Если проект использует Sapling, связь текущей ревизии с GitHub PR можно проверить средствами Sapling, например через шаблон github_pull_request_url. Перед переписыванием нужно прочитать существующее описание PR и сохранить важный контекст. В частности, нельзя удалять изображения из текущего body: у автора может не быть другого способа восстановить их. Новое описание должно объяснять, почему изменение делается, а затем — что именно изменилось. В мотивации следует использовать обсуждение текущего разговора, если оно содержит причину работы. Это помогает отделить цель изменения от механического перечня файлов и делает описание полезным для ревью. В описание следует включать только net change коммита или стека. Попытки, которые позже были отменены, не должны подаваться как часть результата, если они больше не относятся к текущему состоянию. Текст не должен ссылаться на абсолютные пути локального диска; пути внутри репозитория достаточно указывать относительно корня. Также нельзя добавлять конфиденциальные сведения, внутренние кодовые имена или закрытые URL. Если релевантны связанные pull request или issue, их следует указать, но нет необходимости ссылаться на сам PR из его собственного body. Профессиональное Markdown-оформление здесь является частью результата: названия файлов, команд и других code things выделяются одиночными обратными кавычками, а для фрагментов команд можно использовать fenced code block. Если у изменения есть важные места в коде, полезны GitHub permalink-ссылки. В конце можно добавить краткий план проверки и упоминание документации для developers.openai.com только тогда, когда текущая работа действительно требует её обновления; пустой раздел о документации добавлять не нужно. Ограничение skill — он обновляет title и body уже выбранного pull request, но не определяет за пользователя смысл изменения. Поэтому перед редактированием необходимо проверить текущий body, ветку или ревизию и границы стека. Результат считается корректным, если сохранены важные элементы исходного описания, отдельно объяснены причина и итог, отражено только фактическое net change, исключены локальные секреты и пути, а проверка соответствует намеренно добавленному поведению.