mirror of
https://github.com/github/awesome-copilot.git
synced 2026-10-12 23:04:14 +00:00
Aaron PowellandCopilot App
4754582823
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
62 lines
3.4 KiB
Markdown
62 lines
3.4 KiB
Markdown
# 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](https://cli.github.com) 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`](./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.
|