feat(review): assess knowledge uplift in content reviews

Centralize the knowledge-uplift test in the code-review skill and require evidence-backed classifications in the PR Review board.

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

Copilot-Session: 9082818f-c7db-42c7-add6-c337afb05fdb
This commit is contained in:
Aaron Powell
2026-10-13 15:57:41 +11:00
co-authored by Copilot App
parent 9861787546
commit 17ffd2e23b
3 changed files with 66 additions and 3 deletions
+44 -1
View File
@@ -31,7 +31,7 @@ Confirm that a submission addresses a specific GitHub Copilot workflow,
technology, domain constraint, or user problem. Flag contributions that:
- provide generic advice that current models already handle well without
meaningful uplift
meaningful uplift (see [Knowledge uplift](#knowledge-uplift))
- restate an existing resource without a clear differentiator
- use broad claims such as doing everything for every project
- lack concrete instructions, constraints, examples, or expected outcomes
@@ -41,6 +41,49 @@ Paid or commercial services are not automatically unsuitable. Evaluate whether
the contribution provides standalone user value and follows the repository's
guidance for paid-service submissions.
## Knowledge uplift
A resource is only valuable if it changes what the model does. Well-formatted,
compliant content can still add nothing. Apply this test to every agent,
instruction, skill, prompt, hook, or workflow that a PR adds or substantially
changes:
1. Picture a current frontier model given the same task with no resource
loaded. What would it do?
2. Identify what this resource makes it do differently. The value is that
delta, not the content itself.
Count as real uplift:
- facts the model is unlikely to know or get right, such as recent or niche
APIs, version-specific breaking changes, and non-obvious gotchas
- internal, proprietary, or organization-specific tools and conventions
- constraints that deliberately override sensible defaults
- bundled scripts, templates, or data that produce deterministic results
- multi-step workflows that wire specific tools or MCP servers together
- concrete examples of non-obvious expected output
Do not count as uplift:
- generic best practices such as clean code, SOLID, DRY, meaningful names,
writing tests, or handling errors
- restatements of well-known public documentation for mainstream languages and
frameworks
- persona framing such as "You are an expert X" without new constraints
- checklists of behavior models already exhibit by default
- long prose that a one-line user request would replace
Length, polish, and structure are not evidence of value. Quote or cite the
specific lines that carry the uplift; if you cannot find any, say so plainly.
Classify the result as:
- **high** — most of the content is non-obvious to a capable model
- **partial** — a useful core surrounded by generic filler
- **none** — a capable model would behave essentially the same without it
Do not recommend approval when uplift is **none**. For **partial**, ask the
author to cut the named generic sections and expand the specific ones.
## AI-authored submissions
A PR title ending in `🤖🤖🤖` is an intentional AI-authorship disclosure from