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

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

Git и PRПак: Скиллы Sentry145 строкiterate-pr
Автор
Источник
getsentry/skills/skills/iterate-pr @ a582c51
Лицензия
Apache-2.0 · Copyright 2025 Functional Software, Inc. dba Sentry

Об этом скилле

Что делает

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

С GitHub через gh работают четыре скрипта на Python, запуск через uv run:

  • fetch_pr_checks.py — проверки в JSON с фрагментами логов и счётчиками упавших, ожидающих и ждущих человека.
  • fetch_pr_feedback.py — комментарии по уровням high, medium, low плюс боты и решённые: сначала по меткам LOGAF из практики Sentry (h:, m:, l:), потом по формулировкам; без метки — средний. Замечания ботов-ревьюеров вроде Bugbot или CodeQL разбираются наравне с людскими, а Codecov и Dependabot пропускаются.
  • monitor_pr_checks.py — опрос раз в 30 секунд и один итоговый маркер, например ALL_CHECKS_PASSED; Claude Code может держать его в фоне через Monitor.
  • reply_to_thread.py — ответы в треды ревью одним запросом GraphQL.

Какие мелкие предложения брать, решаете вы. Ошибка, пережившая две попытки, возвращается к вам; нет PR, нет проверок или нужен ребейз — работа заканчивается. В SPEC.md — контракт для мейнтейнеров, в agents/openai.yaml — название и промпт по умолчанию для Codex.

Когда включать и когда не надо

Когда PR красный или зарос комментариями ревью и агент должен разобрать всё без присмотра.

Скилл сам коммитит и пушит в ветку PR, так что на общей ветке сначала договоритесь. PR не открывает, не мержит, не ребейзит и черновик в готовый не переводит, если не попросить. Нужны авторизованный gh, uv и корень репозитория как рабочая папка.

Как поставить и вызвать

Команда установки ниже скачивает папку вместе со скриптами. Агент сам подхватывает скилл по описанию. Вызвать вручную:

  • Claude Code: /iterate-pr или попросить скилл по имени.
  • Codex: $iterate-pr.
  • Cursor: наберите / в чате Agent и выберите iterate-pr.

Пример: /iterate-pr В PR 1042 падают линт и два теста — почини и разбери комментарии ревью.

Чем отличается от похожих

