Доводка PR до зелёного CI
Доводит открытый PR до зелёного: чинит упавший CI и важные замечания ревью, проверяет локально, коммитит, пушит и повторяет, а на одобрении человека или черновике останавливается. Для случаев, когда PR красный или ждёт разбора комментариев.
iterate-pr- Автор
- Sentry
- Источник
- 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 подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
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
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
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 }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_PASSEDCHECKS_DONE_WITH_FAILURESNO_CHECKS_REGISTEREDDRAFT_PR_WITH_NO_CHECKSCHECKS_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:
- read full log:
gh run view <run-id> --log-failed - trace from assertion/exception/lint rule to source
- state the cause before editing: "fails because X, affected by Y"
- search related call sites/patterns
- fix root cause, not symptom
- 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:
- run
uv run scripts/fetch_pr_checks.py - handle table in step 3
- while
actionable_pending > 0, runuv run scripts/fetch_pr_feedback.py - fix new high/medium feedback immediately
- if changed, verify, commit, push, restart loop
- otherwise sleep 30 seconds and repeat
- after checks pass, wait 10 seconds, fetch feedback once more
- 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,reviewDecisiongh pr checks --json name,state,bucket,description,linkgh run view <run-id> --log-failedgh api repos/{owner}/{repo}/pulls/{number}/comments
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel