| name | upstream |
| description | Prepare a contribution to an upstream OSS repo — review the diff and tests against its contribution guide and draft compliant PR metadata. Use before submitting a PR to an external repository. Read-only; never opens the PR. |
| argument-hint | [upstream-url] |
Upstream contribution review
Read-only: analyze and report; never create the PR or modify files.
- Orient — detect the upstream repo (the argument, else the
upstream remote, else origin); compare the current branch against its default branch.
- Gather, in parallel where independent:
- the contribution guide (root,
.github/, docs/; fall back to generic OSS practice if absent) and any PR template;
- the diff and its test coverage;
- your past PR feedback in that repo (
gh pr list --author @me --repo <upstream> --state all) — reviewers repeat themselves, so recurring feedback weighs heaviest.
- Report:
- findings against the guide, code quality, and test coverage — each pass/fail/warn with location;
- draft PR title and description in the repo's required format;
- local verification commands (lint, test, build) plus a manual QA checklist where the change warrants one (UI, API, cross-component);
- overall status: ready / needs work / blocked.
