| name | specrail-pr-gate |
| description | Use before reporting a SpecRail PR as merge-ready. Collects read-only PR evidence, runs the offline PR gate, checks linked work, current head SHA, CI, review decision, review threads, merge state, and human merge authorization without merging. |
SpecRail PR Gate
Use this skill before saying a PR is merge-ready.
Steps
- Collect current PR evidence. Prefer the read-only adapter when available:
python3 checks/github_pr_evidence.py --github-repo <owner/repo> --pr <pr-number> --json > <evidence.json>
- Run the offline gate:
python3 checks/pr_gate.py --repo . --evidence <evidence.json> --json
- Confirm evidence includes linked issue, current PR head SHA, CI/check rollup,
review decision, review-thread resolution, merge state, and human merge
authorization.
- Interpret decisions precisely:
allowed: evidence satisfies the local merge-readiness policy.
needs_human: deterministic evidence passed, but a human gate is missing.
blocked: do not merge.
- Report the evidence file path, decision, blockers, and stale or missing data.
Boundaries
- Do not merge from this skill.
- Do not treat green CI alone as merge readiness.
- Do not ignore unresolved review threads.
- Do not replace maintainer final review or human merge authorization.