mirror of
https://github.com/github/awesome-copilot.git
synced 2026-10-12 23:04:14 +00:00
Aaron PowellandCopilot App
758f4382db
Drop the legacy extension-folder state import; boards now start empty in session.workspacePath. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 545df520-6557-4211-a110-53c60f4b9f3a
49 lines
2.7 KiB
Markdown
49 lines
2.7 KiB
Markdown
# External Plugin Review Board
|
|
|
|
A maintainer-only Copilot canvas extension for triaging `external-plugin` submissions that are
|
|
`ready-for-review` in github/awesome-copilot.
|
|
|
|
Open it by asking Copilot to "open the plugin review board" (canvas id `external-plugin-review-board`).
|
|
|
|
## Features
|
|
|
|
- **Kanban board** with buckets: Unreviewed → Reviewing → Straight reject / Probably reject / Needs review /
|
|
Accept → Actioned. Drag cards between buckets (or use the *Bucket* dropdown in the details panel).
|
|
Dragging a card back to *Unreviewed* clears its AI review so it's picked up by the next review.
|
|
- **Perform review** asks the agent to review every item without an AI review, using
|
|
[`review-guidance.md`](./review-guidance.md) and the decisions you've made from the board. Results are
|
|
recorded with the `record_review` canvas action and move cards into their recommended bucket.
|
|
- **Re-review** (in the details panel) takes optional guidance on what to focus on, then has the agent
|
|
spin up a separate sub-session to re-assess that one submission. The sub-session reports its result
|
|
back and it's recorded on the card along with your guidance.
|
|
- **Refresh** fetches open `external-plugin` + `ready-for-review` issues, adds new ones, and removes any
|
|
that are closed or no longer ready for review.
|
|
- **Details panel** shows the AI review, the rendered issue body, and all comments.
|
|
- **Quick actions** post `/approve` (with an optional note) or `/reject <reason>` straight to the issue
|
|
after a confirm click. The reject reason is prefilled from the AI's suggested comment.
|
|
|
|
## State
|
|
|
|
Board state lives in
|
|
`<session.workspacePath>/extensions/external-plugin-review-board/state/board.json`.
|
|
This is Copilot's session-state workspace, not the repository checkout. It stores the synced issue
|
|
metadata, AI reviews, manual bucket overrides, and a history of decisions made from the board.
|
|
State survives extension reloads and resuming the same session; a new session has its own board.
|
|
Infinite sessions must be enabled to provide the workspace. Keeping writes outside the extension
|
|
folder avoids invalidating its safety fingerprint. State previously stored in the extension folder is
|
|
not imported; boards start fresh.
|
|
|
|
## Requirements
|
|
|
|
- The GitHub CLI (`gh`) on `PATH`, authenticated as a maintainer with write access (needed for
|
|
`/approve` and `/reject` to be honoured by the command router workflow).
|
|
|
|
## Agent actions
|
|
|
|
`get_board`, `refresh`, `start_review`, `start_rereview`, `record_review`, `move_item`, `get_issue`.
|
|
|
|
## Regression tests
|
|
|
|
Run `node --experimental-vm-modules --test eng/board-state-storage.test.mjs` from the repository root
|
|
to check both canvases' session-scoped persistence without accessing GitHub.
|