mirror of https://github.com/github/awesome-copilot.git synced 2026-10-12 14:54:16 +00:00

Files

T

Aaron PowellandCopilot App 4754582823 feat(canvas): add open pull request review board

Add persistent AI-assisted PR triage with labels, checks, review evidence, and confirmed GitHub feedback, close, approval, and auto-merge actions.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 8045e7e0-dfd7-425a-9131-21ea5ca1553e

2026-10-09 17:01:53 +11:00

3.4 KiB

Raw Blame History

Open PR Board

A canvas for triaging the repository's open pull requests, modelled on the External Plugin Review Board. It pulls open PRs with the gh CLI, lets the agent review them against this repo's own review rules, sorts them into recommendation buckets, and applies confirmed review, close, and merge actions through the authenticated gh CLI.

What it does

Buckets — Unreviewed, Reviewing, Close, Request changes, Needs insight, Approve, Actioned. The AI recommendation picks the bucket; dragging a card overrides it.
AI reviews — "Review pending" asks the agent to review every PR that has never been reviewed or whose review is stale. The agent records structured results (rationale, repo fit, compliance, differentiation, risks, validation, confidence, suggested comment) through a canvas action.
State tracking — each PR remembers whether it has been reviewed, when, what the agent concluded, any manual move, and any decision you recorded. A PR updated after its review is flagged PR changed and is picked up by the next review pass.
Re-review — ask for a fresh pass on one PR with optional focus guidance.
Labels — GitHub labels render on every card in their own colours, blended toward the app theme so they stay readable in both light and dark mode.
Detail drawer — AI review, description, conversation, changed files, and checks.
GitHub actions — submit feedback, request changes, close a PR, or approve it and enable auto-merge with a merge commit. Each action needs two clicks to confirm and is also recorded in local board history.

Requirements

The gh CLI must be installed and authenticated with access to the repository. Everything the board reads — listing, detail, checks — goes through gh. Confirmed drawer actions use the same authenticated account to submit reviews, close pull requests, and enable auto-merge. Your GitHub permissions and repository branch-protection rules still apply.

State

Board state lives in .github/extensions/open-pr-board/state/<owner>__<repo>.json, one file per repository, and is git-ignored. Deleting it resets reviews and history but touches nothing on GitHub.

Agent actions

Action	Purpose
`get_board`	Current buckets, counts, and per-PR state.
`refresh`	Re-fetch open pull requests from GitHub.
`start_review`	Queue a review pass and return the review instructions.
`start_rereview`	Queue a re-review of one PR with optional guidance.
`record_review`	Record structured review results (used by the agent, not by hand).
`move_item`	Move a PR to a different bucket.
`get_pr`	Full detail for one PR: body, comments, reviews, files.

Review rules

The agent reads review-guidance.md, which layers PR-specific procedure on top of .github/skills/code-review/SKILL.md and .github/copilot-instructions.md. AI evidence gathering is read-only: the agent never edits files or runs write commands against the PR. Only an explicitly confirmed drawer action writes to GitHub.

3.4 KiB Raw Blame History