Table of Contents generated with DocToc

PR management skill family

Maintainer-facing PR-queue management for projects with a public contributor PR queue. Three skills that compose into a complete triage + review pass:

  1. Triage — sweep open PRs, classify against the project’s quality criteria, propose a disposition (draft / comment / close / rebase / rerun / mark ready / ping), execute on maintainer confirmation.
  2. Stats — read-only summary tables of the open PR backlog, grouped by area label, so the maintainer can see where queue pressure is sitting before / after a triage sweep.
  3. Code review — deep, line-aware code review one PR at a time. Reads the diff, applies the project’s review criteria, drafts an APPROVE / REQUEST_CHANGES / COMMENT review with inline comments, posts on confirmation.

Why a framework skill family? These skills were originally maintained inside one ASF project’s developer-tooling repo as breeze pr auto-triage and breeze pr stats — useful for any ASF project with a meaningful contributor-PR queue, but locked behind that project’s local toolchain. Lifting them into the framework lets other adopters reuse the playbook with their own adopter-config files for project-specific knobs (committers team handle, area-label prefix, comment-template wording, CI-check → doc-URL map, review-criteria source files).

Skills

SkillPurpose
pr-management-triageFirst-pass triage. Successor to breeze pr auto-triage.
pr-management-statsRead-only summary tables grouped by area label.
pr-management-code-reviewDeep code review, one PR at a time.

Adopter contract

The skills resolve project-specific content from these files in the adopter’s <project-config>/ directory:

FileUsed by
pr-management-config.mdpr-management-triage, pr-management-stats
pr-management-triage-comment-templates.mdpr-management-triage
pr-management-triage-ci-check-map.mdpr-management-triage
pr-management-code-review-criteria.mdpr-management-code-review

The skills read project-specific defaults from the <project-config>/ files above. Adopters customise by editing their copy of each template; illustrative examples in skill prose may still use the patterns that motivated the framework (monorepo <area>/ layout, area:* labels, etc.) — the behaviour is config-driven, the example wording is not.

Cross-references