Починка упавших проверок GitHub Actions из набора OpenAI пересказывает логи и правит код только после одобренного плана; iterate-pr сам чинит, пушит и повторяет, а заодно разбирает комментарии. Разбор комментариев к PR на GitHub правит те комментарии, что вы выбрали. Ответы на комментарии ревью из нашего каталога сверяет каждое замечание с кодом и готовит ответы, но за CI не следит.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

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

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/iterate-pr/SKILL.md https://anymodel.org/en/skills/sentry/iterate-pr/SKILL.md -o ~/.claude/skills/iterate-pr/LICENSE https://anymodel.org/en/skills/sentry/iterate-pr/LICENSE -o ~/.claude/skills/iterate-pr/SPEC.md https://anymodel.org/en/skills/sentry/iterate-pr/SPEC.md -o ~/.claude/skills/iterate-pr/agents/openai.yaml https://anymodel.org/en/skills/sentry/iterate-pr/agents/openai.yaml -o ~/.claude/skills/iterate-pr/scripts/fetch_pr_checks.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/fetch_pr_checks.py -o ~/.claude/skills/iterate-pr/scripts/fetch_pr_feedback.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/fetch_pr_feedback.py -o ~/.claude/skills/iterate-pr/scripts/monitor_pr_checks.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/monitor_pr_checks.py -o ~/.claude/skills/iterate-pr/scripts/reply_to_thread.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/reply_to_thread.py && chmod +x ~/.claude/skills/iterate-pr/scripts/fetch_pr_checks.py ~/.claude/skills/iterate-pr/scripts/fetch_pr_feedback.py
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/iterate-pr/SKILL.md https://anymodel.org/en/skills/sentry/iterate-pr/SKILL.md -o ~/.agents/skills/iterate-pr/LICENSE https://anymodel.org/en/skills/sentry/iterate-pr/LICENSE -o ~/.agents/skills/iterate-pr/SPEC.md https://anymodel.org/en/skills/sentry/iterate-pr/SPEC.md -o ~/.agents/skills/iterate-pr/agents/openai.yaml https://anymodel.org/en/skills/sentry/iterate-pr/agents/openai.yaml -o ~/.agents/skills/iterate-pr/scripts/fetch_pr_checks.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/fetch_pr_checks.py -o ~/.agents/skills/iterate-pr/scripts/fetch_pr_feedback.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/fetch_pr_feedback.py -o ~/.agents/skills/iterate-pr/scripts/monitor_pr_checks.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/monitor_pr_checks.py -o ~/.agents/skills/iterate-pr/scripts/reply_to_thread.py https://anymodel.org/en/skills/sentry/iterate-pr/scripts/reply_to_thread.py && chmod +x ~/.agents/skills/iterate-pr/scripts/fetch_pr_checks.py ~/.agents/skills/iterate-pr/scripts/fetch_pr_feedback.py
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','SPEC.md','agents/openai.yaml','scripts/fetch_pr_checks.py','scripts/fetch_pr_feedback.py','scripts/monitor_pr_checks.py','scripts/reply_to_thread.py') { $p = Join-Path "$HOME\.claude\skills\iterate-pr" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/sentry/iterate-pr/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','SPEC.md','agents/openai.yaml','scripts/fetch_pr_checks.py','scripts/fetch_pr_feedback.py','scripts/monitor_pr_checks.py','scripts/reply_to_thread.py') { $p = Join-Path "$HOME\.agents\skills\iterate-pr" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/sentry/iterate-pr/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/sentry/iterate-pr/SKILL.md

SKILL.md

Исходник

Iterate on PR Until CI Passes

Goal: fix actionable CI failures and high/medium review feedback. Stop and report human approval, draft-readiness, and merge-readiness gates.

Requires:

  • authenticated gh
  • uv
  • target repository root as cwd
  • skill-root-relative script paths, for example scripts/fetch_pr_checks.py

Bundled Scripts

Script Run Output
scripts/fetch_pr_checks.py uv run scripts/fetch_pr_checks.py [--pr NUMBER] JSON: pr, summary, checks, failure snippets
scripts/fetch_pr_feedback.py uv run scripts/fetch_pr_feedback.py [--pr NUMBER] JSON buckets: high, medium, low, bot, resolved
scripts/monitor_pr_checks.py uv run scripts/monitor_pr_checks.py [--pr NUMBER] terminal marker plus tab-separated checks
scripts/reply_to_thread.py uv run scripts/reply_to_thread.py THREAD_ID BODY [...] JSON reply results

Check summary fields include failed, pending, actionable_pending, and human_gate_pending.

Monitor markers:

  • ALL_CHECKS_PASSED
  • CHECKS_DONE_WITH_FAILURES
  • NO_CHECKS_REGISTERED
  • DRAFT_PR_WITH_NO_CHECKS
  • CHECKS_BLOCKED_BY_REVIEW_GATE

Workflow

1. Identify PR

Run:

gh pr view --json number,url,headRefName,isDraft,reviewDecision

Stop when:

  • no PR exists
  • draft PR has no checks after monitor grace period: report DRAFT_PR_WITH_NO_CHECKS

Draft rule: inspect existing checks/feedback only. Do not mark ready for review unless asked.

2. Handle Feedback

Run uv run scripts/fetch_pr_feedback.py [--pr NUMBER].

Bucket Action
high fix
medium fix
low ask user which to address
bot skip informational comments
resolved skip

Feedback fix checklist:

  • verify root cause
  • search related code
  • fix all instances
  • for review_bot: true: fix real issues, explain false positives

Low-priority prompt format:

Found 3 low-priority suggestions:
1. [l] "Consider renaming this variable" - @reviewer in api.py:42
2. [nit] "Could use a list comprehension" - @reviewer in utils.py:18
3. [style] "Add a docstring" - @reviewer in models.py:55

Which should I address? ("1,3", "all", or "none")

3. Check CI Status

Run uv run scripts/fetch_pr_checks.py [--pr NUMBER].

State Action
failed > 0 and actionable_pending == 0 fix failures
actionable_pending > 0 wait; poll feedback while waiting
pending > 0 and actionable_pending == 0 report CHECKS_BLOCKED_BY_REVIEW_GATE
no checks after grace period report NO_CHECKS_REGISTERED or DRAFT_PR_WITH_NO_CHECKS
all actionable checks passed run post-CI feedback check

Wait for actionable review bots: sentry, warden, cursor, bugbot, seer, codeql. Do not wait for approval, isDraft, REVIEW_REQUIRED, Codecov, or informational bots.

4. Fix CI Failures

For each failure:

  1. read full log: gh run view <run-id> --log-failed
  2. trace from assertion/exception/lint rule to source
  3. state the cause before editing: "fails because X, affected by Y"
  4. search related call sites/patterns
  5. fix root cause, not symptom
  6. add focused test coverage when needed

5. Verify Locally, Then Commit and Push

Before commit:

  • test fix: rerun specific test
  • lint/type fix: rerun affected checker
  • code fix: rerun covering tests
  • local failure: fix before pushing
git add <files>
git commit -m "fix: <descriptive message>"
git push

6. Monitor CI and Address Feedback

Loop:

  1. run uv run scripts/fetch_pr_checks.py
  2. handle table in step 3
  3. while actionable_pending > 0, run uv run scripts/fetch_pr_feedback.py
  4. fix new high/medium feedback immediately
  5. if changed, verify, commit, push, restart loop
  6. otherwise sleep 30 seconds and repeat
  7. after checks pass, wait 10 seconds, fetch feedback once more
  8. if new high/medium feedback exists, return to step 4

Claude Code optional: run uv run scripts/monitor_pr_checks.py through MonitorTool with persistent: false; set timeout to normal repo CI duration. Restart the monitor after every push.

Exit Conditions

Exit Conditions
Success actionable CI passed; post-CI feedback clean; low-priority choice handled
Ask user same failure after 2 attempts; feedback unclear; infrastructure issue
Stop no PR; branch needs rebase; no checks; draft no-checks; only human gates remain

Fallback

If scripts fail, use gh CLI directly:

  • gh pr view --json number,url,headRefName,isDraft,reviewDecision
  • gh pr checks --json name,state,bucket,description,link
  • gh run view <run-id> --log-failed
  • gh api repos/{owner}/{repo}/pulls/{number}/comments

Подключить через 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

Пишет или обновляет заголовок PR в формате Sentry и короткое описание для ревьюеров без шаблонных разделов и логов тестов, затем открывает черновик или правит PR. Для случаев, когда открывают 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 или эндпоинт либо правка касается больших таблиц.