name	triage-prs
description	Triage duplicate/stale PRs — cluster by topic, compare, keep best, close rest
disable-model-invocation	true
user-invocable	true
argument-hint	[optional: PR number range or 'all']

Triage PRs

Triage open PRs. Focus: $ARGUMENTS

Steps

List all open PRs with freshness and branch metadata: gh pr list --state open --json number,title,headRefName,mergeable,updatedAt --limit 100
Scope the candidate set before clustering:
- If $ARGUMENTS is empty or all, keep the full list.
- If $ARGUMENTS is a numeric range like 1200-1210, filter the fetched PRs to that inclusive range before any clustering or closing.
- If $ARGUMENTS cannot be parsed into a safe range, stop and report the invalid input instead of guessing.
Build preliminary clusters by topic from title/head branch naming only. Do not assume "same files" from the list output alone.
For each possible duplicate cluster, fetch file-level detail before deciding: gh pr view <num> --json body,files,updatedAt,mergeable,reviewDecision,headRefName

Launch parallel explore agents only after file overlap is confirmed:

Agent(subagent_type: "Explore", prompt: "Compare PRs #X, #Y, #Z.
Run: gh pr diff <num> --stat && gh pr view <num> --json body,files,updatedAt,additions,deletions
Return: which is most complete, which has unique good ideas, which to keep, and whether file overlap is real")

For each confirmed cluster, pick the best PR using:
- changed-file overlap
- recency (updatedAt)
- review/merge state
- implementation completeness
Treat a PR as stale only when it is both older and superseded by a newer PR in the same confirmed file/topic cluster. Do not close PRs based on age alone.
Close duplicates only after explicit comparison. Never close PRs outside the scoped $ARGUMENTS set: gh pr close <num> --comment "Closing — keeping #<best>"
If the winner needs improvements from closed PRs, spawn a worktree agent to incorporate them first.
Report: how many clusters found, how many closed, which PRs remain blocked, and which PRs are ready to merge.

Más de este repositorio

mismo repositorio

coding-standards

EffortlessMetrics/perl-lsp

Load perl-lsp coding standards for code-writing or code-review work in this repo. Use when implementing, fixing, reviewing, or validating code.

2026-03-2023

merge-queue

EffortlessMetrics/perl-lsp

Merge approved PRs in safe batches — checks CI, fixes policy failures, handles conflicts, ratchets corpus after parser merges.

2026-03-2023

parser-fix

EffortlessMetrics/perl-lsp

Run a TDD parser-fix workflow for perl-parser-core or related parser crates. Use when a parser bug has a concrete failing construct and needs tests, a minimal fix, and verification.

2026-03-2023

plan-fix

EffortlessMetrics/perl-lsp

Turn a discovery into a builder-ready handoff packet. Use when a scout or coordinator has identified a concrete slice and needs exact scope, verification, and routing rather than code changes.

2026-03-2023

scout-then-build

EffortlessMetrics/perl-lsp

Research-first workflow that scouts exact scope before launching a constrained builder. Use when a feature or fix is too unconstrained for a direct builder — converts ~50% success into ~90% by eliminating implicit decisions.

2026-03-2023

swarm-priorities

EffortlessMetrics/perl-lsp

Load roadmap weighting for scouts and coordinators so slices are ranked by actual repo priorities instead of convenience.

2026-03-2023

Triage PRs

Triage open PRs. Focus: $ARGUMENTS

Steps

List all open PRs with freshness and branch metadata: gh pr list --state open --json number,title,headRefName,mergeable,updatedAt --limit 100

Scope the candidate set before clustering:

If $ARGUMENTS is empty or all, keep the full list.
If $ARGUMENTS is a numeric range like 1200-1210, filter the fetched PRs to that inclusive range before any clustering or closing.
If $ARGUMENTS cannot be parsed into a safe range, stop and report the invalid input instead of guessing.

Build preliminary clusters by topic from title/head branch naming only. Do not assume "same files" from the list output alone.

For each possible duplicate cluster, fetch file-level detail before deciding: gh pr view <num> --json body,files,updatedAt,mergeable,reviewDecision,headRefName

Launch parallel explore agents only after file overlap is confirmed:

Agent(subagent_type: "Explore", prompt: "Compare PRs #X, #Y, #Z.
Run: gh pr diff <num> --stat && gh pr view <num> --json body,files,updatedAt,additions,deletions
Return: which is most complete, which has unique good ideas, which to keep, and whether file overlap is real")

For each confirmed cluster, pick the best PR using:

changed-file overlap
recency (updatedAt)
review/merge state
implementation completeness

Treat a PR as stale only when it is both older and superseded by a newer PR in the same confirmed file/topic cluster. Do not close PRs based on age alone.

Close duplicates only after explicit comparison. Never close PRs outside the scoped $ARGUMENTS set: gh pr close <num> --comment "Closing — keeping #<best>"

If the winner needs improvements from closed PRs, spawn a worktree agent to incorporate them first.

Report: how many clusters found, how many closed, which PRs remain blocked, and which PRs are ready to merge.