pr-review
Skill2 starsChanged 3 months agoApache-2.0View on GitHub
Batch review des PRs PTK par ordre de complexité croissante (XS → S → M → L). Pour chaque PR : vérifie l'état (conflits, CLA, reviews), lit le diff complet, analyse le code en contexte, présente un résumé avec lien + taille + recommandation. Attend validation explicite avant tout merge. Poste des commentaires boldguy-adapt sur les PRs bloquées (conflit, CLA, CHANGES_REQUESTED). Args: "triage" pour lancer un triage complet avant la review. "from:<num>" pour reprendre à partir d'un numéro de PR spécifique.
195 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- IntelRealSense/librealsensetheir own version, first seen Nov 16, 2026
- wikimedia/wikipedia-iostheir own version, first seen Nov 16, 2026
- realsenseai/librealsensetheir own version, first seen Nov 16, 2026
- minio/skillstheir own version, first seen Nov 16, 2026
- lumlaolao/spike-evaltheir own version, first seen Nov 16, 2026
- AshrafDurjoy/genai-shared-patternstheir own version, first seen Nov 16, 2026
Used with
Projects with it also use clack-cli-patterns, drag-to-reorder and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
openchamberSkillclack-cli-patterns
Use when creating or modifying OpenChamber CLI commands, prompts, terminal output, non-TTY behavior, `--quiet`, or `--json` behavior.
Also in 3 projects that use this
openchamberSkilldrag-to-reorder
Use when implementing or modifying OpenChamber sortable or drag-to-reorder behavior, especially `@dnd-kit`, touch/mobile interactions, variable-width items, or wrapping layouts.
Also in 3 projects that use this
jtenniswoodSkillexpert-reset
Reimagine this repository from first principles using the current product and user experience as the target. Use when the user says "/expert-reset", asks how the project should be rebuilt if starting again, wants bold architecture or component-structure recommendations, or wants a research-only reset plan unconstrained by current implementation details.
Also in 3 projects that use this
CES-LtdSkilloss-pr
Use when creating a pull request, after committing changes, or when user invokes /oss-pr. Covers branch management, quality checks, commit, push, and PR creation.
Also in 3 projects that use this
CES-LtdSkillpr-automation
PR Automation Orchestrator: poll open PRs, check CI, run review, fix, and merge eligible PRs. Use when: (1) Invoked by daemon via scripts/pr-automation.sh, (2) User says "/pr-automation".
Also in 3 projects that use this
- +7 more from openchamber
Other versions195 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- rtk-ai/rtk★ 87k97% same
Wrote their own version · 194
- Significant-Gravitas/AutoGPT★ 188ksame name
- pytorch/pytorch★ 106ksame name
- saadeghi/daisyui★ 43ksame name
- rustfs/rustfs★ 36ksame name
- dotnet/maui★ 23ksame name
- NVIDIA/Megatron-LM★ 18ksame name
- MiniMax-AI/skills★ 14ksame name
- btriapitsyn/openchamber★ 13ksame name
- openchamber/openchamber★ 13ksame name
- LMCache/LMCache★ 12ksame name
184 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository13 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- code-simplifierSkill
- design-patternsSkill
- issue-triageSkill
- performanceSkill
- pr-triageSkill
- ptk-tddSkill
- ptk-triageSkill
- repo-recapSkill
- security-guardianSkill
- shipSkill
- tdd-rustSkill
The file
Files
/pr-review
Batch review des PRs PTK — du plus simple au plus complexe, une par une, avec validation utilisateur avant chaque merge.
Quand utiliser
- Après un
/ptk-triagepour agir sur les résultats - Régulièrement pour dégraisser le backlog
- Avant une release pour vider la file quick wins
Workflow
Phase 0 — Préconditions
git rev-parse --is-inside-work-tree
gh auth status
date +%Y-%m-%dSi l'argument triage est passé, exécuter /ptk-triage d'abord et utiliser sa liste de quick wins comme séquence. Sinon, construire la liste soi-même.
Phase 1 — Construire la liste de PRs (si pas de triage)
gh pr list --state open --limit 200 \
--json number,title,author,additions,deletions,changedFiles,mergeable,mergeStateStatus,isDraft,statusCheckRollup,reviewDecision,body \
| jq 'sort_by(.additions + .deletions)'Classement par taille :
| Taille | Critère | Traitement |
| XS | < 30 lignes, 1 fichier | En premier |
| S | 30-100 lignes, 1-3 fichiers | Ensuite |
| M | 100-200 lignes, logique non triviale | Après |
| L | > 200 lignes | Dernier ou skip |
| XL | > 500 lignes | Skip (session dédiée) |
Filtrer d'emblée :
- Exclure les PRs draft
- Exclure les PRs de nous (les nôtres ont une review flow différente)
- Si
from:<num>passé en argument : commencer à ce numéro
Phase 2 — Pour chaque PR (une par une, dans l'ordre)
Étape A — Vérification état (AVANT de lire le diff)
# 1. Etat mergeable + CLA
gh pr view <num> --json mergeable,mergeStateStatus,statusCheckRollup,reviewDecision
# 2. Reviews existantes (CHANGES_REQUESTED ?)
gh api repos/hacck3y/ptk/pulls/<num>/reviews \
--jq '.[] | {author: .user.login, state: .state, body: .body}'
# 3. Commentaires inline (si CHANGES_REQUESTED)
gh api repos/hacck3y/ptk/pulls/<num>/comments \
--jq '.[] | {author: .user.login, body: .body, path: .path, line: .line}'Décision rapide selon état :
| État | Action |
| MERGEABLE + CLA ok + pas de CHANGES_REQUESTED | → lire le diff |
| CONFLICTING | → préparer commentaire rebase, skip diff |
| CLA non signé | → préparer commentaire CLA, skip diff |
| CHANGES_REQUESTED par un maintainer | → skip (ne pas override), noter |
| Draft | → skip silencieusement |
Étape B — Lire le diff complet
gh pr diff <num>Si le diff touche une logique complexe (filter functions, regex, routing) → lire le fichier source en contexte avec Read pour comprendre l'impact réel.
Étape C — Présenter à l'utilisateur
Format de présentation obligatoire pour chaque PR :
**PR #<num>** — https://github.com/hacck3y/ptk/pull/<num>
**Author**: <login> | **Size**: <XS/S/M/L> (+<add> -<del>, <N> fichiers) | **CLA**: <ok/non signé> | **Mergeable**: <clean/conflit>
**Ce que ça fait** — [description en 2-4 phrases : le problème résolu, les fichiers touchés, la logique modifiée, les tests ajoutés]
**Qualité du diff** : [analyse honnête : propre/à vérifier/problème détecté]
Merge #<num> ?Règles de présentation :
- Toujours inclure le lien GitHub cliquable
- Toujours mentionner si des tests couvrent le changement
- Si une fonction complexe est touchée, expliquer l'impact
- Ne pas embellir — si le diff est moyen, le dire
- Langue : français pour l'analyse (comme ici)
Étape D — Attendre la validation
NE JAMAIS MERGER SANS RÉPONSE EXPLICITE. Les réponses attendues :
| Réponse | Action |
| "ok" / "go" / "merge" | Merger avec gh pr merge --merge |
| "skip" / "next" | Passer à la PR suivante sans merger |
| "comment" | Poster un commentaire (demander le texte si pas fourni) |
| "close" | Fermer la PR |
| Retour avec instructions | Appliquer puis redemander confirmation |
Étape E — Merger (si validé)
gh pr merge <num> --merge --squashConfirmer immédiatement : Merged #<num>. ✓
Puis vérifier que la PR suivante n'est pas passée en CONFLICTING à cause du merge (surtout si les deux touchent rules.rs, registry.rs, main.rs, ou CHANGELOG.md).
Phase 3 — PRs bloquées : commentaire boldguy-adapt
Pour les PRs avec conflit, CLA manquant, ou besoin de rebase, poster un commentaire en anglais, ton boldguy-adapt.
Règles du commentaire :
- Anglais uniquement (GitHub)
- Remercier la contribution en ouverture (sincèrement, pas de manière générique)
- Dire clairement ce qui bloque (1-2 points max)
- Donner les étapes exactes pour débloquer
- Pas d'em dash (
—), pas de staccato, longueurs de phrases variées - Ne pas sonner comme un bot
Template conflit + CLA :
Hey @<author>, thanks for the contribution! [mention spécifique de ce que la PR apporte]
Two things before we can merge:
1. The branch needs a rebase on `develop` — there's a conflict on [fichier]. A `git rebase origin/develop` should do it.
2. The CLA hasn't been signed yet. The CLAassistant bot left instructions in the PR — just follow the link, takes about a minute.
Once both are sorted, this will move quickly.Template conflit seul :
Hey @<author>, good fix on [description spécifique]. One thing to address before merge: the branch has a conflict on [fichier] after recent changes to develop. A `git rebase origin/develop` should resolve it cleanly.Template CLA seul :
Hey @<author>, thanks for [description spécifique]. The only thing blocking merge is the CLA signature — the CLAassistant bot left the link in the PR. Once that's done, we're good to go.Phase 4 — Récap de session
Après avoir traité toutes les PRs (ou à la demande) :
## Session recap — YYYY-MM-DD
| PR | Titre | Action | Raison |
|----|-------|--------|--------|
| #N | titre | Mergé ✓ | — |
| #N | titre | Skip | CHANGES_REQUESTED (KuSh) |
| #N | titre | Commenté | Conflit + CLA |
| #N | titre | Fermé | Doublon avec #M |
Mergées : N | Skippées : N | Commentées : NRègles
- Une PR à la fois — ne jamais présenter plusieurs PRs en attente de validation
- Jamais merger sans "ok" explicite — "ça a l'air bien" n'est pas un ok
- Ne pas overrider un CHANGES_REQUESTED d'un maintainer sans instructions explicites de l'utilisateur
- Vérifier les conflits post-merge sur la PR suivante si les deux touchent les mêmes fichiers
- Langue : analyse en français, commentaires GitHub en anglais
- Ton boldguy : factuel, direct, bienveillant, pas de marqueurs AI (em dash, staccato, punchline finale parfaite)
Fichiers fréquemment en conflit (surveiller)
CHANGELOG.md— toutes les PRs y touchentsrc/discover/rules.rs— ajouts fréquents de règlessrc/discover/registry.rs— tests de classify/rewritesrc/main.rs— routing des commandessrc/hooks/rewrite_cmd.rs— rewrites hooks
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

