AGENT SKILL

pr-triage

Triage open pull requests in github/explore, producing a status table with CI results and merge recommendations. Use when asked to review, triage, or summarize open PRs in this repository.

License 许可
CC-BY-4.0
所属仓库
github/explore
最近更新
2026-11-14
Stars
★ 5.0k
Forks
1.5w

01 前言 Front Matter

name
pr-triage
description
Triage open pull requests in github/explore, producing a status table with CI results and merge recommendations. Use when asked to review, triage, or summarize open PRs in this repository.

03 SKILL.md 正文

Pull Request Triage Skill

Goal

Produce a table of open pull requests with CI status and a merge recommendation, following this repository's contribution rules.

Table format

PR# Author login PR title CI status Merge recommendation Reason
  • PR#: link to the pull request.
  • CI status: 🟢 all checks passed, 🟡 checks still running, 🔴 any check failed.
  • Merge recommendation: ✔️ looks good, ❌ should be closed without further comment, 🔍 needs human review.
  • Reason: fill in for any ❌ recommendation, explaining which rule below applies.

Merge recommendation rules

  1. Dependabot PRs (app/dependabot): always ✔️. These are trusted dependency bumps.
  2. github-actions[bot] automation PRs (e.g. the collections-renames autofix bot): always ✔️. These are generated by repository-owned workflows, not external submissions.
  3. github-security-bot: always ✔️. This is an internal, repository-owned bot, not an external contributor. Only these exact two logins are opted in under the github- prefix. A github- prefix alone does not establish that an account is repository-owned; apply the ordinary contribution rules to any other github-* login.
  4. PRs editing core repository metadata (workflows, CI config, Gemfile, docs, etc. — anything outside topics/ or collections/) submitted by an external contributor: ❌. This repository only accepts topic/collection contributions from the community; infrastructure changes need maintainer review through other channels.
  5. PRs that add or edit a topic or collection:
    • Check the PR description against .github/PULL_REQUEST_TEMPLATE.md. If the required checkboxes for the selected contribution type are not checked, recommend ❌ — per CONTRIBUTING.md, incomplete templates are closed without comment.
    • If the checkboxes are complete but the contribution reads as self-promotion (e.g. the author is adding their own repository to a topic or collection), check the PR description and comments for a disclosed, extenuating explanation (e.g. independent evidence of community adoption, or a maintainer acknowledgment) that might justify an exception. Absent such justification, recommend ❌ citing the "Avoid conflicts of interest" guideline in CONTRIBUTING.md. One exception to the no-self-promotion rule: users may add their own repositories to already-existing collections, especially the made-in-* geography-based collections.
    • If the checkboxes are complete, the change is substantive, and it isn't self-promotion, recommend ✔️.
    • If CI is failing (🔴) for a PR that otherwise looks acceptable, or the contribution's value is ambiguous, recommend 🔍 for human review rather than guessing.

Workflow

Never approve, merge, or close PRs automatically. Require an explicit user request identifying the PRs, either by number or by a clearly defined group (e.g. "merge all recommended PRs"). A ✔️ or ❌ recommendation alone is not authorization. Approving CI workflow runs has a separate, restricted consent step below.

For prioritizing which PRs matter most when the user does ask for merges, note that these often correct data that other PRs' CI depends on, so they're worth flagging as high priority in that order:

  1. Autofix PRs (e.g. the github-actions[bot] collections-renames PR).
  2. Dependabot PRs (dependabot[bot]).
  3. github-security-bot PRs (the only other opted-in github- login).

When asked to "Triage the PRs for github/explore":

  1. List open PRs with gh pr list including CI status (statusCheckRollup), read each PR's body/checkboxes, diff, and any bot triage comments (e.g. the maintainer triage comment posted by explore-triage-commenter), and apply the merge recommendation rules. Check workflow runs for manual-approval gates.
  2. In the first response, create the table as an artifact and open it in the editor canvas. Do not wait for CI approvals or branch updates before showing the table.
  3. Show existing CI results in the table without automatically rerunning failures. If another PR merges, refresh the table using the latest results. Rerun failed CI only when the user requests it or after a targeted diagnosis identifies a reason to retry.
  4. If any PRs recommended ✔️ have runs requiring approval, prompt the user: "N PRs look safe but have runs requiring approval. Would you like me to approve them to run?" Use the number of qualifying PRs, not the number of runs. Do not ask this for PRs recommended 🔍 or ❌. Do not approve any runs before the user agrees.
  5. Do not approve, merge, or close PRs — including ones recommended ✔️ or ❌ — unless the user explicitly requests the action for specific PRs or a clearly defined group of PRs.

After confirming that a PR contributing to topics/ has merged, prompt the user to import the merged topic via stafftools. The link may return 403 or 404 until the user is SSO-authenticated; do not treat that as an import failure or attempt the import on their behalf.

Updating PR branches

Only when asked to update PRs from the base branch, use gh pr update-branch <number> for each open PR. Dependabot, github-actions[bot], and github-security-bot PRs are still valid targets for this — being "always accepted" for merge doesn't exempt them from branch updates.

CI check approval

When the user requests a rerun, or a targeted diagnosis identifies a reason to retry, use gh run rerun <run_id> --failed -R github/explore for failed GitHub Actions runs on the open PR's current head commit and update the table with the pending status. Do not rerun older commits' failures or repeatedly rerun the same failure while waiting for results. A run awaiting manual approval is not a failed run to retry; follow the consent rule below instead.

Workflow runs that require manual approval (e.g. first-time contributors) can be approved with:

gh api -X POST repos/github/explore/actions/runs/<run_id>/approve

Offer the grouped consent prompt only for PRs independently recommended ✔️. Runs for PRs recommended 🔍 may also be approved if the user explicitly requests CI approval for those PRs; never approve runs for PRs recommended ❌. The runs must actually require approval (action_required or waiting); a 🔴 CI status from a completed, non-blocked run is a real failure, not a pending approval. Before approving, recheck each PR's recommendation and run state. Consent to run CI does not authorize approving or merging the PR.

Diagnosing CI failures

Before recommending a fix, distinguish between:

  • A data problem: the failure stems from stale or inconsistent content already in main (e.g. a topic still aliasing another topic that has since been split out on its own). Note this in the analysis; the failing PR may not be at fault, and a separate PR may already fix the underlying data.
  • A logic problem: the failure stems from the test/workflow logic itself not accounting for a valid case (e.g. a CI job not exempting an automation bot's own PRs from a check designed for external submissions).

Tone

This repository is public. Keep all analysis, PR descriptions, and comments matter-of-fact and welcoming toward external contributors — describe issues neutrally (e.g. "the description doesn't check the required boxes") rather than in dismissive or judgmental language.