PR Status Triage
Use this skill when the user asks about PR status, CI failures, or review comments in the Next.js monorepo.
Workflow
Start by fetching data to answer the user's query:
- For a targeted question about specific review comments, run
node scripts/pr-status.js [PR] --comments-only. This skips all Actions run, job, log, and flaky-test requests. - For CI status or general triage, run
node scripts/pr-status.js [PR](no--wait) to snapshot the current state, then start triaging immediately from the jobs that have already finished. Re-fetch on demand as more results land instead of waiting for the whole workflow to complete. - Use
--waitonly when the final run state itself is what you need: confirming an all-green run before handing back, or picking up results after retriggering failed jobs.
Then:
- Read
scripts/pr-status/results/index.md. - For a targeted review question, inspect the relevant
thread-{N}.md,review-{id}.md, orcomment-{id}.mdfiles. For full triage, also analyze eachjob-{id}.mdand review file for failures and feedback. - Prioritize blocking jobs first: build, lint, types, then test jobs.
- Treat failures as real until disproven; check the "Known Flaky Tests" section before calling anything flaky.
- Reproduce test failures locally with the same mode and environment as CI (e.g. dev or start, webpack or turbopack).
- After addressing review comments, reply to the thread describing what was done, then resolve it. Use
reply-and-resolve-threadto do both in one step, or usereply-thread+resolve-threadseparately. Seescripts/pr-status/results/thread-N.mdfiles for ready-to-use commands. - When the only remaining failures are known flaky tests and no code changes are needed, retrigger the failing CI jobs with
gh run rerun <run-id> --failed. Then re-run the analysis with--waitto pick up the rerun results and go back to step 1. Repeat this loop up to 5 times. - Start fixing as results come in; do not wait for the whole workflow before beginning on failures that have already reported. A push, on the other hand, should wait for the workflow to complete.
CI Analysis Tips
- Prioritize CI failures over review comments.
- Prioritize blocking jobs first: build, lint, types, then test jobs.
- Common fast checks:
rust check / build→ Runcargo fmt -- --check, thencargo fmtlint / build→ Runpnpm prettier --write <file>for prettier errors- test failures → Run the specific failing test path locally
Run tests in the mode (e.g.):
# Development mode with Turbopack
pnpm test-dev-turbo test/path/to/test.ts
# Production build and start with Webpack
pnpm test-start-webpack test/path/to/test.tsQuick Commands
node scripts/pr-status.js # current branch PR
node scripts/pr-status.js <number> # specific PR
node scripts/pr-status.js [PR] --wait # waits for the run to finish, then re-analyzes (final confirmation or after reruns)
node scripts/pr-status.js [PR] --comments-only # reviews/comments only; skips CI jobs
node scripts/pr-status.js --skip-flaky-check # skip flaky test detectionThread interaction:
node scripts/pr-status.js reply-thread <threadNodeId> "<body>" # reply to a review thread
node scripts/pr-status.js resolve-thread <threadNodeId> # resolve a review thread
node scripts/pr-status.js reply-and-resolve-thread <threadNodeId> "<body>" # reply and resolve in one stepReferences
- workflow.md — prioritization, common failure patterns, resolving review threads
- local-repro.md — mode/env matching and isolation guidance