pr-blocker-summarizer

# PR Blocker Summarizer Turn a JSON export of open pull requests into a blockers-first digest: which PRs are blocked (failing checks, requested changes, or stale), which are ready to merge, and a one-line count an agent can post to standup. A bundled **example** skill — small but real, used to demonstrate the creator's validation, pipeline, and eval-rollout machinery. ## Activation Activates on "summarize open PRs", "what's blocking my PRs", "PR standup", "review backlog". Do **not** activate on general git/GitHub questions unrelated to triaging a set of PRs. ## Input A JSON array of PRs, each with `title`, `state` (`open`), `checks` (`passing`/`failing`), `review` (`approved`/`changes_requested`/`pending`), and `age_days`. Missing fields are treated conservatively (counted as not-blocked only when clearly ready). ## Run ```bash python3 scripts/run_pipeline.py --input prs.json --output digest.json ``` Output JSON shape: ```json { "total": 7, "blocked": [{"title": "...", "reasons": ["failing checks"]}], "ready": ["..."], "summary": "7 open · 3 blocked · 2 ready to merge" } ``` ## Gotchas - **`blocked` + `ready` does not equal `total`.** A PR is `ready` only when `checks` is explicitly `passing` *and* `review` is explicitly `approved`. A PR with no blockers but a missing `checks` field lands in neither list and vanishes from both counts. Never narrate the summary line as if the two numbers account for every PR — say "N blocked, M ready" and leave the remainder unclaimed. - **`state` is read from the input but never filtered on.** A closed or merged PR left in the export is counted in `total` and classified like any open one. Filter the export before running if it may contain non-open PRs. - **`review: pending` counts as blocked** ("awaiting review"). A PR opened five minutes ago is reported as a blocker. This is intentional for standup triage, but it inflates the blocked count on teams that open PRs early. - **A non-numeric `age_days` silently skips the stale check** rather than erroring. An export with `"age_days": "unknown"` will never flag anything stale, and the digest gives no sign that the check did not run. ## Anti-goals - Does not call the GitHub API; it works on an exported PR list. - Does not merge or comment on PRs; it only summarizes.