fix-ready-prs
GitHub自动巡检非草稿PR,修复CI失败及Cursor Bugbot未解决评论。通过GitHub CLI和GraphQL收集状态,在现有分支直接修复问题,保持PR活跃状态。
Trigger Scenarios
Install
npx skills add fastrepl/anarlog --skill fix-ready-prs -g -y
SKILL.md
Frontmatter
{
"name": "fix-ready-prs",
"metadata": {
"internal": true
},
"description": "Inspect every open non-draft PR for CI failures and unresolved Cursor Bugbot findings, then fix them on the existing PR branches. Use when asked to check active PRs, triage ready PRs, fix CI, or address Bugbot comments."
}
Fix Ready PRs
Work through every open, non-draft pull request. Fix CI failures and unresolved Bugbot findings on the existing PR branch. Do not open a new PR for an existing one.
Drafts are out of scope unless the user names them.
1. Inventory
gh pr list --state open --limit 200 \
--json number,title,isDraft,headRefName,headRepositoryOwner,isCrossRepository,url,mergeStateStatus
Keep only isDraft == false. Record number, branch, URL, and whether the head
is a fork (isCrossRepository).
2. Collect failures
For each ready PR, gather current-head CI and unresolved Bugbot threads. Do not treat an in-progress check as green.
CI
gh pr checks <n>
gh pr view <n> --json statusCheckRollup,headRefOid
Treat as a failure when a required or repo workflow check is FAILURE,
TIMED_OUT, ACTION_REQUIRED, or CANCELLED on the current head and has not
been superseded by a newer run.
Ignore:
SKIPPED/NEUTRAL- Netlify header/pages/redirect checks and canceled deploy previews
- Mintlify Deployment skips
- macOS/Windows/iOS jobs that this repo skips on pull requests
If a failing job has logs, pull them:
gh run view <run-id> --log-failed
If checks are still IN_PROGRESS / pending, wait until they finish or fail
before declaring the PR clean. Re-poll rather than guessing.
Bugbot
Use review threads, not only the Bugbot check conclusion. A green Bugbot check can still leave unresolved comments, and an older finding may already be fixed.
GitHub returns reviewThreads oldest-first with no unresolved-only filter.
Page until hasNextPage is false. Do not stop at the first 50 threads.
after=""
while :; do
if [ -n "$after" ]; then
page=$(gh api graphql -f query="$THREADS_QUERY" -F n=<n> -F after="$after")
else
page=$(gh api graphql -f query="$THREADS_QUERY" -F n=<n>)
fi
echo "$page" | jq '.data.repository.pullRequest.reviewThreads.nodes[]'
has_next=$(echo "$page" | jq -r '.data.repository.pullRequest.reviewThreads.pageInfo.hasNextPage')
after=$(echo "$page" | jq -r '.data.repository.pullRequest.reviewThreads.pageInfo.endCursor')
[ "$has_next" = true ] || break
done
$THREADS_QUERY is:
query($n: Int!, $after: String) {
repository(owner: "fastrepl", name: "anarlog") {
pullRequest(number: $n) {
reviewThreads(first: 50, after: $after) {
pageInfo { hasNextPage endCursor }
nodes {
isResolved
isOutdated
comments(first: 5) {
nodes { author { login } path line body }
}
}
}
}
}
}
Fix a thread when:
- the author is
cursor/cursor[bot] isResolvedis false- the comment is a Bugbot finding (
<!-- BUGBOT_BUG_ID:or a severity heading) - it still applies to the current head (
isOutdatedis false, or outdated but the same bug is still in the code)
Skip resolved threads and outdated findings whose code already changed.
Also paginate review comments in case Bugbot posted one that is not yet a thread:
gh api --paginate repos/fastrepl/anarlog/pulls/<n>/comments
gh pr view <n> --comments
3. Fix on the PR branch
For each PR that has work, check out that PR's head, including fork heads:
gh pr checkout <n>
Do not git fetch origin <headRefName> or git push origin <headRefName>.
Fork PRs keep the branch on the contributor remote; origin/<headRefName> is
missing or is a different branch. Pushing to origin can create a stray
branch that is not the PR head.
Then:
- Reproduce from the failing log or Bugbot location
- Make the smallest change that fixes the failure or finding
- Run the locally available checks from the CI workflows that the changed
paths trigger (
AGENTS.mdpre-commit verification) - Commit on that branch (do not amend someone else's commit)
git push(uses the tracking remote fromgh pr checkout)
If gh pr checkout or git push cannot update a fork, stop and report that.
Do not open a replacement PR on origin.
Do not bundle unrelated PR fixes onto one branch. Do not retarget or close PRs.
If a finding is a false positive, leave it. Do not resolve GitHub review threads unless the user asked; the code change is the fix.
4. Recheck
After pushing, re-run the inventory for that PR. Confirm:
- new CI is running or green
- the previous failure is gone or replaced by a new run
- the Bugbot thread is outdated or will be re-reviewed on the new commit
If a new failure or finding appears, fix it too.
5. Report
Summarize every ready PR:
- clean (CI green, no unresolved Bugbot)
- waiting (checks still running)
- fixed (what changed, PR number)
- skipped draft
Do not merge.
Version History
- 2d4c6b1 Current 2026-08-20 17:12


