zsxh1990/pr-genius

type: Knowledge Bundle
title: PR Genius — Pre-submission PR Advisor
description: Evidence-backed PR contribution advisor for large open-source projects
version: 2.1.5
created: 2026-07-01
updated: 2026-09-05
author: zsxh1990
conforms_to: OKF v0.1 (Sudhakaran88/okf-conformance) + agent_guidelines extension
---
mcp-name: io.github.zsxh1990/pr-genius
PR Genius — The advisor that knows which PRs get closed
> **753 loaded patterns across 67 repos**, plus 190 PR observations kept for pattern mining.
> (Trigger coverage — how often rules fire on real PRs — is measured separately by
> scripts/measure_pattern_coverage.py, issue #66. There is no "quality pass rate"
> claim here: it is not measurable for the current set, so it is not asserted.)
> Clone → paste MCP config → ask "Should I open this PR to encode/httpx?"
---
🎯 What is PR Genius?
PR Genius is **not** a PR dashboard. It's an **Outbound PR CRM** for professional OSS contributors and AI agents:
> Manage PRs you've *submitted to other repos* — when to fix CI, rebase, wait, ping, or abandon.
PR Genius is also a **DSH (Cordis) plugin** that slots into the DeepSeek Harness chat sidebar, advisor panel, session tab, preferences section, and /prgenius slash-command. See 🧩 DSH Plugin below.
| Capability | gh CLI | PR Genius |
|---|---|---|
| Cross-repo PR list | ✅ | ✅ |
| Status classification | ❌ | ✅ (9 states) |
| Stale detection | ❌ | ✅ |
| Action suggestions | ❌ | ✅ |
| Common OSS PR policy | ❌ | ✅ |
| Snapshot & transitions | ❌ | ✅ |
**Status heartbeat** runs daily via cron, auto-detecting:
- 🔴 NEEDS_REBASE / CI_FAILING — fix immediately
- 🟡 STALE_REVIEW — ping after threshold
- 🟡 STALE_NO_REVIEW — consider abandoning
- 🟢 CLEAN / WAITING — continue waiting
---
🛡️ Why PR Genius?
**PR Genius doesn't write PRs for you. It knows which PRs get closed.**
| Capability | LLM directly | Scraper Agent | PR Genius |
|------------|-------------|---------------|-----------|
| Knowledge source | Training data | Real-time scrape | 753 structured patterns |
| Repo understanding | Generic | Surface data (stars) | 17-field agent_guidelines |
| Failure patterns | Unknown | Unknown | 61 anti-patterns |
| Success patterns | Unknown | Unknown | 692 patterns — retrieval/reference only, not wired into scoring (issue #69) |
| Maintainer preference | Guess | Recent PRs | Structured policy files |
| Merge probability | Can't estimate | Can't estimate | Based on repo merge rate + signals |
**Real cases (PR Genius helped avoid these rejections):**
| PR | Repo | What happened | PR Genius would have flagged |
|----|------|---------------|------------------------------|
| #491 | MisakaNet | "Destructive README rewrite" — closed | breaking_change_no_compat anti-pattern |
| #47434 | huggingface/transformers | "We'll handle internally" — closed | maintainer_internal_handling anti-pattern |
| #10393 | awesome-mcp-servers | Missing Glama badge — auto-flagged | awesome-mcp-servers-glama-badge-required anti-pattern |
| #282 | punkpeye/fastmcp | +271 lines, first PR — closed without review | punkpeye-fastmcp-282-too-large anti-pattern |
| — | contribai | Issue claim without due diligence — auto-closed | contribai-issue-claim-no-due-diligence anti-pattern |
| #2902 | soxoj/maigret | CI failure (tag dev not recognized) — fixed, merged | maigret-tag-validation pattern |
| — | Ikalus1988/MisakaNet | Claimed issue without due diligence — auto-closed | contribai-issue-claim-no-due-diligence anti-pattern |
| #928 | Ikalus1988/MisakaNet | Voice hooks PR — scope creep, closed | ikalus1998-misakanet-928 lesson |
| #936 | Ikalus1988/MisakaNet | Global disable switch — incomplete impl | ikalus1998-misakanet-936 lesson |
| #938 | Ikalus1988/MisakaNet | Anti-patterns reference doc — premature PR | ikalus1998-misakanet-938 lesson |
| #965 | Ikalus1988/MisakaNet | README numbers sync — stale data | ikalus1998-misakanet-965 lesson |
| #248 | punkpeye/awesome-mcp-devtools | Listing PR — still pending, no maintainer response | punkpeye-awesome-mcp-devtools-248-pending case study |
🚀 Quick Start